Nagravision SMSGW Services
- p_demou (Deactivated)
- Persia Xenopoulou (Deactivated)
On this page
Overview
Nagravision is a conditional access system (CAS) that streams content to digital video broadcasting (DVB) subscriptions.
CRM.COM provides a ready-made implementation of Nagravision using the Nagravision SMSgw Services provisioning module, which handles the activation and deactivation of signals transmitted to devices. The module can also be used for messaging, detecting piracy, resetting PINs on subscriber devices, and disabling stolen, lost, or damaged smartcards.
The Nagravision SMSgw Services implementation submits requests on Nagravision CAS asynchronously using the TCP/IP protocol.
Major features
- Integration with Nagravision SMSgw.
- Real-time activation and deactivation of subscriptions.
- Message multiple subscribers simultaneously.
- Manage out of sync subscriptions simultaneously using a batch process and individual subscriptions using a utility.
- Utilities can be used on individual subscriptions (to reset a device or subscription, set a PIN, detect piracy or send a message).
- Archiving of former provisioning requests (refer to Utilities for more information).
Setting Up Nagravision SMSGW
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 |
|
Connection Parameters |
Segment Sub Category default (specified values can be between '0' and '255'). Command Broadcasting Period (in Days) for which the sent command will be valid ('365' by default). Character Set Encoding used in mail or pop-up messages. |
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 |
|
| 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:
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 Restrictions per Physical Good Type: Define the minimum and maximum number of installed items that can be added to the distributor, from specific |
| Dependencies | Define |
CA ID: The service identifier in Nagravision (numeric, up to 12 digits).
| |
Physical Goods (A list of traceable physical goods that can be provisioned through the system) | |
Decoders, Smartcards, Cardless STB The CA ID is defined as the installed item's alternative code. | |
Zip Codes (A list of zip codes mapped onto a component of the address such as the country, area, town, district or municipality) | |
Mapping Method for zip codes that will be sent to Nagravision:
Unless the mapping method is set to 'None', an address component and zip code must be provided. | |
Segment Categories (A list of segment categories and sub-categories mapped onto an address component such as the country, area, town, district or municipality) | |
Mapping Method for the segment categories and sub-categories that will be sent to Nagravision. The following values are supported:
Unless the mapping method is set to 'None', an address component and zip code must be provided. | |
(A unique source ID must be specified for each application server which can communicate with Nagravision SMSgw provisioning provider. Each server can be specified only once.) | |
Application Server that will communicate with Nagravision SMSgw provisioning provider (must be included in the allowed servers) Source ID: CRM.COM unique identifier for Nagravision CAS, used in the TCP request header. A unique source ID must be specified for each allowed server. | |
Defines a mapping of the Nagravision SMSgw commands that will be sent during each event. At least one command mapping must be defined for each subscription action. | |
| Setting an Existing Subscription as Effective | Sent when the 'Become Subscriber ('Effective') and 'Activate Subscription' actions are used. 21 - Reactivate Subscriber ICC 24 - Reactivate all ICC Features |
| Setting an Existing Subscription as Not Effective | Sent when the 'Deactivate subscription' action is used. 20 - Suspend Subscriber ICC 23 - Suspend all ICC Features |
| Starting Services | Sent when a service is activated ('Start Service' subscription action). 905 - Add Enhanced List of Products: Enable if one or more products are added in the product mappings and classified as 'Standard'. 909 - A-la-carte Management: Enable if one or more products are added in the product mappings and classified as 'A-la-carte'. |
| Stopping Services | Sent when a service is deactivated ('Stop Service' subscription action). 904 - Cancel List of Products: Enable if one or more products are added in the product mappings and classified as 'Standard'. 909 - A-la-carte Management: Enable if one or more products are added in the product mappings and classified as 'A-la-carte'. |
| Adding Installed Items | Sent when an installed item is added or swapped ('Add installed item' or 'Swap installed item' action). 51 - Initialize ICC 52 - Pair ICC & STB 46 - Set Segment: If enabled, the default segment category and subcategory in the connection settings and parameters become mandatory. 48 - Set Zip Code: If enabled, the default zip code in the connection settings and parameters becomes mandatory. 99 - IRD - 200 - Set Pin Code: If enabled, the default PIN code in the connection settings and parameters becomes mandatory. 99 - IRD - 198 Set Network ID |
| Removing Installed Items | Sent when an installed item is removed or swapped ('Remove installed item' or 'Swap installed item' action). At least one of the available commands must be enabled. 7 - All product cancellation 52 - Pair ICC & STB |
| Changing Subscription Location | Sent when a subscription address is modified ('Change subscription location' action). 46 - Set Segment 48 - Set Zip Code |
Related configuration areas
Mandatory modules must be configured for the provisioning module to work.
| Manual Link | Area | Description | Configuration |
|---|---|---|---|
| Products |
| 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 |
| Communications | Communication Queue External System | Set up the external system that will be used to handle mail messages created for the provider. | Optional |
Using Batch Processes to Handle Subscriptions
Billing > Provisioning > Nagravision SMSgw Services
Resetting out of sync subscriptions
Billing > Provisioning > Common Services > Perform Reset Subscription Runs
Reset subscription runs are used to identify and synchronize subscriptions that have gone out of sync, by communicating the necessary commands to the CA/OTT platform. It is possible to preview the subscriptions that will be reset by the run, by using Preview from the Actions menu.
The table describes the sections of Reset Subscription Runs Data Entry page and explains how the fields in the page are used.
Mandatory
Configurable
| Main Information | |
|---|---|
| |
Criteria (optional) (Used to identify the subscriptions that should be reset) | |
Subscription Creation Period: Define the period during which the subscriptions to be processed were created (otherwise, all subscriptions will be processed). Subscription Types that should be included in the run. |
Sending email & pop-up messages
Mail runs are used to send messages to subscriber devices. The messages can be displayed in the set-top box (STB) mailbox or directly on the screen (once or repeatedly).
Messages can be scheduled to appear as soon as they are sent or at a specific time.
The process run does not create the messages; the messages are created in the system as communications (through notifications) and remain 'Pending' in the communication queue until the mail run is executed. The mail run identifies the communications that should be handled by matching each entry in the communication queue 'Communication Queue External System' with one defined in the mail run.
The table describes the sections of the Email & Pop-up Message Run Definition Data Entry page and explains how the fields in the page are used.
Mandatory
Configurable
| Main Information | |
|---|---|
Input Settings | |
|
Sending a fingerprint
Fingerprinting runs are used to detect piracy:
- The runs identify subscriptions that are not abiding to the contract agreement (e.g., the subscriber signed up as a home user and is using the subscription for public viewing).
- The runs identify users that do not have a subscription and are using one illegally.
Fingerprinting sends a message that is displayed on the screen of the subscriber. An employee must be on location to confirm whether or not the subscription is legal.
The table describes the sections of Fingerprinting Run Definition Data Entry page and explains how the fields in the page are used.
Mandatory
Configurable
| Main Information | |
|---|---|
Criteria | |
Included Segments: A list of subscriber segments that will receive the fingerprint. Excluded Segments: A list of subscriber segments that will not receive the fingerprint. | |
Input Settings (Used to identify and construct 'Display Fingerprint' provisioning requests) | |
Duration (in Seconds) of the fingerprint display. Defaults to '10' if not specified. Number of repetitions, Time between Repetitions: The number of times a fingerprint will be displayed on the screen and the time lag between repetitions (seconds). If 'Number of Repetitions' is set to '0' or '1', the fingerprint is displayed once. Foreground Color Background Color Display Logo: Defines whether a logo will be displayed on the screen with the fingerprint. The available options are '1' (default, no logo displayed), '2' and '3'. Position (X,Y): Defines the position of the fingerprint, measured in pixels (0-100). The X value, defines the horizontal position of the fingerprint, starting from the left side of the video frame. The Y value, defines the vertical position of the fingerprint, stating from the top side of the video frame. If not specified, then the position is set based on the CA system settings. Display time: If enabled, the time will be included in the fingerprint message (as HH:MM:SS). Display STB number: If enabled, the STB number will be included in the fingerprint message. |
Using a Utility to Handle a Subscription
Billing > Provisioning > Nagravision SMSgw
Utilities are used to handle one subscription at a time.
Reset single subscription
Updates an out of sync subscription, so that the provider reflects the state in CRM.COM.
Sending single email & pop up messages
Sends on-screen or inbox messages to a subscriber device.
Provide the required information starting with the type of text. As the message text is provided through the utility, there is no related Communication (unlike message runs).
| Main Information |
|---|
|
Sending a single fingerprint
Sends a fingerprinting command to a single device to check for piracy.
Provide the information required by the utility and submit.
Main Information (Settings that will be used to identify and construct the 'Display Fingerprint' provisioning requests) |
|---|
Duration (in Seconds) of the fingerprint display ('10' by default). Number of repetitions, Time between Repetitions: The number of times a fingerprint will be displayed on the screen and the time lag between repetitions (in seconds). If 'Number of repetitions' is set to '0' or '1', the fingerprint is displayed once. Foreground Color Background Color Display Logo: Defines whether a logo will be displayed on the screen with the fingerprint. The available options are '1' (default, no logo displayed), '2' and '3'. Position (X,Y): Defines the position of the fingerprint, measured in pixels (0-100). The X value, defines the horizontal position of the fingerprint, starting from the left side of the video frame. The Y value, defines the vertical position of the fingerprint, stating from the top side of the video frame. If not specified, then the position is set based on the CA system settings. Display time: If enabled, the time will be included in the fingerprint message (as HH:MM:SS). Display STB number: If enabled, the STB number will be included in the fingerprint message. |
Disabling a smartcard
In case a smartcard or a cardless STB is stolen, lost or damaged, it can be set to 'not usable'.
Select the smartcard to disable and submit the request.
Resetting a smartcard PIN
Resets the PIN of a single STB, either to its default value or to a value specified by the user.
Additionally, you can clear the PIN.Select a smartcard to reset its PIN. To reset to a 'Given Value' also provide a New PIN, otherwise, the PIN is reset to '1234'.
Nagravision SMSGW Requests
The table below displays CRM.COM processes and actions that trigger Nagravision requests, as well as the parameters sent for each request.
Nagravision SMSGW Business Examples
Subscription with multiple viewing points
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
Provisioning 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:
- 1 Create Pairing (Smartcard and Decoder)
- 2 Add Subscriptions (Gold and Silver)
- CA ID = GFA1 (Geological channel)
- CA ID = PFA2 (Entertain channel)
Example 2: On swapping from a flexible bundle to a flat product
On swapping Flexible Bundle A to Agriculture the following requests will be sent:
- 1 Add Subscription
- CA ID = AF1 (Flat product channel)
- 2 Cancel Subscriptions
- 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:
- 2 Add Subscription
- CA ID = RFB1 (Religion channel)
- CA ID = BFB2 (Baby channel)
- 2 Cancel Subscriptions
- CA ID = GFA1 (Geological channel)
- CA ID = EFA2 (Entertain channel).
Sending mail messages to subscriber boxes
Scenario 3
Company ZX wants to send personalized messages to its subscribers that are:
- Directly accessible through their set-top boxes (STBs)
- Displayed on their TV.
Solution.
Agents should use the 'Mail & Pop-up Messages Utility', select the appropriate type of message for each method of communication, and provide the message.
Messages that can be accessed through subscriber's STB inbox | Mail Message |
|---|---|
Messages that are shown on subscriber's TV | Pop-up Message |
Notes
- If you are using a previous release, view CRM.COM Release Changes.
- Use the WEB API to create and manage Nagravision SMSGW from an external system, such as a customer portal. Refer to the Nagravision SMSGW WEB API for a comprehensive list of available actions.