Device limits

Overview

OpenTV Video Platform allows you to define:

• A limit on the number of approved devices per account
  (A device that is registered to an account can either be approved or not approved.)
• A limit on how often a change can be made to an account's approved devices list (that is, to add or remove a device from the list).

These limits are defined in an account profile, which means you can have different limits for different groups of users. (See Account profiles for details of setting these limits in OpCon and Accounts for details of applying account profiles to accounts.)

Approved device limits are disabled by default. To enable them, contact your NAGRAVISION representative.

Use cases

This section explains how a client application can:

• Check whether the device it is running on is approved or not.

  

  The client application is responsible for changing the UI depending on its approved / not approved status (for example, by directing the user to a device management page instead of the home page when the app is launched).

• If the device is not approved, check when it can next attempt to approve a device (so it can display this information to the user).
• Request the list of approved and not approved devices for the account (so it can display them in a device management screen).
• Request the addition and/or removal of a device from the account's approved devices list.

Note that if the client uses the /ias/v3/token/actions/signOnByUserNamePassword endpoint to sign on, this will automatically add the device to the account's approved devices list on first signon only if:

• The list is not already full, 
• The device is not already on the list, and
• The limit on the number of changes allowed to the approved devices list would not be exceeded by adding the device.

In other signon scenarios, the client should check its approved status after signing in.

Scenarios

There are other devices statuses that, combined with a device's approval status, determine what the device can and cannot do. These are summarised in the following table:

See also

Approved device limits (Subscriber management integration guide)