Nagra Media Live

Owned by p_demou (Deactivated)
Last updated: Jun 20, 2018 by Persia Xenopoulou (Deactivated)
7 min read

On this page

Overview

Nagra Media Live is an over-the-top (OTT) TV platform that streams content to subscription video-on-demand (SVOD) or transaction video-on-demand (TVOD) based subscriptions. 

CRM.COM provides a ready-made implementation of the Nagra Media Live Platform using the Nagra Media Live Provisioning module, which primarily handles the activation and deactivation of signals transmitted to devices.  For example, when a new subscription is created in CRM.COM, Nagra Media Live Platform is immediately updated and provisioning signals are sent to subscriber devices to activate registered services.

The processing of requests sent to Nagra Media Live and the provisioning of subscriber devices take place in real-time.

Major features

  • Integration with Nagra Media Live.
  • Real-time activation and deactivation of subscriptions.
  • Archiving of former provisioning requests (refer to Utilities for more information).
  • Authentication of subscribers. 

Using Nagra Media Live

  • The Nagra Media Live implementation submits requests to the Nagra system in real-time.
    • Subscription actions update the subscription provisioning state in CRM.COM.  If the modification should be reflected in Nagra, a request is constructed (using Nagra Media Live commands) and forwarded to Nagra.

No user intervention or further setup (other than that of the provider) is required for request exchange between CRM.COM and Nagra.

 

Setting Up Nagra Media Live

Billing > Provisioning > Nagra Media Live > Set Up Provisioning Provider

Provisioning provider

The parameters that are necessary to access the CA/OTT platform and to map the CRM.COM services and physical goods to be provisioned can be supplied from Provisioning Provider Data Entry page.

Provider fields

The table describes the standard sections of a Provisioning Provider Data Entry page and explains how the fields in the page are used.

 Mandatory   Configurable

Main Information
Provider Information

Name and Alternative Code of the provider

Provisioning Protocol

Life Cycle State: Must be 'Effective' to send commands to the CA/OTT platform.

Connection Parameters

End Point that will be used to call Nagra Media Live Web Services.

User Name, Password

Character Set Encoding (defaults to UTF-8)

CAS Instance ID: The ID of the Nagra CAS instance that is used in tandem with Nagra Media Live Platform.

Provider Default Value Fields: The values should be requested by Nagra Media Live.

  • Product Origin ID
  • Default STB Classifier UID
  • Salt Value

Distributors 

Distributors are used to associate the services and devices (installed items) of a subscription with the provisioning provider.  Multiple distributors on a subscription represent separate viewing locations.  Each device can offer different services.  In a pay TV subscription, for example, two distributors can represent the decoder and channels available in a living room and bedroom.

Create the distributors that can be provisioned through the provider.  One or more provisioning distributors must be present for a provider to be 'Effective'. 

ADD a new distributor and supply the information required in the modal.

Main Information

Name,  Alternative Code for the provisioning distributor.

Allowed Services

Define the services available through the distributor. Once a distributor is selected, only the services defined as 'Allowed' will be available for selection when adding subscription services.

Two options are supported:

  • All Provisioned Services: All services provisioned by the provider can be distributed.

  • Specific Provisioned Services: Only the services in the list can be distributed. 

The available services are filtered and validated against those defined in the 'Services' section, which can be provisioned by the associated provider.

Restrictions

Minimum/Maximum Optional/Mandatory service restrictions determine the number of services that can be added to the distributor.

Restrictions per Service Type: Define the minimum and maximum number of services that can be added to the distributor, from specific service types.

Restrictions per Physical Good Type: Define the minimum and maximum number of installed items that can be added to the distributor, from specific physical good types.

Dependencies

Define services, service types, physical goods or physical good types that must be added to the distributor, if enabled.

Services

One or more service mappings must be present for a provider to be 'Effective'.

Service: Termed and usage services that can be provisioned by the provider.

CA ID: The unique identifier for the service at the CA/OTT platform.

An ID is not mandatory for a non-provisioning service (i.e. a service whose product type is not set as 'Used for Provisioning').


Physical Goods

A list of devices that are necessary for provisioning through the provider. For example, a decoder and a smartcard, or only a decoder or only a modem.  A specific device type may be mandatory for a certain provider.

The Installed Item Alternative Code represents the ID of devices communicated to the CA/OTT platform.

 

Back to top

Related configuration areas

Mandatory modules must be configured for the provisioning module to work.

Manual LinkArea DescriptionConfiguration
Products
  • Physical Good Types
  • Service Types
  • Physical Goods
  • Services

Configure the physical good and service types, and the physical goods and services that will be offered to subscriptions, by adding them to the provisioning provider.

 Mandatory
