Device limits
Overview
OpenTV Platform allows you to define limits for:
Number of devices per account:
The total number of devices per account
The number of devices in each defined device group (for example, one limit for mobile devices and another for large-screen devices such as smart TVs)
Number of concurrent streaming sessions:
The total number of concurrent streaming sessions for the account
The number of streaming sessions for each defined device group
Number of approved devices per account:
The number of approved devices per account
(A device that is registered to an account can either be approved or not approved.)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 the following places:
Total devices, total concurrent sessions, and approved device 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.Device group limits and device group session limits are defined globally and apply to all accounts.
See Device Management for details of setting these limits in OpCon.
Approved device limits are disabled by default. To enable them, contact your NAGRAVISION representative.
Use cases
Device and device group limits
When a device signs on for the first time, if adding it to the account would exceed one of the device limits (total devices of devices in a device group), sign-on will fail. See Authentication.
Concurrent session limits
When a device attempts to set up an OTT session prior to attempting playback, if the new session would exceed the concurrent session limit, the session setup request will fail. See Secure Session Management and Secure Session Manager (API documentation) in the SSP documentation.
Approved device limits
The client application is responsible for the following use cases related to approved device limits:
Check whether the device it is running on is approved or not.
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.
The Scenarios section, below, explains how the different limits interact.
Both approved and unapproved devices count towards an account’s device limit (except for devices that belong to a device group whose device group limit has Ignore Device Limit enabled – see Setting device group limits for a device profile).
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:
Status (set by operator) | Activation status | Approved status | Client can sign in? | Client can request content authorisation? | Contributes to device limits |
---|---|---|---|---|---|
ENABLED | ACTIVE | TRUE FALSE Approval not enabled | ALLOWED ALLOWED ALLOWED | ALLOWED BLOCKED ALLOWED | YES (excludes MANAGED devices) |
DISABLED | TRUE FALSE Approval not enabled | BLOCKED BLOCKED BLOCKED | N/A N/A N/A | NO | |
ENABLED | INACTIVE | TRUE FALSE Approval not enabled | BLOCKED BLOCKED BLOCKED | N/A N/A N/A | NO |
DISABLED | TRUE FALSE Feature Off | BLOCKED BLOCKED BLOCKED | N/A N/A N/A | NO |
See also
Managing devices (Subscriber management integration guide)
Device Management (OpCon documentation)
Account profiles (OpCon documentation)