3.4.6.3.1 IsAuthorized

A receiver can use this action to check whether it is authorized. If a receiver is a UPnP media renderer, it can pass a DeviceID to the transmitter. The transmitter returns a result of TRUE if the receiver has been authorized and FALSE otherwise. The DeviceID SHOULD equal the unique device name (UDN). For control points, an empty string SHOULD be passed in and the MAC address will be used for determining authorization. If a receiver calls IsAuthorized for itself, the action will return with a result of TRUE or FALSE. If a control point is requesting status for another receiver, the receiver MUST be authorized to receive a result; otherwise the transmitter will return a UPnP 801 error (access denied).

The DeviceID used in the IsAuthorized action and the serial number described in section 3.1.1.3 are two separate concepts, although receivers can use the same value.

The following table shows the arguments for the IsAuthorized action.

Whenever a receiver is authorized or unauthorized by a user, an event triggered by a change in the AuthorizationGrantedUpdateID variable or the AuthorizationDeniedUpdatedID variable is sent by the transmitter to all receivers. Each Receiver MUST call the IsAuthorized action after the event is received to determine whether that receiver is the device that has been authorized or unauthorized.

Dependency on State: This action SHOULD only be called when either the AuthorizationGrantedUpdateID or AuthorizationDeniedUpdateID variable has been evented and has changed from the last number the device knows.

Devices MAY also call this action on power-up.