CommunicationsCommunication Queue External SystemSet up the external system that will be used to handle mail messages created for the provider.Optional

 

Authenticating Nagra subscribers before an order


The principle of OTT is to enable customers to order and view an event directly, using their selected device. The signals required for streaming the video come directly from the provider and are authenticated through CRM.COM once an order is placed.

For example, when a user orders a movie on a tablet, CRM.COM authenticates the user through an account and subscription number and sends the user a token for viewing the movie on the tablet.

This is required when a VOD or PPV order is executed from a third-party system such as a portal. Further implementation from the third-party is required, to call CRM.COM authentication WEB API and provide subscriber details (subscription number and account).

The subscriber is authenticated in CRM.COM and subsequently in the provider. The token is sent back to the third-party so that the subscriber can start viewing the movie.


Back to top 

Nagra Media Live Requests

The table below displays the CRM.COM processes and actions that trigger Nagra Media Live requests, as well as the parameters sent for each request.

  • If a Nagra Media Live account is not found when a subscription action is executed, the action is not completed and an error message is displayed.
RequestUseSubscription ActionParameters

Create Account

 

Register a new Nagra Media Live account.

  • The command is triggered and an account is registered if there is an 'Effective' subscription service or an installed item distributed on Nagra Media Live and the subscription is not yet associated with a Nagra Media Live account.

