OpenTV ENTera & OpenTV Platform Documentation
26.26_Q2 25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2
OpenTV ENTera & OpenTV Platform Documentation
26.26_Q2 25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2
Breadcrumbs

Managing content playout usage rules

Overview

OpenTV Platform, when used together with NAGRA's Security Service Platform (SSP), enables you to specify usage rules for live channels (including catch-up and NPVR recordings). This lets you do things like restrict output to digital only, enable/disable casting, specify protection/security levels, and so on.

It works as follows:

  1. You set up mappings between channels/content and usage rule profiles.

  2. When channels and content are ingested, the usage rule profiles are added as part of the channel/content metadata.

  3. When a user attempts playout, OPF checks whether the channel/content has a usage rule profile.

  4. If it does, it inserts the usage rule profile into the content auth token that is passes to SSP.

  5. SSP decodes the token and applies the rule.

If a channel or content has no usage rule profile associated with it, SSP uses its default rule. This means that you do not have to configure usage rule profiles, but doing so gives you more fine-grained control of how content can be rendered.

SSP supports the definition of multiple usage rule profiles (for example, for SD, HD, and UHD).

Configuring usage rule profiles in Operator Console (OpCon)

OpenTV Platform enables you to do the following in OpCon’s Usage Rule Profiles section:

  • Enable/disable this functionality globally.

  • Define a mapping between technical channel IDs and usage rule profiles. These are automatically applied to technical channels at ingest. They are also applied automatically to generated catch-up and recorded content.

  • Define a mapping between technical content IDs and usage rule profiles. These are automatically applied to technical contents at ingest.

  • Define a default usage rule profile. At ingest, this is automatically applied to every technical channel and content that does not have an explicit mapping. It is also applied to generated catch-up and recorded content if the channel does not have an explicit mapping.

You can also change/override the usage rule profile that was applied to a technical channel or technical content at ingest:

  • Technical channel: in OpCon, you can change the usage rule profile in Channel Management > {channel} > Playback Variants > {variant} > Security and Restrictions > Usage Rule. See Manage channel playback variants.
    Note that technical channels are referred to as Playback Variants in OpCon.

  • Technical content: in OpCon, you can change the usage rule profile in Content > {content item} > Technicals > menu_black.png > Edit Technical Version > Usage Rule. See Technical versions.

SSP includes a number of pre-defined usage rule profiles. When setting up the mapping between technical channels and usage rule profiles, you need to know the IDs of the usage rule profiles that you are using.

Note that although it is possible to customise these profiles and/or create new ones, this must be done in consultation with SSP. Please contact your NAGRAVISiON representative if you need to do this.

Using CPM APIs to set usage rule profiles on channels and content

If you need to change the usage rule profile for a technical channel or technical content, you can also do this using the following CPM endpoints:

  • PUT https://<host>:<port>/metadata/content/v1/technicalChannels

  • PUT https://<host>:<port>/metadata/content/v1/technicalContents

See Content and Product Manager (CPM) API documentation: content v1.

See also

For details of the usage rule profiles, see Content Usage Rules for OTT in the SSP documentation.

The Content Usage Rules documentation is part of the SSP portal. If you do not have access, please contact your NAGRAVISiON representative.