Subscription Actions

    • Become subscriber ('Effective', when submitted as 'Draft the command will not be triggered)
    • Activate subscription
    • End short-term deactivation
    • End subscription resting
    • Short-term activation
    • Change subscription distribution

Service Actions

    • Add 'Effective' services 
    • Start services
    • Swap services
    • Add service usage

Installed Item Actions

    • Add installed items
    • Swap installed items
The username and password for the new Nagra account.

Cancel Account

Un-register an account in Nagra Media Live.Subscription Actions
  • Terminate subscription (Cancel)
  • Terminate subscription (Regret)
Subscription information that will be used to access and cancel the account.

Suspend Account

Suspend an account in Nagra Media Live.

The command is triggered if a subscription is deactivated by using any of the actions, or if the last termed subscription service provisioned by Nagra Media Live is deactivated (not 'Effective').

Subscription Actions

    • Terminate subscription (Cancel)
    • Terminate subscription (Regret)
    • Deactivate subscription
    • Short-term deactivation
    • Rest subscription
    • End short-term activation
    • Change subscription distribution

Service Actions

    • Remove services (Cancel)
    • Remove services (Regret)
    • Stop services
    • Swap services  
Subscription information that will be used to access and suspend the account.

Reactivate Account

 

Reactivate a suspended Nagra Media Live account.

 

Subscription Actions

    • Activate subscription
    • End short-term deactivation
    • End subscription resting
    • Short-term activation
    • Change subscription distribution

Service Actions

      • Add 'Effective' services (Adding 'Draft' services will not trigger the command)
      • Start services
      • Swap services
Subscription information that will be used to access and reactivate the account.

Add products

 

Add and activate subscription services to a registered Nagra Media Live account.

  • The command is triggered if:
    • One or more 'usage' or 'termed' subscription services provisioned by Nagra is added to a subscription
      AND
    • The scheduled date is equal to or less than the current date
      AND
    • The service is not authorized and not rejected.

 

Subscription Actions

    • Activate subscription
    • End short-term deactivation
    • End subscription resting
    • Short-term activation
    • Change subscription distribution

Service Actions

    • Add 'Effective' services
    • Start services
    • Swap services
    • Add service usage
  • Subscription information that will be used to access the account.
  • A list of subscription service policy group IDs (subscription services) that will be added to the account.
  • A list of the distributors linked to the subscription services.

Remove Products

 

Remove and deactivate subscription services.

  • The command is triggered if one or more than one 'usage' or 'termed' subscription services provisioned by Nagra is deleted or canceled from a specific subscription.

Subscription Actions

    • Terminate subscription (Cancel)
    • Terminate subscription (Regret)
    • Deactivate subscription
    • Short-term deactivation
    • Rest subscription
    • End short-term activation
    • Change subscription distribution

Service Actions

    • Remove services (Cancel)
    • Remove services (Regret)
    • Stop services
    • Swap services  
  • Subscription information that will be used to access the account.
  • A list of subscription service policy group IDs (subscription services) that will be added to the account.
  • A list of the distributors linked to the subscription services.

Create STB

 

Register a new STB to a Nagra Media Live account.

The Create set-top box command is triggered when an uninitialized STB provisioned and distributed by Nagra Media Live is present in the system but not in the Nagra provider.

The Update set-top box command is triggered when an uninitialized STB provisioned and distributed by Nagra Media Live is present in the system and Nagra.

Installed Item Actions

  • Add installed items
  • Swap installed item (only for STB)
  • Subscription information that will be used to access the account.
  • The CAS ID of the STB that will be created.
  • The distributor linked to the new STB.

 

Update STB

 

Update the STB of a Nagra Media Live account.

The Create set-top box command is triggered when an uninitialized STB provisioned and distributed by Nagra Media Live is present in the system but not in the Nagra provider.

The Update set-top box command is triggered when an uninitialized STB provisioned and distributed by Nagra Media Live is present in the system and Nagra.

Installed Item Actions

  • Add installed items
  • Swap installed item (only for STB)
  • Subscription information that will be used to access the account.
  • The CAS ID of the STB that will be updated.
  • The distributor linked to the STB that will be updated.

 

Delete STBRemove an STB from a Nagra Media Live account.

Installed Item Actions

  • Remove installed item
  • Swap installed item (only for STB)
  • Subscription information that will be used to access the account.
  • The CAS ID of the STB that will be canceled.
  • The distributor linked to the STB that will be removed.

Create Smartcard

 

 

Register a new smartcard to a Nagra Media Live account.

Installed Item Actions

Add installed items

  • Subscription information that will be used to access the account.
  • The CAS ID of the smartcard that will be created.
  • The distributor linked to the new smartcard.

Swap Smartcard

 

Swap a smartcard registered with a Nagra Media Live account.

Installed Item Actions

Swap installed items

  • Subscription information that will be used to access the account.
  • The CAS ID of the smartcard that will be created.
  • The distributor linked to the new smartcard.
  • The CAS ID of the smartcard that will be removed.
  • The distributor linked to the smartcard that will be removed.
Delete SmartcardRemove a smartcard from a registered Nagra Media Live account.

Installed Item Actions

Remove installed item

  • Subscription information that will be used to access the account.
  • The CAS ID of the smartcard that will be removed.
  • The distributor linked to the smartcard that will be removed.



Back to top 

Nagra Media Live Business Examples

Subscriptions with multiple viewing points 

Provisioning Distributors

Scenario 1

Company ZX offers its customers the option to have multiple viewing points for each subscription. Customers can have a separate 'box and card' pair in each room, and choose to have a different selection of channels available from each pair.  Up to four viewing points can be added to a subscription.

Solution

CRM.COM must have a different provisioning distributor available for each pair (box and card) offered to subscribers, as channel availability and restrictions can be set separately for each box.

To support this, the following distributors must be set up in the provisioning provider.

  • Main
  • TWIN1
  • TWIN2
  • TWIN3

Back to top 

Provisioning of flexible and fixed bundle products

Handling of Flexible and Fixed Bundle Products

Scenario 2

Company ZX offers its customers flexible and fixed bundle products as well as single channels. Subscribers can request to switch between the available product offerings at any time. It is required that the agents can view the sent requests, to ensure that the signals are provisioned to the customers.

 

Solution

Consider the following provisioning mapping:

  • Components of Flexible Bundle A
    • Geological CA ID = GFA1
    • Entertain CA ID = EFA2
  • Components of Flexible Bundle B
    • Religion CA ID = RFB1
    • Baby channel CA ID = BFB2
  • Flat Products
    • Agriculture CA ID = AF1


Example 1: Provisioning of a flexible bundle

On provisioning a Flexible Bundle A, which includes the Geological and Entertain channels, the following requests will be sent:

  • CREATE_ACCOUNT
  • CREATE_SET_TOP_BOX
  • CREATE_SMARTCARD
  • ADD_PRODUCTS_TO_ACCOUNT
    • CA ID = GFA1 (Geological channel)
    • CA ID = PFA2 (Entertain channel)


Example 2: On swapping from flexible bundle to a flat product

On swapping Flexible Bundle A to Agriculture the following requests will be sent:

  • ADD_PRODUCTS_TO_ACCOUNT
    • CA ID = AF1 (Flat product channel)
  • REMOVE_PRODUCTS_FROM_ACCOUNT
    • CA ID = GFA1 (Geological channel)
    • CA ID = PFA2 (Entertain channel)

Example 3: On upgrading the Flexible Bundle A to Flexible Bundle B with Geological and Religion

On upgrading from one flexible bundle to another the following requests will be sent:

  • ADD_PRODUCTS_TO_ACCOUNT
    • CA ID = RFB1 (Religion channel)
    • CA ID = BFB2 which represents the Baby channel)
  • REMOVE_PRODUCTS_FROM_ACCOUNT
    • CA ID = GFA1 (Geological channel)
    • CA ID = EFA2 (Entertain channel).

Back to top 

 

Notes

  • Use the WEB API to authenticate a subscriber against Nagra Media Live Platform provider.