Open IPTV Forum
Release 2 Specification
Volume 7 - Authentication, Content Protection and Service Protection
[V2.3] - [2014-01-24]
Postal Address
Open IPTV Forum support office
650 Route des Lucioles - Sophia Antipolis
Valbonne - FRANCE
Tel.: +33 4 92 94 43 83
Fax: +33 4 92 38 52 90
Internet
http://www.oipf.tv
Disclaimer
The Open IPTV Forum accepts no liability whatsoever for any use of this document.
Copyright Notification
No part may be reproduced except as authorized by written permission.
Any form of reproduction and/or distribution of these works is prohibited.
Copyright 2014 © Open IPTV Forum e.V.
All rights reserved.
This Technical Specification (TS) has been produced by the Open IPTV Forum.
This specification provides multiple options for some features. The Open IPTV Forum Profiles specification complements the Release 2 specifications by defining the Open IPTV Forum implementation and deployment profiles. This document is Volume 7 in the 10 Volume set of specifications that define the Open IPTV Forum Release 2 Solution.
The other Volumes in the set are:
The present document, the Authentication, Content Protection and Service Protection Specification (Volume 7), specifies the Authentication, Content and Service Protection functionality of the OIPF Release 2 solution.
The requirements for this functionality are derived from the following sources:
For the system-wide scope, refer to [OIPF_OVIEW2], section 1.
The scope of the present Volume is content protection, service protection, service access protection, user identification, user authentication, and user authorisation.
The following sections contain features for which the criteria that determine under which circumstances these features are implemented are out of the scope of the present document or contain conditional normative statements referring to other volumes of the Open IPTV Forum specifications:
Note that GBA authentication can be achieved using either the mechanism in section 5.4.5 GBA Authentication using IMS Gateway or the, more general, mechanism in section 5.4.4 HTTP Digest Authentication using IMS Gateway. Section 5.4.4 allows the use of different authentication mechanism in a way that is transparent to the OITF, including possible future authentication mechanisms, and should preferably be used. It is expected that section 5.4.5 GBA Authentication using IMS Gateway will be deprecated and removed in future versions of this specification.
[3GPP24.109] | 3GPP, TS 24.109, "Bootstrapping interface (Ub) and network application function interface (Ua); Protocol details". |
[3GPP24.229] | 3GPP, TS 24.229, "3GPP; Technical Specification Group Core Network and Terminals; Internet Protocol (IP) multimedia call control protocol based on Session Initiation Protocol (SIP) and Session Description Protocol (SDP); Stage 3 (Release 8)". |
[3GPP31.103] | 3GPP, TS 31.103, "3GPP; Technical Specification Group Core Network and Terminals; Characteristics of the IP Multimedia Services Identity Module (ISIM) application (Release 8)". |
[3GPP33.203] | 3GPP, TS 33.203, "3GPP; Technical Specification Group Services and System Aspects; 3G security; Access security for IP-based services (Release 8)". |
[3GPP33.220] | 3GPP, TS 33.220, "Generic Authentication Architecture (GAA); Generic bootstrapping architecture". |
[ATIS-IDSA] | ATIS, ATIS-0800006, IIF Default Scrambling Algorithm (IDSA) |
[CEA-2014-A] | Consumer Electronics Association, CEA-2014-A, "Web-based Protocol Framework for Remote User Interface on UPnP Networks and the Internet (Web4CE)", (including the August 2008 Errata) |
[CENC] | ISO/IEC, FDIS 23001-7:2011, "Information technology - MPEG systems technologies - Part 7: Common encryption in ISO base media file format files" |
[CI+] | CI Plus LLP, CI Plus Specification, "Content Security Extensions to the Common Interface", V1.3 (2011-01). |
[DTCP] | Hitachi, Intel, Matsushita, Sony, Toshiba, "Digital Transmission Content Protection Specification, Volume 1 (Informational Version)", Revision 1.51. |
[DTCP-AA] | DTLA, DTCP Adopter Agreement, “Digital Transmission Protection License Agreement”. |
[DTCP-IP] | Hitachi, Intel, Matsushita, Sony, Toshiba, "DTCP Volume 1 Supplement E, Mapping DTCP to IP, (Informational Version)", Revision 1.2. |
[DVB-CA] | ETSI, ETR 289, "Digital Video Broadcasting (DVB); Support for the use of scrambling and Conditional Access (CA) within digital broadcasting systems", October 1996. |
[DVB-CI] | ETSI,
EN 50221, "Common Interface Specification for Conditional Access and
other Digital Video Broadcasting Decoder Applications", February 1997,
and ETSI, TS 101 699 V1.1.1, "Digital Video Broadcasting (DVB); Extensions to the Common Interface Specification". |
[DVB-SC] | ETSI, TS 103 197 V1.5.1, "Digital Video Broadcasting (DVB); Head-end implementation of DVB SimulCrypt", March 2007. |
[DVB-SRM] | DVB BlueBook A135, "Digital Video Broadcasting (DVB); System Renewability Messages (SRM) in DVB systems" |
[DVBSI] | ETSI, EN 300 468 V1.13.1 (2012-08), "Digital Video Broadcasting (DVB); Specification for Service Information (SI) in DVB systems". |
[HDCP] | Digital Content Protection LLC, "High-bandwidth Digital Content Protection System", Revision 1.3. |
[IEC62455] | IEC, IEC 62455, "Internet protocol (IP) and transport stream (TS) based service access". |
[MPEG2TS] | ISO/IEC, 13818-1:2000/Amd.3:2004, "Generic coding of moving pictures and associated audio information: Systems". |
[MRL-BBTS] | Marlin Developer Community, "Marlin Broadband Transport Stream Specification", Version 1.0, July 2008. |
[MRL-BNSP] | Marlin Developer Community, "Marlin – Broadband Network Service Profile Specification", Version 1.1 |
[MRL-CORE] | Marlin Developer Community, "Marlin - Core System Specification", Version 1.3 |
[MRL-DMZ] | Marlin Developer Community, "Marlin Dynamic Media Zones", Version 1.1 |
[MRL-FF] | Marlin Developer Community, "Marlin - File Formats Specification", Version 1.1, July 2008, and latest version of "Marlin Errata: Marlin - File Formats Specification V1.1". |
[MRL-MS3] | Marlin Developer Community, "Marlin –Simple Secure Streaming Specification", Version 1.1.1 |
[OMARLIN] | Marlin Developer Community, "OMArlin Specification", Version 1.0.1, July 2008. |
[RFC2109] | IETF, RFC 2109, "HTTP State Management Mechanism" URL: http://tools.ietf.org/html/rfc2109 |
[RFC2617] | IETF, RFC 2617, "HTTP Authentication: Basic and Digest Access Authentication" URL: http://tools.ietf.org/html/rfc2617 |
[RFC3261] | IETF, RFC 3261, "SIP: Session Initiation Protocol" URL: http://tools.ietf.org/html/rfc3261 |
[RFC5746] | IETF, RFC 5746, "Transport Layer Security (TLS) Renegotiation Indication Extension" URL: http://tools.ietf.org/html/rfc5746 |
[SAMLCORE] | OASIS, "Assertions and Protocols for the OASIS Security Markup Language (SAML) V2.0". |
[SAMLPROF] | OASIS, "Profiles for the OASIS Security Assertion Markup Language (SAML) V2.0". |
[OIPF_ARCH2] | Open IPTV Forum, "Functional Architecture - V2.3", January 2014. |
[OIPF_DAE2] | Open IPTV Forum, "Release 2 Specification, Volume 5 - Declarative Application Environment", V2.3, January 2014. |
[OIPF_HAS2] | Open IPTV Forum, "Release 2 Specification, Volume 2a - HTTP Adaptive Streaming", V2.3, January 2014. |
[OIPF_MEDIA2] | Open IPTV Forum, "Release 2 Specification, Volume 2 - Media Formats", V2.3, January 2014. |
[OIPF_META2] | Open IPTV Forum, "Release 2 Specification, Volume 3 - Content Metadata", V2.3, January 2014. |
[OIPF_OVIEW2] | Open IPTV Forum, "Release 2 Specification, Volume 1 - Overview", V2.3, January 2014. |
[OIPF_PAE2] | Open IPTV Forum, "Release 2 Specification, Volume 6 - Procedural Application Environment", V2.3, January 2014. |
[OIPF_PROT2] | Open IPTV Forum, "Release 2 Specification, Volume 4 - Protocols", V2.3, January 2014. |
[OIPF_PROT_EX2] | Open IPTV Forum, "Release 2 Specification, Volume 4a - Examples of IPTV Protocol Sequences", V2.3, January 2014. |
[OIPF_SERV2] | Open IPTV Forum, "Services and Functions for Release 2", V1.0, October 2008. |
[OIPF_WSTVP2] | Open IPTV Forum, "Release 2 Specification, Volume 5a - Web Standards TV Profile", V2.3, January 2014. |
[RFC2119] | S. Bradner. Key words for use in RFCs to Indicate Requirement Levels. March 1997. Internet RFC 2119. URL: http://www.ietf.org/rfc/rfc2119.txt |
The key words "must", "must not", "required", "shall", "shall not", "should", "should not", "recommended", "may", and "optional" in this document are to be interpreted as described in [RFC2119].
All sections and appendixes, except "Scope" and "Introduction", are normative, unless they are explicitly indicated to be informative.
Term | Definition |
---|---|
Business Token | collection of information defined in [MRL-BNSP] that contains the service specific information for a given business model |
Content and Service Protection Gateway | optional gateway function that provides a conversion from a (proprietary) content and service protection solution in the network to one that is supported by an OITF, as defined in this specification |
Client Function | function that interacts with the Marlin Client Function in a Content and Service Protection |
Content and Service Key Management Function | entity responsible for storing and providing Service, Program, Content Keys and ECM attached information This function may be physically co-located with other functions (e.g. the Content Delivery Network Controller for Content on Demand services), see [OIPF_ARCH2]. This entity has been identified in release 1 just to illustrate informatively the separation between content encryption which is part of content preparation and content delivery. |
Content on Demand Encryption Management Function | back office Content on Demand function in charge of launching Content on Demand encryption. This entity has been identified in release 1 just to illustrate informatively the separation between content encryption which is part of content preparation and content delivery. |
Content and Service Protection | function that handles service protection and content protection for the client in the OITF |
CSP-G Server | functional entity in the network that handles content protection and service protection for the Content and Service Protection Gateway (CSPG) in the residential network |
CSP-T Server | functional entity in the network that handles service protection and content protection for the CSP-T client in the OITF |
Marlin Action Token | token defined either in [MRL-BNSP] or in [MRL-MS3] that is used to trigger the Marlin Protocols from the Marlin Client Function in CSP, and from which some information (e.g., business token) is used in the Marlin protocols. The mimeType attribute is used to qualify which Marlin token type is returned. |
Marlin Client Function | compliant implementation of the Marlin Client that is defined in [MRL-BNSP] and that enables secure communications (Marlin Protocols) with the Marlin Server Function in a CSP-T Server |
Marlin Configuration Token | token defined in [MRL-BNSP] that includes the location information of the Marlin Server Function in CSP-T Server with which the CSP communicates |
Marlin Server Function | compliant implementation of the Marlin Server that is defined in [MRL-BNSP] and that enables secure communications (Marlin Protocols) with the Marlin Client Function in a CSP |
MS3 Manifest File | A text document carrying a Stream Access Statement URL and a Content URI Template, as specified in [MRL-MS3] |
MS3 Stream Access Statement | Stream Access Statement as specified in [MRL-MS3] |
Output Control Information | Output Control Information as defined in [MRL-BNSP] and [MRL-BBTS] |
Program Key | symmetric key defined in [IEC62455] that encrypts an ECM |
Scramble Key | symmetric key that scrambles the content |
Server Function | function that interacts with the Marlin Server Function in a CSP-T Server |
serviceBaseCID | the part of the Content ID that is the same for all content in a service |
Service Key | symmetric key defined in [IEC62455] that encrypts an ECM or a Program Key |
Single Sign On | Single Sign On method of service access control that enables the user to authenticate once and gain access to the resources of multiple services |
In addition to the Abbreviations provided in Volume 1, the following abbreviations are used in this Volume.
Acronym | Explanation |
---|---|
3GPP | Third Generation Partnership Project |
AES | Advanced Encryption Standard |
AKE | Authentication and Key Exchange |
APDU | Application Protocol Data Unit |
ATIS | Alliance for Telecommunications Industry Solutions |
BBTS | Broadband Transport Stream – MPEG-2 transport stream as defined by [MRL-BBTS] |
BNS | Broadband Network Service |
BSF | Bootstrapping Server Function |
bslbf | bit string, left bit first |
B-TID | Bootstrapping Transaction Identifier |
CA | Conditional Access |
CAD | Content Access Descriptor |
CAM | Conditional Access Module |
CAT | Conditional Access Table |
CBC | Cipher-Block Chaining |
CE-HTML | Consumer Electronics – HTML |
CI | Common Interface |
CSKMF | Content and Service Key Management Function |
CSPG-CI+ | CSPG – CI+ based |
CSPG-DTCP | CSPG – DTCP-IP based |
CSP-T | Content and Service Protection – Terminal-Centric Approach |
DCF | DRM Content Format |
DMZ | Dynamic Media Zones |
DNR | Do Not Record |
DNTS | Do Not Time Shift |
DTCP | Digital Transmission Content Protection |
DTLA | Digital Transmission Licensing Administrator |
DVB | Digital Video Broadcasting |
ECM | Entitlement Control Message |
EMM | Entitlement Management Message |
ETSI | European Telecommunications Standards Institute |
FQDN | Fully Qualified Domain Name |
GAA | Generic Authentication Architecture |
HDCP | High-bandwidth Digital Content Protection |
HDD | Hard Disk Drive |
HNI-AMNI | Home Network Interface – Additional Managed Network Interface |
HNI-CSP | Home Network Interface – Content and Service Protection |
HNI-IGI | Home Network Interface – IMS Gateway Interface |
HNI-INI | Home Network Interface – ITF (IPTV Terminal Function) Network Interface |
ID | Identity |
IDSA | IIF Default Scrambling Algorithm |
IEC | International Electrotechnical Commission |
IETF | Internet Engineering Task Force |
IIF | IPTV Interoperability Forum |
IPMC | IP Multicast |
IPMP | Intellectual Property Management Protocol |
ISO | International Organization for Standardization |
IV | Initialization Vector |
KDF | Key Derivation Function |
KSM | Key Stream Message |
M-CID | Marlin Content ID |
MIME | Multipurpose Internet Mail Extensions |
MP4 | MPEG-4 |
MPEG | Moving Pictures Experts Group |
MS3 | Marlin Simple Secure Streaming |
NAF | Network Application Function |
NPI | Network Provider Interface |
OASIS | Organization for the Advancement of Structured Information Standards |
PCMCIA | Personal Computer Memory Card International Association |
PCP | Protected Content Packet |
PDCF | Packetized DRM Content Format |
PES | Packetized Elementary Stream |
PID | Packet Identifier |
PIN | Personal Identification Number |
PKI | Public Key Infrastructure |
PMT | Program Map Table |
SAML | Security Assertion Markup Language |
SAS | Specific Application Support |
SRM | System Renewability Message |
TEK | Traffic Encryption Key |
TISPAN | Telecoms & Internet converged Services & Protocols for Advanced Networks |
TLS | Transport Layer Security |
TLV | Type Length Value |
TS | Transport Stream |
TV | Television |
uimsbf | unsigned integer most significant bit first |
UNIS-CSP-G | User Network Interface Specific – Content and Service Protection Gateway |
UPnP | Universal Plug and Play |
URI | Usage Rule Information |
This section specifies the Content and Service protection functionality.
It consists of a specification of
This section specifies the functionality for the OIPF Terminal-Centric Approach to Content & Service Protection. In order to do this, this section provides a mapping from all relevant functions and interfaces from [OIPF_ARCH2] to specific sections of Marlin specifications [MRL-BNSP] and [MRL-MS3].
All normative statements in this section and its sub-sections apply only in case the Terminal-Centric Approach is supported by the OITF.
OITFs that support the OIPF Terminal-Centric Approach to Content & Service Protection shall be compliant with [MRL-BNSP] and may be compliant with [MRL-MS3].
NOTE: The criteria that determine under which circumstances the Terminal-Centric Approach is implemented are out of the scope of the present document.
NOTE: The criteria that determine under which circumstances the support for Marlin metering for content or rights owner settlement is implemented in the OITF are out of the scope of the present document.
This section describes the interfaces related to a CSP and CSP-T Server in the Functional Architecture described in [OIPF_ARCH2].
The main scope of this section is to describe CSP interfaces (CSP-1, UNIS-CSP-T) and CSP-T Server interfaces (NPI CSPTx, x = 1, 2, 3). CSP-1 is the interface between CSP and OITF Functions. NPI-CSPTx, x = 1, 2, 3, are the interfaces between the CSP-T Server and Providers Network Functions. This section informatively touches upon the Marlin License Evaluation and Content Encryption.
Only the UNIS-CSP-T interface and the interface to DAE in CSP-1 are normative. The other interfaces are informatively described for comprehension.
Figure 1 shows the message flow overview.
The four functional entities in Figure 1 are described below:
Note that the OITF Function with which the CSP communicates is not limited as described in this document and may vary depending on the implementation of the OITF.
When requested from a native application or from the DAE application to handle a Marlin Action Token or a MIPPVControlMessage, see section 4.1.7.3, the CSP shall act as a Marlin DRM Client and shall perform Marlin Protocols as specified in [MRL-BNSP] or [MRL-MS3] as applicable. Furthermore, in the context of [MRL-BNSP], if there are no available rights when trying to use content, the CSP shall comply with [MRL-BBTS] and [OMARLIN] and shall try to use the URL specified in the content to acquire new rights.
In both cases, the CSP-T Server shall comply with Marlin Protocols as specified in [MRL-BNSP].
These protocols are:
If Marlin Simple Secure Streaming feature is supported, the CSP-T Server may comply with MS3 Protocols as specified in [MRL-MS3]
Marlin Protocols are described in section 4.1.1.4.
The DAE DRM Agent API, as defined in [OIPF_DAE2] section 7.6.1, triggers handling of DRM Message, e.g. Marlin Action Token, MIPPVControlMessage or Marlin License. When the sendDRMMessage API is called for a DRMSystemID set to the value defined for Marlin, OITF shall forward the DRM Message to the CSP function. The result of calling sendDRMMessage> is notified through the onDRMMessageResult event handler.
Typical DRM events shall be triggered by CSP to DAE via A/V Control or video/broadcast object when content cannot be played, recorded or time shifted, due to a lack of rights (no license, invalid license) or parental control locking. These events are defined in [OIPF_DAE2] sections 7.13.6 and 7.14.6. The DRMSystemID of these events shall be set to the value defined for Marlin.
A DAE application or native application may use DRMControlInformation, defined as an extension to PurchaseItem in [OIPF_META2], present in the BCG and SD&S retrieved by the metadata client. SilentRightsURL, PreviewRightsURL and RightsIssuerURL in DRMControlInformation may be used to get updated rights. If the DRMSystemID in DRMControlInformation is set to the value defined for Marlin, the application shall forward the DRMPrivateData, if present, to the CSP. A DAE application shall use sendDRMMessage, defined in [OIPF_DAE2] section 7.6.1.2, to forward the DRMPrivateData.
All objects defined in [OIPF_DAE2] that are requested to handle a content-access descriptor, defined in [OIPF_DAE2] shall check if the content-access descriptor includes DRMControlInformation. These objects or the underlying functions shall forward the available DRMPrivateData in the DRMControlInformation to the CSP if the DRMSystemID is set to the value defined for Marlin.
NOTE: The DRMSystemID is defined in section 4.1.7.1 for Marlin.
Marlin Registration provides functions which enable a Marlin Client Function in CSP to register to a Marlin domain. Marlin Registration consists of Node Acquisition and Link Acquisition.
Node Acquisition provides an Octopus Node Object from a Marlin Server Function in CSP-T Server to a Marlin Client Function in CSP. Note that Node Acquisition is performed prior to the respective Link Acquisition to provide the Octopus Node Objects necessary for the Link Acquisition.
Marlin Node Acquisition Protocol is triggered by a Marlin Action Token for Node Acquisition (hereafter Node Acquisition Action Token) from CSP. The OITF Function acquires the Node Acquisition Action Token and then the OITF Function feeds it to CSP. After CSP acquires corresponding Marlin Configuration Token from CSP-T Server, CSP executes Marlin Node Acquisition Protocol with CSP-T Server. Note that Marlin Node Acquisition Protocol is to provide one Octopus Node Object per its request and response.
The message flow in case of Node Acquisition is shown in Figure 2.
In Node Acquisition Sequence, the following steps are performed:
1. | The OITF Function (e.g. DAE) communicates with
IPTV Applications and IPTV Service Profile function via UNIS-6 and
NPI-17 for Node Acquisition. Note that, although
NPI-17 is assumed as the interface for communication between IPTV
Applications and IPTV Service Profile, in the case of the managed
network model, NPI-2 and NPI-6 may be used instead. |
2. | Given the Marlin Action Token URL (e.g. embedded into the webpage obtained in step 1), the OITF Function (e.g. DAE application) sends the request for the Node Acquisition Action Token to the IPTV Applications by UNIS-6. |
3. | When receiving the request from the OITF Function, the IPTV Applications sends a request to the IPTV Service Profile function via NPI-17 to get the necessary information to generate the Node Acquisition Action Token. |
4. | Receiving the request from IPTV Applications, the IPTV Service Profile function sends Business Token and user information to IPTV Applications. |
5. | Given the information from the IPTV Applications, when there is no Octopus Node for the given user information, the CSP-T Server generates Octopus Node and correlates user information with the Octopus Node, so that CSP-T Server can check for the existence of the Octopus Node next time from the user information. Then the CSP-T Server correlates the Business Token with Octopus Node so that the CSP-T Server can provide the corresponding Octopus Node from the Business Token included in the (Marlin Node Acquisition Protocol) request. |
6. | IPTV Applications sends the Node Acquisition Action Token to the OITF Function by UNIS-6. |
7. | The OITF Function sends the Node Acquisition Action Token to the CSP by CSP-1. |
8. | When the CSP does not have a corresponding Marlin Configuration Token, the CSP gets the Marlin Configuration Token from the CSP-T Server by referring to the URL specified in the Node Acquisition Action Token. |
9. | Given the Node Acquisition Action Token, the CSP sends a (Marlin Node Acquisition Protocol) request to CSP-T Server by UNIS-CSP-T. |
10. | To check the request from the CSP, the CSP-T Server sends the Business Token (and possibly other client data such as client version, model, etc... extracted from the request) to the IPTV Service Profile function. |
11. | The IPTV Service Profile function validates the data received from the CSP-T Server. |
12. | If validation succeeds, the IPTV Service returns to CSP-T Server the data necessary to fulfil the CSP request. If validation fails, an error is returned to the CSP-T Server. |
13. | The CSP-T Server sends a Marlin (Node Acquisition) response message to the CSP. This response includes either the Octopus Node correlated to the Business Token sent in the original CSP request, or an error message as defined in [MRL-BNSP]. |
Link Acquisition provides an Octopus Link from Marlin Server Function in CSP-T Server to Marlin Client Function in CSP.
Note that this sequence assumes that the corresponding Node Acquisition has already been performed between the CSP and CSP-T Server.
Marlin Link Acquisition Protocol is triggered by a Marlin Action Token for Link Acquisition (hereafter Link Acquisition Action Token) from CSP. The OITF Function acquires the Link Acquisition Action Token, and then the OITF Function feeds it to CSP. After CSP acquires corresponding Marlin Configuration Token from CSP-T Server, CSP executes Marlin Link Acquisition Protocol with CSP-T Server.
The message flow in case of Link Acquisition is shown in Figure 3.
In Link Acquisition Sequence, the following steps are performed:
1. | The OITF function (e.g. DAE) communicates with
IPTV Applications and IPTV Service Profile function via UNIS-6 and
NPI-17 for Link Acquisition. Note that, although
NPI-17 is assumed as the interface for communication between IPTV
Applications and IPTV Service Profile, in the case of the managed
network model, NPI-2 and NPI-6 may be used instead. |
2. | Given the Marlin Action Token URL (e.g. embedded into the webpage obtained in step 1), the OITF Function (e.g. DAE application) sends the request for the Link Acquisition Action Token to IPTV Applications by UNIS-6. |
3. | When receiving the request from the OITF Function, the IPTV Applications sends a request to the IPTV Service Profile function by NPI-17 to get necessary information to generate the Link Acquisition Action Token, |
4. | Receiving the request from IPTV Applications, the IPTV Service Profile function sends Business Token and user information to IPTV Applications. |
5. | Given the user information from the IPTV Applications, the CSP-T Server finds the information of Octopus Node which corresponds to “From Node” and “To Node”. Then the CSP-T Server correlates the Business Token with “From Node” and “To Node” so that the CSP-T Server can check the information in (Marlin Link Acquisition Protocol) request. |
6. | IPTV Applications sends the Link Acquisition Action Token to the OITF Function by UNIS-6. |
7. | Given the Link Acquisition Action Token, the OITF Function sends it to the CSP by CSP-1. |
8. | When the CSP does not have a corresponding Marlin Configuration Token, the CSP gets the Marlin Configuration Token from the CSP-T Server by referring to the URL specified in the Link Acquisition Action Token by UNIS-CSP-T. |
9. | Given the Link Acquisition Action Token, the CSP sends a (Marlin Link Acquisition Protocol) request to the CSP T Server. |
10. | To check the request from the CSP, when the request includes the correct combination of Business Token, “From Node”, and “To Node”, the CSP-T Server sends a Business Token and MessageID to the IPTV Service Profile function by NPI-CSPT1a. The MessageID is a unique id, and the same MessageID is set among request, response, and confirmation, so that IPTV Service Profile function can use the MessageID to correlate request, response, and confirmation. |
11. | The IPTV Service Profile function validates the data received from the CSP-T Server. |
12. | If validation succeeds, the IPTV Service Profile function returns to CSP-T Server the data necessary to fulfil the CSP request. If validation fails, an error is returned to the CSP-T Server. |
13. | The CSP-T Server sends a Marlin (Registration) response message to the CSP. This response includes either the registration agent correlated to the Business Token sent in the original CSP request, or a fault message as defined in [MRL-BNSP]. |
14. | The CSP sends a (Marlin Link Acquisition Protocol) Confirmation to the CSP-T Server by UNIS-CSP-T. |
15. | The CSP-T Server checks the resultCode (i.e. success or failure for registration in CSP), and then stores the “From Node” and “To Node” information by correlating with the user information so that CSP-T Server can manage Marlin domain information for the user. |
16. | The CSP-T Server sends the resultCode and the MessageID to the IPTV Service Profile function by NPI-CSPT1a. |
17. | The IPTV Service Profile function stores the resultCode in connection with the user information from step 4. |
Marlin Deregistration provides functions which enable Marlin Client Function in CSP to deregister from a Marlin domain.
Note that this sequence assumes that the corresponding Node Acquisition and Link Acquisition have already been performed between the CSP and CSP-T Server.
Marlin Deregistration Protocol is triggered by a Marlin Action Token for Deregistration (hereafter Deregistration Action Token) from CSP. The OITF Function acquires the Deregistration Action Token, and then the OITF Function feeds it to CSP. After CSP acquires corresponding Marlin Configuration Token from CSP-T Server, CSP executes Marlin Deregistration Protocol with CSP-T Server.
The sequence of deregistration messages is shown in Figure 4.
In this deregistration sequence, the following steps are performed:
1. | The OITF function (e.g. DAE) communicates with
IPTV Applications and IPTV Service Profile function via UNIS-6 and
NPI-17 for Marlin Deregistration. Note that,
although NPI-17 is assumed as the interface for communication between
IPTV Applications and IPTV Service Profile, in the case of the managed
network model, NPI-2 and NPI-6 may be used instead. |
2. | Given the Marlin Action Token URL (e.g. embedded into the web page obtained in step 1), the OITF Function (e.g. DAE application) sends the request for the Deregistration Action Token to the IPTV Applications by UNIS-6. |
3. | When receiving the request from the OITF Function, the IPTV Applications sends a request to the IPTV Service Profile function by NPI-17 to get necessary information to generate the Deregistration Action Token. |
4. | Receiving the request from IPTV Applications, the IPTV Service Profile function sends Business Token and user information to IPTV Applications. |
5. | Given the user information from the IPTV Applications, the CSP-T Server finds the information of Octopus Node which corresponds to “From Node” and “To Node”. Then the CSP-T Server correlates the Business Token with “From Node” and “To Node” so that the CSP-T Server can check the information in (Marlin Deregistration Protocol) request. |
6. | IPTV Applications sends the Deregistration Action Token to the OITF Function by UNIS-6. |
7. | Given the Deregistration Action Token, the OITF Function sends it to the CSP by CSP-1. |
8. | When the CSP does not have a corresponding Marlin Configuration Token, the CSP gets the Marlin Configuration Token from the CSP-T Server by referring to the URL specified in the Deregistration Action Token. |
9. | Given the Deregistration Action Token, the CSP sends a (Marlin Deregistration Protocol) request to the CSP-T Server by UNIS-CSP-T. |
10. | To check the request from the CSP by the IPTV Service Profile function, when the request includes the correct combination of Business Token, “From Node”, and “To Node”, the CSP-T Server sends a Business Token and MessageID to the IPTV Service Profile function by NPI-CSPT1a. The MessageID is a unique id and the same MessageID is set among request, response, and confirmation so that IPTV Service Profile function can use the MessageID to correlate request, response, and confirmation. |
11. | The IPTV Service Profile function validates the data received from the CSP-T Server. |
12. | If validation succeeds, the IPTV Service Profile function returns to CSP-T Server the data necessary to fulfil the CSP request. If validation fails, an error is returned to the CSP-T Server. |
13. | The CSP-T Server sends a Marlin (Deregistration) response message to the CSP. This response includes either the deregistration agent correlated to the Business Token sent in the original CSP request, or an error message as defined in [MRL-BNSP]. |
14. | The CSP sends a (Marlin Deregistration Protocol) Confirmation to the CSP-T Server by UNIS-CSP-T. |
15. | The CSP-T Server checks the resultCode (i.e. success or failure for deregistration in CSP) and Message ID, and then stores the “From Node” and “To Node” information by correlating it with the user information, so that CSP-T Server can manage Marlin domain information for the user. |
16. | The CSP-T Server sends the resultCode and the MessageID to the IPTV Service Profile function by NPI-CSPT1a. |
17. | The IPTV Service Profile function stores the resultCode in connection with the user information from step 4. |
License Acquisition provides functions which enable Marlin Client Function in CSP to obtain a Marlin License.
Marlin License Acquisition Protocol is triggered by a Marlin Action Token for License Acquisition (hereafter License Acquisition Action Token) from CSP. The OITF Function acquires the License Acquisition Action Token, and then the OITF Function feeds it to the CSP. After CSP acquires corresponding Marlin Configuration Token from CSP-T Server, CSP executes Marlin License Acquisition Protocol with CSP-T Server.
The sequence of license acquisition messages is shown in Figure 5.
In this sequence, the following steps are performed:
1. | The OITF Function (e.g. DAE) communicates with
IPTV Applications and IPTV Service Profile function via UNIS-6 and
NPI-17 for License Acquisition. Note that, although
NPI-17 is assumed as the interface for communication be tween IPTV
Applications and IPTV Service Profile, in the case of the managed
network model, NPI-2 and NPI-6 may be used instead. |
2. | Given the Marlin Action Token URL (e.g. embedded into the webpage obtained in step1), the OITF Function (e.g. DAE application) sends the request for the License Acquisition Action Token to the IPTV Applications by UNIS-6. |
3. | When receiving the request from the OITF Function, the IPTV Applications sends a request to the IPTV Service Profile function by NPI-17 to get the information necessary to generate the License Acquisition Action Token. |
4. | Receiving the request from IPTV Applications, the IPTV Service Profile function sends Business Token and user information to IPTV Applications. This user information for License Acquisition also indicates “Bound to Node” of the Marlin License. |
5. | Given the information from the IPTV Applications, the CSP-T Server correlates the Business Token with the “Bound to Node” so that the CSP-T Server can check the information in a (Marlin License Acquisition Protocol) request. |
6. | IPTV Applications sends the License Acquisition Action Token to the OITF Function by UNIS-6. |
7. | Given the License Acquisition Action Token, the OITF Function sends it to the CSP by CSP-1. |
8. | When the CSP does not have a corresponding Marlin Configuration Token, the CSP obtains the Marlin Configuration Token from the CSP-T Server by referring to the URL specified in the License Acquisition Action Token. |
9. | Given the License Acquisition Action Token, the CSP sends a (Marlin License Acquisition Protocol) request to the CSP-T Server by UNIS-CSP-T. |
10. | To check the request from the CSP, when the request includes the correct combination of Business Token and “Bound to Node”, the CSP-T Server sends a Business Token to the IPTV Service Profile function by NPI-CSPT1a. |
11. | The IPTV Service Profile function validates the data
received from the CSP-T Server. If validation fails, an error is
returned to the CSP-T Server. If validation succeeds, the IPTV Service
Profile function returns to CSP-T Server the data necessary to generate
the Marlin License, consisting at a minimum of:
|
12. | To get the corresponding Content Key, the CSP-T Server sends the M-CID to the CSKMF by NPI-CSPT3. |
13. | When receiving the information, the CSKMF looks for
the corresponding Content Key (*) by M-CID, and then sends the Content
Key (*) and M-CID to the CSP-T Server by NPI-CSPT3. *
When the content is protected by Scramble Key and Service Key (or
Program Key), the Service Key (or Program Key) is provided from CSKMF to
CSP-T Server instead of Content Key. See section 4.1.3, for a brief explanation of such encryption scheme. |
14. | The CSP-T Server sends a Marlin (License) response message to the CSP. This response includes either the License correlated to the Business Token sent in the original CSP request, or an error message as defined in [MRL-BNSP]. |
Protected content usages include: playback, recording, time shifting.
Protected content can be played from a native application or from a DAE application using A/V Control or video/broadcast object as defined in [OIPF_DAE2]
Protected content can be time-shifted from a native application or from a DAE application using video/broadcast object as defined in [OIPF_DAE2]
Protected content can be recorded from a native application or from a DAE application video/broadcast object as defined in [OIPF_DAE2]
CSP shall control protected content usages as defined in [MRL-BNSP] for License evaluation, [MRL-MS3] for evaluation of Stream Access Statements, and [MRL-BBTS] for ECM control. See also section 4.1.3 for an overview.
If usages are not allowed, CSP shall block the consumption of program (i.e. stop descrambling) and shall generate the appropriate event (no rights, parental control locking) to the calling application, i.e. native application or DAE object. The DAE A/V Control or video/broadcast object shall trigger the event to the calling DAE application as specified in 4.1.1.3.
For MPEG-2 TS, usages shall be controlled at each ECM change. For other file formats, usages are controlled only when requesting the usage.
This section describes the informative overview of how Marlin data objects acquired via Marlin Protocols are used for consumption of protected contents, such as rendering or exporting.
Figure 6 shows the message flow of License Evaluation.
In order to gain access to a protected content, steps below are performed:
1. | OITF Function such as DAE triggers the
evaluation of a corresponding Marlin License at CSP via Stream Session
Management and Control by providing following information:
Note that, although DAE is used as a function to
trigger the License Evaluation, this is only for illustrative purposes
and other OITF function can be used, such as OITF embedded application
depending on the design of the OITF.
|
2. | The Marlin Client Function in CSP is required to check the following:
|
3. | The Stream Session Management sends the received Content, Content Key and attached usage information, to the Decrypt function. |
Figure 7 shows the message flow of License Evaluation with Scramble Key Decryption.
When the content is encrypted by Scramble Key, License Evaluation and Scramble Key Decryption sequence below is followed:
1. | OITF Function such as DAE triggers the
evaluation of a corresponding Marlin License at CSP via Stream Session
Management and Control by providing following information: Note
that, although DAE is used as a function to trigger the License
Evaluation, this is only for illustrative purposes and can be performed
by another OITF function, such as OITF embedded application, depending
on the design of the OITF.
|
2. | The Marlin Client Function in CSP is required to check the following:
|
3. | If the license evaluation succeeds, the CSP returns attached usage information such as Output Control Information (if any) to the Stream Session Management and Control. Otherwise, the CSP responds with an error. |
4. | The Stream Session Management and Control provides an ECM to the CSP. The ECM includes a Scramble Key encrypted by a Service or Program key and attached ECM information including the Encryption Algorithm Type, Parental Control Information, recording control Information and Output Control Information. |
5. | The CSP checks the ECM on integrity. If this is OK, the CSP decrypts encrypted Scramble Key with the appropriate key, and, based on the combined Output Control Information in the ECM and license, the CSP determines updated Output Control Information as specified in [MRL-BBTS]. |
6. | The CSP sends Scramble Key and attached usage and ECM information to the Stream Session Management and Control. |
7. | The Stream Session Management sends the received Content, Scramble Key and attached usage and ECM information to the Decrypt. |
Note that the sequence assumes that Stream Session Management and Control is trusted by the CSP and that the Scramble Key, permission to perform the requested operation and attached usage information are transferred over a secure channel.
This section contains an informative overview of Content Encryption to clarify sequences related to Content Key, Service or Program key, and Scramble Key in section 4.1.1.4.3 and 4.1.2.1.
Figure 8, Figure 9 and Figure 10 show the message flows of Content Encryption.
When (P)DCF [OMARLIN] or Marlin IPMP [MRL-FF] Content On Demand is encrypted using Content Key, the following steps are performed in Content Encryption sequence:
1. | The Content on Demand Management requests for a content specified by M-CID (Marlin Content ID), the Content Key to use. |
2. | The Content and Service Key Management function returns the Content Key. |
3. | The Content on Demand Encryption Management Function launches encryption of the content in the clear using the M-CID (Marlin Content ID) and Content Key. The protected content is generated. |
4. | The Content on Demand Management stores the protected content in the Content Storage. |
When MPEG-2 TS Content on Demand is encrypted using Content Key, the following steps are performed in Content Encryption Sequence:
1. | The Content on Demand Management requests for the content item specified by M-CID (Marlin Content ID), the Content Key and ECM attached information, including the Encryption Algorithm, Parental Control Information and Output Control Information, to use. |
2. | The Content and Service Key Management function returns the Content Key and ECM attached information. |
3. | The Content on Demand Encryption Management Function launches encryption of the content in the clear. Scramble Keys are generated and the content is encrypted using these Scramble Keys. The Scramble Keys are encrypted using the Content Key. ECMs that include Scramble Keys and provided ECM attached information are inserted into the protected content. |
4. | The Content on Demand Encryption Management Function stores the protected content in the Content Storage. |
When MPEG-2 TS Scheduled Content is encrypted by Scramble Keys then the Scramble Keys are encrypted by a Service or Program key, the following steps are performed in Content Encryption Sequence:
1. | The Content and Service Key Management function sends the M-CID (Marlin Content ID), Service key and possibly a Program key, ECM attached information including Encryption Algorithm, Parental Control Information and Output Control Information to the Multicast Content Delivery Function. |
2. | The Multicast Content Delivery Function generates Scramble Keys and then encrypts clear content using these Scramble Keys. Then the Multicast Content Delivery Function encrypts the Scramble Keys using the Service Key or Program Key. When the Program Key is used for encryption of Scramble Keys, the Multicast Content Delivery Function encrypts the Program Key using the Service Key. An ECM that includes the encrypted Scramble Keys and provided ECM attached information is inserted into the protected content. |
3. | Protected scheduled content is sent to the Transport Processing Function through UNIT-17M. |
The protected file formats supported in the present specification are:
NOTE: this section lists four different protected file formats supported by this specification. The criteria that determine under which circumstances which one or more of these is implemented are out of the scope of the present document.
If the OITF supports the unprotected MPEG-2 TS format, the OITF shall support the Marlin protected MPEG-2 TS format, as defined in this section and its sub-sections. Otherwise, the support of the Marlin protected MPEG-2 TS format as defined in this section and its sub-sections is optional.
If the OITF supports the unprotected time stamped MPEG-2 TS format, the OITF shall support the Marlin protected time stamped MPEG-2 TS format, as defined in this section and its sub-sections. Otherwise, the support of the Marlin protected time stamped MPEG-2 TS format as defined in this section and its sub-sections is optional.
Transport of conditional access messages in MPEG-2 TS is defined by DVB. CA_descriptors (Conditional access descriptor) are used to signal the presence of conditional access information in the stream. Conditional access messages are transported in short MPEG-2 TS private section (section_syntax_indicator = 0). Two types of messages are considered:
This specification uses Marlin to protect MPEG-2 Transport Streams and time stamped Transport Streams as specified in [MRL-BBTS]. If an OITF supports Marlin protected MPEG-2 TS, the OITF shall implement the functions of the DRM Client as specified in [MRL-BBTS]. For Marlin protected MPEG-2 TS the Content Delivery function shall deliver Transport Streams or Time-stamped Transport Streams that are formatted as specified in [MRL-BBTS].
If an OITF supports Marlin protected MPEG-2 TS, the OITF shall support the Parental_rating access_criteria_descriptor as specified in [IEC62455], the recording control access_criteria_descriptor as specified in section 4.1.5.2 and shall support at least the rating_type 0 in these criteria, which maps to the parental rating system in DVB Systems [DVBSI].
For the recording control, refer also to section 4.1.5.2, the OITF shall compare the required operation with the allowed operations (PVR and time shifting) in the recording control criteria and refuse the requested operation to the calling application (native or DAE) if the requested operation is not allowed.
For the parental rating control, the OITF shall compare the program's rating from the parental rating access_criteria_descriptor with the current parental rating criterion set in the OITF by the application (either native application or DAE) and shall block the consumption of programme (i.e. stop descrambling), if the parental rating system is supported by the OITF and the programme’s rating does not meet the parental rating criterion (e.g. rating is at or above a certain threshold, for a rating system that is ordered from lower viewer age to higher viewer age). The OITF shall raise an event to the application controlling the playback or other operation, whenever a parental rating is discovered for the A/V content that does not meet the parental rating criterion that is set for the parental system in use, which has lead to blocking of the consumption of the content. The event shall provide the programme's rating. In case the application is a native application and if the MPEG-2 TS stream provides a Parental Control URL, as defined in section 0, the native application should launch the DAE with the Parental Control URL for management of parental control. In case the application is a DAE application, the event is called onParentalRatingChange and is defined in sections 7.13.5 and 7.14.5 of [OIPF_DAE2].
If the OITF does not support the particular parental rating system used in the program, the OITF shall raise an event to the application controlling the playback or other operation. The event shall provide the programme's rating. In case the application is a DAE application, the event is called onParentalRatingError and is defined in sections 7.13.5 and 7.14.5 of [OIPF_DAE2]. The event may be managed via the DAE application (see section 4.5 of [OIPF_DAE2] for more information). In case the application is a native application, the event is managed through an OITF vendor dependent user interface. In both cases, consumption may be unblocked by setting a new parental rating threshold. This threshold setting is usually restricted to privileged users, e.g. parents and a successful PIN input by a user may be used to control the parental rating threshold setting. The OITF should continue monitoring the MPEG-2 TS, taking into account parental rating criteria changes in ECM streams or new settings for the parental rating threshold in the OITF, and shall unblock consumption (i.e. re-start descrambling) if the current programme's rating becomes lower than the current parental rating threshold.
When no valid rights are available for the MPEG-2 TS, the OITF shall block the consumption of the programme (i.e. stop descrambling) and shall raise an event to the application controlling the playback or other operation. In case the application is a DAE application, the event is called onDRMRightsError and is defined in sections 7.13.6 and 7.14.6 of [OIPF_DAE2]. The OITF should continue monitoring the MPEG-2 TS, taking into account criteria changes in ECM streams or rights changes in OITF and shall unblock consumption (i.e. re-starting descrambling) if there are valid rights for the requested operation.
For the avoidance of doubt, the OITF shall support the presence of descriptors (for a general description of descriptors, see [MPEG2TS] which are not defined in this specification) but shall ignore these descriptors. In particular, to allow DVB-SimulCrypt with other CA systems as defined in [DVB-SC] and gateway-centric approach, the presence of following descriptors shall be supported: CA descriptor for other CA systems than Marlin and than CA systems supported in a CSPG, scrambling descriptor [DVBSI], and copyright descriptor [MPEG2TS].
recording control information access_criteria_descriptor | Tag | Length (in bits) | Type |
---|---|---|---|
recording_control_information_byte | 0x10 | 8 | bslbf |
Bit # | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
---|---|---|---|---|---|---|---|---|
Assignment | rsvd | rsvd | rsvd | rsvd | rsvd | rsvd | DNTS | DNR |
The DNR (Do Not Record) bit signals that a BBTS is not allowed to be stored for PVR function. The OITF shall not store for PVR function the TS packets of a BBTS that are received after receipt of a BBTS packet carrying an IEC62455 ECM that includes a recording control access_criteria_descriptor in which the DNR bit is set to 1.
The OITF may store for PVR function the TS packets of a BBTS that are received after receipt of a BBTS packet carrying an IEC62455 ECM that does not include a recording control access_criteria_descriptor or does include a recording control access criteria in which the DNR bit is set to 0.
The DNTS (Do Not Time Shift) bit signals that a BBTS is not allowed to be stored for time shifting. The OITF shall not store for time shifting the TS packets of a BBTS that are received after receipt of a BBTS packet carrying an IEC62455 ECM that includes a recording control access_criteria_descriptor in which the DNTS bit is set to 1.
The OITF may store for time shifting the TS packets of a BBTS that are received after receipt of a BBTS packet carrying an IEC62455 ECM that does not include a recording control access_criteria_descriptor or does include a recording control access criteria in which the DNTS bit is set to 0.
The time shifting period shall not exceed 90 minutes in case the DNR bit is set to 1 and the DNTS bit is set to 0.
The combination of DNR equals 0 (PVR allowed) and DNTS equals 1 (time shift not allowed) should not be set.
For an overview of the combinations, see Table 3.
DNR | DNTS | Description |
---|---|---|
0 | 0 | Time shifting allowed for infinite period; PVR allowed |
0 | 1 | should not occur |
1 | 0 | Time shift limited to 90 minutes; PVR NOT allowed |
1 | 1 | Time shift NOT allowed; PVR NOT allowed |
When creating transport streams that are formatted as specified in [MRL-BBTS], the Content Delivery shall include a BBTS CA_descriptor [MRL-BBTS] in each PMT pointing to a stream protected by Marlin and shall include the serviceBaseCID, see [MRL-BBTS], into the BBTS CA_descriptor. The socID [MRL-BBTS] used by the Content Delivery shall be “marlin” (without the double quotes).
In case DVB-SimulCrypt is used with other CA systems as defined in [DVB-SC] and/or with the gateway-centric approach then the content_key_index field in the IEC62455 ECM as defined in [MRL-BBTS] shall match the scrambling_mode of the other CA system. If the cipher_mode field is 0x1 (CBC) then the initial_vector and next_initial_vector fields in the IEC62455 ECM shall be set to 0 as specified in [ATIS-IDSA].
When creating transport streams that are formatted as specified in [MRL-BBTS], the Content Delivery function may include a BBTS CA_descriptor [MRL-BBTS] in the CAT for streams protected by Marlin, in order to provide Marlin Rights URLs. If several Marlin Rights URL sets are provided for different service operators, the Content Delivery shall include several BBTS CA_descriptor and each BBTS CA_descriptor shall include a different serviceBaseCID.
The Rights Issuer URL section, defined in [MRL-BBTS] may contain a Parental Control URL, as defined in this section. Use of the Parental Control URL is described in section 4.1.5.1.
The coding of the Parental Control URL parameter in the TLV format is the following:
Syntax | Mnemonic | No. of bits |
---|---|---|
Parental_Control_URL () { | ||
Parental_Control_URL_tag = 0x05 | uimsbf | 8 |
Parental_Control_URL_length | uimsbf | 8 |
For (i=0; i<N; i++){ | ||
Parental_Control_URL_data_byte | bslbf | 8 |
} | ||
} |
Parental_Control_URL_tag | This specification has defined the value of 0x05 for the Parental Control URL parameter. |
Parental_Control_URL_length | Specifies the length of the Parental_Control_URL_data_byte in bytes (N). |
Parental_Control_URL_data_byte | The Parental Control URL for this content. |
NOTE: The syntax of Table 4 and similar tables in subsequent sections follows conventions outlined in [MPEG2TS] (e.g. mnemonics, use of C-language like loop descriptors).
Before accessing the Rights Issuer URL specified in [MRL-BBTS], the OITF, or the DAE application that receives an “onDRMRightsError” event as defined in sections 7.13.6 and 7.14.6 of [OIPF_DAE2], shall obtain user consent to access the web page. When a service receives an HTTP request to the Rights Issuer URL, the service should respond with an HTML page and not with a Marlin Action Token or with a Marlin License. This HTML shall comply with CE-HTML. After user interaction via the HTML pages, the service may return a Marlin Action Token or Marlin License.
Before accessing the Parental Control URL specified in this section, OITF shall obtain user consent to access the web page. When receiving an HTTP request to the Parental Control URL, the service should respond with an HTML page This HTML shall comply with CE-HTML.
In the scope of this specification, DTCP and HDCP System Renewability Messages (SRM) can be transported in a Marlin protected MPEG-2 TS. The signalling and transport of SRM in Marlin protected MPEG-2 TS shall comply with [DVB-SRM] specification.
If an OITF supports HDCP output and receives Marlin protected MPEG2-TS format, the OITF shall detect the presence of HDCP System Renewability Messages and install them, as defined in [HDCP].
If an OITF supports DTCP output and receives Marlin protected MPEG2-TS format, the OITF shall detect the presence of DTCP System Renewability Messages and install them, as defined in [DTCP].
This section specifies the operation of Marlin technologies to support certain type of use cases.
A usage rule which uses status information (such as count) is supported in the Marlin License (e.g. burn usage rule by allowing Export action to a certain target system). When the Marlin License requires status management in the client, the corresponding Marlin License should also have a ‘not after’ condition specified in the absolute validity period. The value specified by ‘not after’ should be no later than 1 month from the issuance of the Marlin License. For example, when the Marlin License issued on 24 November 2008 00:00 allows 3 times burn to Blu-ray, this Marlin License should only be valid until 24 December 2008 00:00.
A CSP function that implements this specification must support BNS Extended Topology for Subscription Nodes as defined in [MRL-BNSP]. It means that CSP must support following Marlin Protocols for Subscription Node which are originally defined as optional functions in [MRL-BNSP]:
The CSP must signal this support of the BNS Extended Topology by using the mechanism defined in [MRL-BNSP], section 6.2.
DRMSystemID, used to signal the type of DRM, is defined in [OIPF_META2]. DRMSystemID is used in metadata structures, defined in [OIPF_META2], in APIs defined in [OIPF_DAE2] and in protocols defined in [OIPF_PROT2]. For Marlin, since the DVB CA_System_ID is assigned as 0x4AF4, the value for the DRMSystemID to signal Marlin shall be set to the following value: “urn:dvb:casystemid:19188”. In addition to the DRMSystemID “urn:dvb:casystemid:19188” signaling Marlin, URN “urn:marlin:ms3:1-0” defined in [MRL-MS3] section 1.3.1 may be used as a second DRMSystemID to signal that Marlin Simple Secure Streaming feature is supported.
A DRM Control Information structure to hold DRM dependant control parameters is defined in [OIPF_META2] as an extended element included in Content Access Descriptor, defined in [OIPF_DAE2] and extension of PurchaseItem element of BCG and SD&S metadata, defined in [OIPF_META2]. For Marlin protected content, the element of DRMControlInformation shall be mapped as specified in the following table:
Element / Attribute Name | Element / Attribute Mapping for Marlin |
---|---|
DRMControlInformation | |
DRMSystemID | shall be set to the value defined for the Marlin System ID, in section 4.1.7.1. |
DRMContentID | shall be set Marlin Content ID. For Marlin protected MPEG-2 TS or timespamped MPEG2-TS, the content ID is derived from the socID; together with serviceBaseCID as defined in [MRL-BBTS]. |
RightsIssuerURL | should be set to the RightsIssuerURL present in Marlin protected content formats, defined in section 4.1.4 and 4.1.5. |
SilentRightsURL | should be set to the SilentRightsURL present in Marlin protected content formats, defined in section 4.1.4 and 4.1.5. When accessing to this SilentRightsURL, Marlin Action Token or MIPPVControlMessage may be returned. |
PreviewRightsURL | should be set to the PreviewRightsURL present in Marlin protected content formats, defined in section 4.1.4 and 4.1.5. |
DoNotRecord | should be set to the same value as the DNR (Do Not Record) bit in recording control access criteria defined in section 4.1.5.2. |
DoNotTimeShift | should be set to the same value as the DNTS (Do Not Time Shift) bit in recording control access criteria defined in section 4.1.5.2. |
DRMGenericData | Placeholder element for which currently no mapping is defined. |
DRMPrivateData | DRMPrivateData shall be an instance of a MarlinPrivateDataType structure, see section B.1. |
mimeType | shall be set to the mime type of the DRMPrivateData. For Marlin, it shall therefore be set to MIME type of a Marlin License, see [MRL-BNSP] or to the MIME type of a Marlin Token, see [MRL-BNSP]. |
If Marlin Simple Secure Streaming feature is supported, in addition to the DRMControlInformation structure given in Table 5, an second DRM Control Information structure may be present with parameters mapped as specified in the following table:
Element / Attribute Name | Element / Attribute Mapping for Marlin |
---|---|
DRMControlInformation | |
DRMSystemID | shall be set to the value defined for the Marlin Simple Secure Streaming feature, in section 4.1.7.1. |
DRMContentID | shall be set Marlin Content ID. In case of scheduled content over IP, the content ID is derived from the socID; together with serviceBaseCID as defined in [MRL-BBTS]. |
RightsIssuerURL | Placeholder element for which currently no mapping is defined. |
SilentRightsURL | Placeholder element for which currently no mapping is defined. |
PreviewRightsURL | Placeholder element for which currently no mapping is defined. |
DoNotRecord | should be set to the same value as the DNR (Do Not Record) bit in recording control access criteria defined in section 4.1.5.2. |
DoNotTimeShift | should be set to the same value as the DNTS (Do Not Time Shift) bit in recording control access criteria defined in section 4.1.5.2. |
DRMGenericData | Placeholder element for which currently no mapping is defined. |
DRMPrivateData | DRMPrivateData shall be an instance of a MarlinPrivateDataType structure, see section B.1. |
mimeType | shall be set to the mime type of the DRMPrivateData. For Marlin Simple Secure Streaming feature, it shall be set to MIME type of a Marlin Token, [MRL-MS3]. |
Both MarlinPrivateDataType and HexBinaryPrivateDataType extend DRMPrivateDataType, defined in [OIPF_META2]; and so the element DRMPrivateData can be substituted by either MarlinPrivateData or HexBinaryPrivateData as defined below:
The XML schema for the MarlinPrivateDataType is defined in section B.1.
Element / Attribute Name | Element / Attribute Description |
---|---|
MarlinPrivateData | |
MarlinLicense | A Base64 encoded XML Document containing an instance of a Marlin License, typically used for channel preview. |
MarlinToken | A Base64 encoded XML Document containing an instance of a Marlin Token, to be used for triggering Marlin Protocol. |
The CSP shall support receiving the following messages via the sendDRMMessage API defined in [OIPF_DAE2], section 7.6.1.
For these messages, the DRMSystemID shall be set to the value defined for the Marlin System ID in section 4.1.7.1.
This section describes the usage of MIPPVControlMessage, which is used for pay per view case, and defines the message structure of MIPPVControlMessage. MIPPVControlMessage is used in a pay per view use case where a large number of users try to acquire Marlin License just before a pay per view program begins. To avoid such simultaneous accesses to CSP-T (DRM Server), a service can apply MIPPVControlMessage which includes common Marlin License (i.e. common for OITFs), Marlin Action Token, and Marlin License acquisition timing information. These three data items are used as follows in a typical pay per view case:
The MIPPVControlMessage includes Marlin License, which is common among clients, Marlin Action Token, which is used to acquire the unique Marlin License, and timing information, which indicates the timing to initiate Marlin License Acquisition protocols.
The XML schema for the MIPPVControlMessage is defined in section B.2.
Each element has the following semantics:
Element / Attribute Name | Element / Attribute Description |
---|---|
MIPPVControlMessage | |
MarlinLicense | A Base64 encoded XML Document containing an instance of a Marlin License. |
MarlinActionToken | A Base64 encoded XML Document containing an instance of a Marlin Action Token. |
absoluteAcquisitionTiming | License acquisition timing in absolute time |
relativeAcquisitionTiming | License acquisition timing in relative time from the start of the content |
MIME type of MIPPVControlMessage is defined as follows:
application/vnd.oipf.mippvcontrolmessage+xml
DAE shall signal which CA_System_ID values [MPEG2TS] and optionally the type of CSP Gateway are supported in the OITF including those available via Gateway-Centric Approach as defined in section 9 of [OIPF_DAE2] document.
The list of supported CA_System_ID values and optionally the type of CSP Gateway shall also be retrieved by the Service Platform provider using one of the following methods:
When a DAE application uses the DRM Agent API and event, sendDRMMessage and onDRMMessageResult, defined in [OIPF_DAE2] section 7.6.1, to handle a DRM Message (see section 7.6.1 in [OIPF_DAE2]) for a given CA_System_ID that is supported by a CSPG, the OITF shall forward these messages to the appropriate function, CSP or CSPG.
When protected content is used (played, time-shifted, recorded) from a DAE application, the OITF shall forward events (no rights or parental control locking) from the CSPG to the DAE application via the A/V Control or video/broadcast object. The DRM events onDRMRightsError, onParentalRatingChange and onParentalRatingError are defined in [OIPF_DAE2] sections 7.13.5, 7.13.6, 7.14.5 and 7.14.6. The DRM events (no rights or parental control locking) shall include the CA_System_ID information.
All normative statements in this section and its sub-sections apply only in case the CI+ based Gateway-Centric Approach is supported.
NOTE: The criteria that determine under which circumstances the CI+ based Gateway-Centric Approach is implemented are out of the scope of the present document.
The CSPG-CI+ is an optional entity handling security for the OITF. It shall make any specific content protection solution transparent to the OITF. This is achieved by the use of a standard secure channel between the OITF and the CSPG-CI+. The CSPG-CI+ acts as a bridge between a specific protection solution and one standard secure channel. Once the OITF and the CSPG-CI+ are mutually authenticated, the OITF is seamlessly able to receive any content that was initially secured by the different content protection solutions that the CSPG-CI+ handles. The incoming stream to the CSPG-CI+ is associated with the generic media format label “PF”, as defined in [OIPF_MEDIA2].
The protected content stream is sent from the OITF to the CSPG-CI+ and then sent back to the OITF protected in such a way that only authenticated OITF can gain access to it. Incoming and outgoing streams format are based on MPEG-2 Transport Stream. Protected file formats based on MP4 file format (i.e. OMA (P)DCF and Marlin IPMP) are not supported.
The definition of the interfaces is based on the DVB CI specification ([DVB-CI]) and the CI+ specification ([CI+]).
Figure 14 presents an overview of the functions and interfaces of the CSPG-CI+.
In order to provide seamless behaviour to the end user (e.g. for service selection operation), the incoming stream in Figure 14 must be delivered through the UNIT-17 reference point as for the Terminal-Centric Approach. Figure 15 describes CSPG-CI+ in the home network context and maps interfaces from Figure 14 to Home Network interfaces defined in [OIPF_ARCH2].
The OITF and CSPG-CI+ shall comply with CI+ specifications ([CI+]).
The physical interface is based on a PCMCIA slot as specified by the DVB-CI specification ([DVB-CI]) and the CI+ specification ([CI+]).
The CSPG-CI+ discovery shall be performed at OITF start-up and CSPG-CI+ initialization. The setup of the session to the [CI+] Specific Application Support (SAS) resource and the connection to the Open IPTV Forum private application are described in section 4.2.3.4.1.1. A successful connection means that a CSPG-CI+ has been discovered.
HNI-CSP is an interface to exchange control information and media between the CSPG-CI+ and the OITF.
OITF controls the CSPG-CI+ using resources defined in [DVB-CI] as well as resources as defined in section 11 of [CI+].
OITF and CSPG-CI+ shall use the SAS resource, defined in [CI+], section 11.4, to handle messages as specified in this section.
The OITF shall send a SAS_connect_rqst() APDU [CI+] to the CSPG-CI+ with the specific Open IPTV Forum private_host_application_ID defined in Table 8. The CSPG-CI+ shall acknowledge the connection by sending back a SAS_connect_cnf() APDU [CI+]. The highest private_host_application_ID value known by the host shall be tried first. If the SAS_session_status returned by the SAS_connect_cnf() APDU is not 0x00 (“Connection established”) then a lower value shall be tried and so on until success.
private_host_application_ID | Value (64bits) |
---|---|
OIPF_APPLICATION_ID for version up to V2.2 included | 0x0108113101190000 |
OIPF_APPLICATION_ID for version above V2.2 | 0x0108113101190001 |
Syntax | No. of Bits | Mnemonic |
---|---|---|
SAS_async_msg() { | ||
SAS_async_msg_tag | 24 | uimsbf |
length_field() | ||
message_nb | 8 | uimsbf |
message_length | 16 | uimsbf |
for (i=0; i<message_length; i++) { | ||
message_byte | 8 | uimsbf |
} | ||
} |
The OITF and CSPG-CI+ shall support the messages listed in Table 11. For each of the messages the message_byte payload takes the generic syntax given in Table 10. The message data may be broken into a number of records containing the same or different types of data identified by the datatype_id.
Syntax | No. of Bits | Mnemonic |
---|---|---|
message_byte() { | ||
command_id | 8 | uimsbf |
ca_system_id | 16 | uimsbf |
transaction_id | 32 | uimsbf |
send_datatype_nbr | 8 | uimsbf |
for (i=0; i<send_datatype_nbr; i++) { | ||
datatype_id | 8 | uimsbf |
datatype_length | 16 | uimsbf |
data_type() | 8 * datatype_length | bslbf |
} | ||
} |
command_id | 8-bit value that identifies the message. The values are defined in Table 11. |
ca_system_id | 16-bit integer that identifies the CA system being queried. |
transaction_id | A 32-bit value, generated by the OITF, provided in a message to the CSPG-CI+ that will be returned in any corresponding reply message from the CSPG-CI+. The transaction_id allows the OITF to match the CSPG-CI+’s replies with the corresponding requests. The OITF should increment the value, modulo 232, with every message it sends. The transaction_id should be ignored in messages sent spontaneously (events) by the CSPG-CI+ (i.e. rights_info, parental_control_info, system_info). |
send_datatype_nbr | 8-bit integer that gives the number of data type items included in the message. |
datatype_id | 8-bit integer that identifies the type of the data contained in the data type loop. The values are defined in Table 12. |
datatype_length | 16-bit integer that gives the length of the data_type() field in bytes. |
data_type | Data type payload. The data type loop shall only contain the specified data type, but may contain multiple records of the same type, the number of records may be determined by computation of the datatype_length field. |
Message | command_id value (hexadecimal) | Direction | |
---|---|---|---|
OITF | CSPG-CI+ | ||
send_msg | 0x01 | → | |
reply_msg | 0x02 | ← | |
parental_control_info | 0x03 | ← | |
rights_info | 0x04 | ← | |
system_info | 0x05 | ← | |
can_play_content_req | 0x06 | → | |
can_play_content_reply | 0x07 | ← | |
can_record_content_req | 0x08 | → | |
can_record_content_reply | 0x09 | ← | |
(reserved) | 0x0A-0x7F | ||
(user defined) | 0x80-0xFF |
Data type | datatype_id value (hexadecimal) |
---|---|
oipf_ca_vendor_specific_information | 0x01 |
oipf_country_code | 0x02 |
oipf_parental_control_url | 0x03 |
oipf_rating_type | 0x04 |
oipf_rating_value | 0x05 |
oipf_rights_issuer_url | 0x06 |
oipf_access_status | 0x07 |
oipf_status | 0x08 |
oipf_drm_private_data | 0x09 |
oipf_can_play_status | 0x0A |
oipf_can_record_status | 0x0B |
(reserved) | 0x0C-0x7F |
(user defined) | 0x80-0xFF |
The OITF shall map the specific messages listed in Table 11 to DAE API or Events as described in Table 13:
Message | DAE API or Event |
---|---|
send_msg | sendDRMMessage |
reply_msg | onDRMMessageResult |
parental_control_info | onParentalRatingChange, onParentalRatingError |
rights_info | onDRMRightsError |
system_info | onDRMSystemMessage |
can_play_content_req | canPlayContent |
can_play_content_reply | canPlayContent |
can_record_content_req | canRecordContent |
can_record_content_reply | canRecordContent |
The DRMSystemID attribute in DAE API or Events are mapped to the ca_system_id field in the SAS_async_msg APDU. The ca_system_id field is filled by extracting the numeric value from the DRMSystemID string, such that "urn:dvb:casystemid:" is removed and the remaining number is converted from a string to a 16 bit integer. The DRMSystemId is build by prefixing the 16 bit integer converted to a decimal number string with "urn:dvb:casystemid:" as described in [OIPF_META2].
Private data are array of bytes encoded for DAE API or Events attributes in a string using a hexadecimal representation, as defined for xs:hexBinary type used in XML schemas. In CI+ SAS_async_msg fields, the private data is encoded in bytes.
Precise mapping of DAE API or Events and attributes are described in the following sections.
A native application or DAE application should use the send_msg message to provide DRM specific messages to the CSPG-CI+.
When requested by either a native or DAE application, the OITF shall send the send_msg message to the CSPG-CI+ to exchange DRM messages.
Examples of usage are:
The data types for the send_msg message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_ca_vendor_specific_information | 1 |
oipf_ca_vendor_specific_information | Vendor specific information. The maximum length is 65000 bytes. |
When a DAE application calls the sendDRMMessage API with msgType set to the MIME type "application/vnd.oipf.cspg hexbinary" and a DRMSystemId set to a ca system id supported by the CSPG-CI+, the OITF shall send a send_msg message to the CSPG-CI+.
The prototype of the sendDRMMessage API defined in [OIPF_DAE2] is recalled here:
String sendDRMMessage( String msgType, String msg, String DRMSystemID )
The OITF shall map the attributes of the called DAE API as follows:
The CSPG-CI+ shall send the reply_msg message to the OITF to provide the status of the send_msg message.
The data types for the reply _msg message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_status | 1 |
oipf_ca_vendor_specific_information | 0..1 |
oipf_status | If equal to 0, the send_msg message has been successfully handled by the CSPG-CI+ and a oipf_ca_vendor_specific_information may be available. If equal to 1, the send_msg message failed because an unspecified error occurred. If equal to 2, the send_msg message failed because the CSPG-CI+ was unable to complete the necessary computations in the time allotted. If equal to 3, the send_msg message failed because oipf_ca_vendor_specific_information has a wrong format. If equal to 4, the send_msg message failed because user consent is needed for that action. If equal to 5, the send_msg message failed because the specified CA system in ca_system_id is unknown. Unspecified status values should be considered as 1, message failed because an unspecified error occurs. |
oipf_ca_vendor_specific_information | Vendor specific information. The maximum length is 65000 bytes. |
NOTE: A service provider should not provide a DRM Message in metadata (BCG, SD&S, CAD) and expect a response in oipf_ca_vendor_specific_information of reply_msg message, if these metadata are handled by a native application. The native application sending the DRM message to the CSPG-CI+ will not know how to handle a response.
When receiving a reply_msg message with a transaction_id mapping to a send_msg message issued from a DAE application call to sendDRMMessage, the OITF shall issue an onDRMMessageResult event to the DAE application
The prototype of the onDRMMessageResult event defined in [OIPF_DAE2] is recalled here:
function onDRMMessageResult( String msgID, String resultMsg, Integer resultCode )
The OITF shall set the attributes of the issued DAE event as follows:
oipf_status field | Description | resultCode attribute | Description |
---|---|---|---|
0 | Successful | 0 | Successful |
1 | Unspecified error | 1 | Unknown error |
2 | Out of time | 2 | Cannot process request |
3 | Wrong format | 3 | Wrong format |
4 | User Consent Needed | 4 | User Consent Needed |
5 | Unknown DRM system | 5 | Unknown DRM system |
The CSPG-CI+ shall send a parental_control_info message to advise the OITF whenever the selected program’s rating changes. If the new rating does not meet the parental rating criterion (e.g. rating is at or above a certain threshold, for a rating system that is ordered from lower viewer age to higher viewer age), the program is not descrambled anymore . If the new rating meets the parental rating criterion (e.g. rating is under a certain threshold, for a rating system that is ordered from lower viewer age to higher viewer age), the program is descrambled again.
The data types for the parental_control_info message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_access_status | 1 |
oipf_rating_type | 1 |
oipf_rating_value | 1 |
oipf_country_code | 0..n |
oipf_parental_control_url | 0..1 |
oipf_access_status | If equal to 0, the program is
no longer being descrambled, access conditions to the program are no
longer being met. A oipf_parental_control_url may be provided. If equal to 1, the program is descrambled again. |
oipf_rating_type | Rating_type as defined in the parental_rating access_criteria_descriptor in [IEC62455]. |
oipf_rating_value | 1-byte rating_value as defined in the parental_rating access_criteria_descriptor in [IEC62455]. |
oipf_country_code | 2-byte optional country_codes as defined in the parental_rating access_criteria_descriptor in [IEC62455]. |
oipf_parental_control_url | Optional url for connecting to the service provider, for unlocking the parental control. |
The OITF shall support at least the parental rating system identified by the oipf_rating_type 0, which maps to the parental rating system in DVB Systems [DVBSI].
If an oipf_parental_control_url is provided and the event is raised to a native application, the native application should launch the DAE with the oipf_parental_control_url that might allow to unlock parental control in the CSPG-CI+.
When the parental_control_info message is received and a DAE application is launched, the OITF shall issue the relevant event to the DAE application:
The prototype of the onParentalRatingChange and onParentalRatingError events defined in [OIPF_DAE2] are recalled here:
function onParentalRatingChange( String contentID, ParentalRatingCollection ratings, String DRMSystemID, Boolean blocked ) function onParentalRatingError( String contentID, ParentalRatingCollection ratings, String DRMSystemID )
The OITF shall set the attributes of the issued event as follows:
oipf_access_status field | Description | Blocked attribute | Description |
---|---|---|---|
0 | program not descrambled | True | Content blocked |
1 | Program descrambled | False | Content not blocked |
A DAE application should use a proprietary method using sendDRMMessage to unlock parental control.
If the program is no longer being descrambled (oipf_access_status=0), the native or DAE application should not stop playing the program, as the program may become descrambled again later (access criteria change, parental unlocking etc).
The CSPG-CI+ shall send a rights_info message to advise the OITF that access conditions or rights changed and that the CSPG-CI+ is no longer able or is able again to descramble all requested elementary streams. Once this message is received and if a DAE application is launched, the OIPF shall send the relevant event onDRMRightsError, as defined in [OIPF_DAE2] sections 7.13.6 and 7.14.6, to the DAE application.
If the program is descrambled again, the OITF should display the program again. If the program is no longer being descrambled, the OITF may decide to stop the program and should use the oipf_rights_issuer_url, which may provide for the CSPG-CI+ information to let it retrieve missing rights.
The data types for the rights_info message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_access_status | 1 |
oipf_rights_issuer_url | 0..1 |
oipf_access_status | If equal to 0, the program is
no longer being descrambled, access conditions to the program are no
longer being met. A oipf_rights_issuer_url may be provided. If equal to 1, the program is descrambled again. |
oipf_rights_issuer_url | Optional url for connecting to the service provider. |
The prototype of the onDRMRightsError event defined in [OIPF_DAE2] is recalled here:
function onDRMRightsError( Integer errorState, String contentID, String DRMSystemID, String rightsIssuerURL )
When the right_info message is received and a DAE application is launched, the OITF shall issue the onDRMRightsError event to the DAE application.
The OITF shall set the attributes of the issued event as follows:
oipf_access_status field | Description | errorState attribute | Description |
---|---|---|---|
0 | program not descrambled | 0 | No license |
1 | Program descrambled | 2 | Valid license |
If the program is no longer being descrambled (oipf_access_status=0), the native or DAE application should not stop playing the program, as the program may become descrambled again later (access criteria change, rights update etc).
The CSPG-CI+ shall send a system_info message to advise the OITF of any DRM related event, e.g. the removal of a smartcard. Once this message is received and if a DAE application is launched, the OIPF shall send the relevant event onDRMSystemMessage, as defined in [OIPF_DAE2] section 7.6.1, to the DAE application.
The data types for the system_info message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_ca_vendor_specific_information | 1 |
oipf_ca_vendor_specific_information | Vendor specific information. The maximum length is 65000 bytes. |
When the system_info message is received and if a DAE application is launched, the OITF shall issue the onDRMSystemMessage event to the DAE application.
The prototype of the onDRMSystemMessage event defined in [OIPF_DAE2] is recalled here:
function onDRMSystemMessage( String DRMSystemID, String msg )
The OITF shall set the attributes of the issued event as follows:
Note: The following messages are only supported for a private_host_application_ID greater or equal to 0x0108113101190001.
When requested by either a native or DAE application, the OITF shall send the can_play_content_req message to the CSPG-CI+ to check the local availability of a valid license for playing a content protected by a DRM integrated in the CSPG-CI+.
The data types for the can_play_content_req message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_drm_private_data | 1 |
oipf_drm_private_data | DRM proprietary private data. The maximum length is 16384 bytes. |
When a DAE application calls the canPlayContent API with a DRMSystemId set to a ca system id supported by the CSPG-CI+, the OITF shall send a can_play_content_req message to the CSPG-CI+ and wait for a can_play_content_reply message from the CSPG-CI+.
The data types for the can_play_content_reply message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_can_play_status | 1 |
oipf_can_play_status | If equal to 1, the CSPG_CI+ has a valid license available that may allow playing the content associated to the DRM metadata. If equal to 0, the CSPG-CI+ has no license available. |
When the CSPG-CI+ receives a can_play_content_req message, then it shall check whether it owns a valid license for playing the protected content which oipf_drm_private_data relates to and reply to the OITF with a can_play_content_reply message with an oipf_can_play_status that indicates whether or not the CSPG-CI+ has a valid license available.
The prototype of the canPlayContent API defined in [OIPF_DAE2] is recalled here:
Boolean canPlayContent( String DRMPrivateData, String DRMSystemID )
The OITF shall map the attributes of the called DAE API as follows:
Note: The following messages are only supported for a private_host_application_ID greater or equal to 0x0108113101190001.
When requested by either a native or DAE application, the OITF shall send the can_record_content_req message to the CSPG-CI+ to check the local availability of a valid license for recording a content protected by a DRM integrated in the CSPG-CI+.
The data types for the can_record_content_req message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_drm_private_data | 1 |
oipf_drm_private_data | DRM proprietary private data. The maximum length is 16384 bytes. |
When a DAE application calls the canRecordContent API with a DRMSystemId set to a ca system id supported by the CSPG-CI+, the OITF shall send a can_record_content_req message to the CSPG-CI+ and wait for a can_record_content_reply message from the CSPG-CI+.
The data types for the can_record_content_reply message are listed in the following table.
Syntax | Occurrence number |
---|---|
oipf_can_record_status | 1 |
oipf_can_record_status | If equal to 1, the CSPG_CI+ has a valid license available that may allow recording the content associated to the DRM metadata. If equal to 0, the CSPG-CI+ has no license available. |
When the CSPG-CI+ receives a can_record_content_req message, then it shall check whether it owns a valid license for recording the protected content which oipf_drm_private_data relates to and reply to the OITF with a can_record_content_reply message with an oipf_can_record_status that indicates whether or not the CSPG-CI+ has a valid license available.
The prototype of the canRecordContent API defined in [OIPF_DAE2] is recalled here:
Boolean canRecordContent( String DRMPrivateData, String DRMSystemID )
The OITF shall map the attributes of the called DAE API as follows:
Media are exchanged as defined in the [CI+] specification.
For streamed content, in either Scheduled Content case or Content on Demand case, the transmission of the protected content from the OITF to the CSPG-CI+ is performed by using MPEG-2 Transport Stream.
For downloaded content, the OITF shall stream the content to the CSPG-CI+ at consumption time.
In case there is an Application Gateway, control flow is handled through the OITF, via HNI-INI-AG and HNI-CSP control channel. The HNI-AGC reference point introduced in [OIPF_ARCH2] is not used.
The scrambler on network side shall have an interface with the CSP-G Server functional entity so that ECMs can be provided during content encryption. This interface is not described in the present specification.
The CSPG-CI+ supports the MPEG-2 Transport Stream format. The CSPG-CI+ supports the MPEG-2 Transport Stream format. The generically protected incoming transport stream to the CSPG-CI+ is associated with the media format label “PF”, as defined in [OIPF_MEDIA2].
The CSPG-CI+ does not support the time stamped MPEG-2 Transport Stream format.
However, in the case content is received by the OITF under a time stamped MPEG-2 Transport Stream format and if the OITF supports the unprotected time stamped MPEG-2 TS format,
If the OITF does not support the unprotected time stamped MPEG-2 TS format, the support of the above two operations is optional.
MPEG-2 Transport Stream can be streamed or downloaded. Based on the CA_descriptor found in the PMT table, the OITF knows if it can handle the stream or if it has to send it to the CSPG-CI+.
If the CA_descriptor found in the PMT is a Marlin CA_descriptor (with CA_system_ID value assigned for Marlin) and the Terminal-Centric Approach is supported by the OITF, then the OITF shall manage the content with CSP function described in section 4.1.
If the CA_descriptor found in the PMT is a Marlin CA_descriptor and the Terminal-Centric Approach is not supported by the OITF, then the OITF shall ignore it unless Marlin is supported by a CSPG-CI+ in which case the OITF shall provide the protected content to the relevant CSPG-CI+.
If the CA_descriptor found in the PMT is not a Marlin CA_descriptor, then the OITF shall compare the CA_system_ID value with the CA_system_ID supported by the CSPG-CI+. A CSPG-CI+ might support more than one CA_system_ID. If a CA_system_ID value matches then the OITF shall provide the protected content to the CSPG-CI+. In case several CSPG-CI+ gateways are connected to the OITF, the OITF shall provide the protected content to only one CSPG-CI+.
If there are several CA_descriptors in the PMT, i.e. referring to different content protection systems (Marlin and/or those offered by the CSPG-CI+ gateways), and if the user is already granted with a valid right or license through one of these content protection systems, the OITF shall select the corresponding content protection system as a priority.
NOTE: If simulcrypting with the Terminal-Centric solution is desired, the algorithm used for content encryption in the Gateway-Centric Approach has to be the same as for the Terminal-Centric Approach.
The scrambling algorithm shall be signalled in the PMT at program loop level by the scrambling_descriptor specified in [DVBSI]. Within the scrambling_descriptor, the algorithm is specified by the scrambling_mode field. The following scrambling_modes are referenced by the Open IPTV Forum:
scrambling_mode | Description |
---|---|
0x01 | DVB-CSA1 |
0x02 | DVB-CSA2 |
0x70 | AES 128-bit key using the Cipher Block Chaining (CBC) encryption mode with the IV setting and the residual termination block process as specified in [ATIS-IDSA]. |
Downloaded content shall be stored locally as it is received by the OITF not going through the CSPG-CI+.
Downloaded content shall be provided to the CSPG-CI+ at consumption time only. Consequently, any conversion from e.g. time stamped MPEG-2 TS as defined in [OIPF_MEDIA2] to TS is performed at consumption time as well.
PVR functionality is supported by using URI (Usage Rule Information) as defined in [CI+], section 5.7.
When the OITF is asked to store content, it shall send the content to CSPG CI+. The content is returned from CSPG-CI+ and recorded in accordance with the URI associated with the content.
Time Shifting functionality is supported by using URI (Usage Rule Information) as defined in [CI+], section 5.7.
When the OITF is asked to time shift content, it shall store the content returned from CSPG-CI+ before rendering in accordance with the URI associated to the content.
As the network offered in the Open IPTV Forum context is a bi-directional communication channel, the optional Registered Service Mode (RSM) in the CI+ specification [CI+] is recommended in the CSP specification. The RSM should be supported by CSPG-CI+.
As no DVB-CI backward compatibility is needed, the OITF shall make the CSPG-CI+ operate in a CI+ mode [CI+] only (thus preventing CSPG-CI+ gateways from operating with the unencrypted DVB-CI link). CI+ Protected Service Signalling defined in section 10.1 of [CI+] is not used.
DRMSystemID, used to signal the type of DRM, is defined in [OIPF_META2]. DRMSystemID is used in metadata structures in APIs defined in [OIPF_DAE2] and in protocols defined in [OIPF_PROT2]. For CSPG-CI+, the DVB CA_System_ID in DRMSystemID shall be the one of the specific content protection solution in the CSPG-CI+.
A DRM Control Information structure to hold DRM dependant control parameters is defined in [OIPF_META2] as an extended element included in Content Access Descriptor, defined in [OIPF_DAE2] and extension of PurchaseItem element of BCG and SD&S metadata, defined in [OIPF_META2].
For specifically protected content, the element of DRMControlInformation shall be mapped as specified in the following table:
Element / Attribute Name | Element / Attribute Mapping for CSPG-CI+ |
---|---|
DRMControlInformation | |
DRMSystemID | shall be set to the value defined for the specific protection system in the CSPG-CI+, in section 4.2.3.10.1 |
DRMContentID | Vendor specific information. |
RightsIssuerURL | should be set to the RightsIssuerURL which is provided in the rights_info message defined in section 4.2.3.4.1.1.6. |
SilentRightsURL | may be set to an URL allowing retrieval of a message to be forwarded to the CSPG-CI+ in order to silently get updated rights. The MIME type or the HTTP response shall be "application/vnd.oipf.cspg-hexbinary" and the body of the HTTP response shall be an hexadecimal string as described in section 4.2.3.4.1.1.2. |
PreviewRightsURL | may be set to an URL allowing retrieval of a message to be forwarded to the CSPG-CI+ in order to get preview rights. The MIME type or the HTTP response shall be "application/vnd.oipf.cspg-hexbinary" and the body of the HTTP response shall be a hexadecimal string as described in section 4.2.3.4.1.1.2. |
DoNotRecord | Vendor specific mapping |
DoNotTimeShift | Vendor specific mapping |
DRMPrivateData | DRMPrivateData structure shall be substituted by the HexBinaryPrivateData structure. |
mimeType | shall be set to the mime type of the DRMPrivateData. For CSPG-CI+, it shall therefore be set to the following MIME type: "application/vnd.oipf.cspg-hexbinary" |
Both MarlinPrivateDataType and HexBinaryPrivateDataType extend DRMPrivateDataType which is defined in [OIPF_META2], and so the element DRMPrivateData can be substituted by either MarlinPrivateData or HexBinaryPrivateData as described in DRMControlInformation outline in Figure 12.
The XML schema for HexBinaryPrivateData is defined in section B.3.
Element / Attribute Name | Element / Attribute Mapping for CSPG-CI+ |
---|---|
HexBinaryPrivateData | |
Message | A hexadecimal encoded sequence of bytes to be sent to the CSPG-CI+ using send_msg message |
All normative statements in this section and its sub-sections apply only in case the DTCP-IP based Gateway-Centric Approach is supported. NOTE: The criteria that determine under which circumstances the DTCP-IP based Gateway-Centric Approach is implemented are out of the scope of the present document.
The CSP Gateway based on DTCP-IP (CSPG-DTCP) is an optional entity handling security for the OITF. The CSPG DTCP resides in the residential network and makes any specific content protection solution transparent. This is achieved by transforming a service proprietary content protection format into standard protection formats which are sent by a secure channel. OITF and CSPG-DTCP mutually authenticate each other, and CSPG-DTCP transfers content and its usage rule information to OITF in a secure manner. The definition of this interface is based on DTCP ([DTCP]) and DTCP over IP ([DTCP-IP]).
The CSPG-DTCP is an IP connected device, and uses the same physical interface used for other IP devices such as IG, AG or home router.
The main functionalities of the HNI-CSP are to provide:
When an OITF determines, e.g. by inspecting the information in the DRMType element, see [OIPF_META2], of the content guide, content access descriptor or SD&S, that the content is protected by a service specific protection scheme, it shall access the content through the CSPG-DTCP, which acts as an HTTP proxy or RTSP proxy. CSPG-DTCP receives content and shall transform the protection scheme to DTCP-IP. When OITF receives error code of 403 from CSPG-DTCP, the error code is interpreted as DRM rights error. Then a DAE application accesses the error handling web page as an action of onDRMRightsError event defined in [OIPF_DAE2], or a native application accesses the RightsIssuerURL described in BCG or SD&S metadata [OIPF_META2].
Refer to Annex E for examples of session setup sequences with a CSPG-DTCP.
For HTTP streaming and download, the OITF shall send HTTP GET request through the HTTP proxy in CSPG-DTCP. Note that other HTTP transactions shall not use the HTTP proxy in CSPG-DTCP.
DTCP AKE (Authentication and Key Exchange), DTCP content stream and DTCP usage rule are defined in [DTCP] and [DTCP-IP]. The usage rule is provided to the OITF from the CSPG-DTCP considering appropriate mapping, which depends on the service provider’s business models. Content type of HTTP response/request shall be set to DTCP application media type as defined by [DTCP-IP].
This interface is out of scope because of applied service specific protection scheme.
The CSPG-DTCP supports either or both of the following formats protected by DTCP-IP encryption on HNI-CSP. The supported format depends on the CA system supported by the CSPG-DTCP. Media format on UNIS-CSP-G is out of scope of this specification.
If the OITF supports the unprotected MPEG-2 TS, the OITF shall support the DTCP-IP protected MPEG-2 TS format, as defined in this section and its sub-sections. Otherwise, the support of the DTCP-IP protected MPEG-2 TS format as defined in this section and its sub-sections is optional.
If the OITF supports the unprotected time stamped MPEG-2 TS format, the OITF shall support the DTCP-IP protected time stamped MPEG-2 TS format, as defined in this section and its sub-sections. Otherwise, the support of the DTCP-IP protected time stamped MPEG-2 TS format as defined in this section and its sub-sections is optional.
If the OITF supports the unprotected MP4 file format, the OITF shall support the DTCP-IP protected MP4 file format, as defined in this section and its sub-sections. Otherwise, the support of the DTCP-IP protected MP4 file format as defined in this section and its sub-sections is optional.
An MPEG-2 Transport Stream can be streamed or downloaded through CSPG-DTCP. CSPG-DTCP shall transmit the content in the DTCP PCP format. The DTCP PCP format encapsulates the MPEG-2 Transport Stream format, which is defined by [OIPF_MEDIA2]. For the avoidance of doubt, Transport Stream level scrambling or PES level scrambling are not used. Both transport_scrambling_control bits and pes_scrambling control bits shall be set “00”.
For content with parental rating control, CSPG-DTCP shall transmit MPEG-2 Transport Stream with CA descriptor and KSM table as specified in 4.2.4.5.1.1 and 4.2.4.5.1.2. The access_criteria_descriptor carries information for parental rating control.
If the OITF supports the DTCP-IP based Gateway-Centric Approach, the OITF shall support the parental rating access_criteria_descriptor, specified in [IEC62455], and shall support at least the rating_type 0 within these criteria, which maps to the parental rating system in DVB Systems [DVBSI]. Other descriptors in the key stream message should be ignored.
For the parental rating control, the OITF shall compare the program's rating from the parental rating access_criteria_descriptor with the current parental rating criterion set in the OITF by the application (either native application or DAE) and shall block the consumption of the programme if the parental rating system is supported by the OITF and the programme’s rating does not meet the parental rating criterion (e.g. rating is at or above a certain threshold, for a rating system that is ordered from lower viewer age to higher viewer age). The OITF shall raise an event to the application controlling the playback or other operation whenever a parental rating for the A/V content is detected that does not meet the parental rating criterion that is set for the parental system in use, and which has lead to blocking of the consumption of the content. The event shall provide the programme's rating. In case the application is a DAE application, the event is called onParentalRatingChange and is defined in sections 7.13.6 and 7.14.6 of [OIPF_DAE2].
If the OITF does not support the particular parental rating system used in the programme, the OITF shall raise an event to the application controlling the playback or other operation. The event shall provide the programme's rating. In case the application is a DAE application, the event is called onParentalRatingError and is defined in sections 7.13.6 and 7.14.6 of [OIPF_DAE2]. The event may be managed via the DAE application (see section 4.5 of [OIPF_DAE2] for more information). In case the application is a native application, the event is managed through an OITF vendor dependent user interface. In both cases, consumption may be unblocked by setting a new parental rating threshold, the setting of which is usually restricted to privileged users, e.g. parents. A successful PIN input by a user may be used to control the parental rating threshold setting. The OITF should continue monitoring the MPEG-2 TS, taking into account parental rating criteria changes in ECM streams or new settings for the parental rating threshold in the OITF, and shall unblock consumption if the current program's rating becomes lower than the current parental rating threshold.
Content with parental rating control shall include the CA descriptor in PMT with the following restrictions:
Syntax | No. of bits | Mnemonic | Value |
---|---|---|---|
CA_descriptor() { | |||
descriptor_tag | 8 | uimsbf | 9 |
descriptor_length | 8 | uimsbf | |
CA_system_ID | 16 | uimsbf | 0x0007 |
MPEG2_Reserved | 3 | bslbf | |
CA_PID | 13 | uimsbf | |
for (i=0; i<N; i++) { | |||
private_data_byte | 8 | uimsbf | |
} | |||
} |
descriptor_tag | MPEG has defined the tag value of 9 for the CA-descriptor. |
descriptor_length | The length of the descriptor. |
CA_system_ID | 0x0007 |
CA_PID | The PID on which the KSM table can be found |
MPEG2_reserved | Bits reserved by [MPEG2TS]. |
private_data_byte | Not used and shall be ignored. |
Content with parental rating control shall include Key Stream Message in KSM table ([IEC62455], [DVB-CA]).
Key Stream Message is defined in section 7.2 of [IEC62455] and the following usage restrictions shall be applied:
For content with parental rating control, the access_criteria_descriptor loop in the Key Stream Message shall have at least one parental_rating access_criteria_descriptor. The OITF shall ignore other access_criteria_descriptors.
MP4 file format can be downloaded through CSPG-DTCP. CSPG-DTCP shall transmit the content in DTCP PCP format which encapsulates MP4 file format which is defined by [OIPF_MEDIA2].
For downloaded content, content shall be transformed to DTCP-IP protection by CSPG-DTCP when content is being downloaded. Content shall be stored and played back by OITF in a manner compliant to DTCP compliance rules [DTCP-AA].
For PVR usage for scheduled content service, content shall be transformed to DTCP-IP protection by CSPG-DTCP when content is being streamed or multicast. Content shall be stored and played back by OITF in a manner compliant to DTCP compliance rules [DTCP-AA].
For the syntax of the messages mentioned in section 5, see Volume 4 [OIPF_PROT2].
This section presents the general principles that govern Service Access Protection and User authentication. In this section the requested service represents for example Service Provider Discovery (SPD), Service Discovery (SD), or IPTV Application.
This section also applies to services on the IG requested from the OITF over the HNI-IGI. In this case the equivalent of SAA function and Service Function are co-located on the IG.
1. | The OITF requests a service. |
2. | The requested service decides whether the request needs to be authenticated or not.
|
3. | The requested service checks if the request is part of an existing valid authenticated service session (see section 5.6, Session Management).
|
4. | The requested service triggers SAA authentication.
There are two cases: the SAA function is co-located with the requested
service or the SAA function is standalone (see section 5.3, Service Access Protection). The SAA decides what authentication mechanisms it uses (see section 5.2, Interfaces, and section 5.4, OITF Authentication Mechanisms).
|
5. | The requested service serves the request. |
The requested service decides what security is needed for the service delivery: Authentication needed or not, Confidentiality needed (TLS/SSL) or not.
The SAA decides what authentication mechanisms it uses and what security is needed for the performed authentication: TLS/SSL or not.
This section describes the impact of User Identification, Authentication, Authorisation and Service Access Protection on the HNI-INI and HNI-IGI interfaces.
The following authentication mechanisms are supported for HTTP protocol on HNI-INI interface between OITF and Network (see section 5.4 for their specification):
The OITF shall support all the mechanisms listed above.
The SAA may use any of the mechanisms listed above.
Note that GBA authentication can be achieved using either the mechanism in section 5.4.5 GBA Authentication using IMS Gateway or the, more general, mechanism in section 5.4.4 HTTP Digest Authentication using IMS Gateway. Section 5.4.4 allows the use of different authentication mechanism in a way that is transparent to the OITF, including possible future authentication mechanisms, and should preferably be used. It is expected that section 5.4.5 GBA Authentication using IMS Gateway will be deprecated and removed in future versions of this specification.
In this case the equivalent of SAA function and Service Function are co-located on the IG. The following authentication mechanisms are supported for HTTP protocol on HNI-IGI interface between OITF and IG:
The OITF shall support all the mechanisms listed above.
On the HNI-IGI interface, the IG shall support at least one of the following authentication mechanisms:
The IG may use any of the above listed mechanisms (No authentication, HTTP authentication or Web based authentication).
The OITF and IG shall support and perform IMS registration as specified in section 5.4.6 in [OIPF_PROT2] and described in section 5.5. They shall do so prior to any service access attempt in managed network relying on IMS.
On both HNI-INI and HNI-IGI interface, the OITF shall support all of the following mechanisms, redirection, and security for the HTTP protocol and HTML support:
Note: The requirements above ensure the support of SAML web-based SSO, see section 5.6.4.
To avoid extra message exchanges, the OITF shall provide in requests, when available (see section 5.6):
The following figure describes the sequences when the SAA function is co-located with the requested service.
1. | The OITF requests a service. Authentication is needed and there is no valid authenticated service session. |
2. | The service/SAA performs authentication. |
3. | The requested service serves the request. |
The following figure describes the sequences when the SAA function is standalone, the OITF is redirected to the SAA for authentication.
1. | The OITF requests a service. Authentication is needed and there is no valid authenticated service session. |
2A. | The requested service triggers SAA authentication. The service redirects the OITF to the SAA (e.g. using HTTP redirection (Location = SAA)). |
2B | The OITF connects to the SAA, using the redirection obtained in step 2A. |
3. | The SAA performs authentication. |
4A. | The SAA redirects the OITF back to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). |
4B. | The OITF requests the service again, using the redirection obtained in step 4A. |
5. | The requested service checks that authentication succeeded and serves the request. |
The OITF shall support HTTP basic and digest authentication as specified in [RFC2617]. A possible message flow for HTTP basic and digest authentication is described in Figure 21. When HTTP basic or digest authentication [RFC2617] is used, it is assumed that user identifier and its secret information (e.g. password) are shared between OITF and Providers Network (SAA) in advance of the described sequence.
1. | The OITF requests a service co-located with the SAA function or has requested a service and has been redirected to SAA function. |
2. | The SAA responds with a "401 Unauthorized" status code with a WWW-Authenticate header defined in [RFC2617]. |
3. | The OITF re-sends the request with an Authorization header as defined in [RFC2617]. The user identifier and its secret information are used as username-value and password for the generation of the Authorisation header. |
4. | The SAA checks the Authorisation header. If the verification succeeds, the SAA/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response contains an AuthenticationInfo header. The response may contain session management information (cookie, URL parameter). |
If no user and password are available at the OITF, a window may be displayed to the user for entering his credentials between step 2 and 3. This is the standard working in a DAE application. As described in general principles, this situation shall occur only if no valid authentication session or credentials are available in the OITF.
NOTE: To protect the password that is in the clear in HTTP basic authentication; the SAA may additionally require TLS/SSL as stated in the general principles.
This section describes the message flows for network based authentication. Network based authentication is a silent authentication based on network information. This authentication is transparent to the OITF.
In the case of a managed network, the SAA can rely on (proprietary) network specific information, which information is out of scope of this specification, to authenticate an incoming request. The sequences are depicted in the following figure:
1. | The OITF requests a service co-located with the SAA function or has requested a service and has been redirected to an SAA function. |
2. | The SAA links the request to the user based on network information. |
3. | If the operation succeeds, the SAA/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response may contain session management information (cookie, URL parameter). |
The calling function in the OITF should support receiving a CE-HTML response for a service HTTP request and should launch the DAE for displaying it. If the calling function does not support receiving an CE-HTML, XHTML or HTML compatible response, it shall signal it to the server by including its acceptable media types without “application/xhtml+xml”, “application/ce-html+xml”, and “text/html” in the request's HTTP "accept" header explicitly, and by also not including CE-HTML/1.0 as part of the User-Agent header. If the calling function does not support receiving an CE-HTML, XHTML or HTML compatible response, the SAA shall return a "403 Forbidden" HTTP error.
As described in general principles, this situation shall occur only if no valid authentication session is available in the OITF (e.g. no cookie available).
The DAE within the OITF shall support CE HTML forms and HTTP Post in forms.
The remainder of this section describes the message flows for web based authentication. Web based authentication can be explicit or implicit/silent.
Web based authentication mechanisms do not add requirements to the OITF besides supporting a DAE. They are based on optionally HTML forms and HTTP Post, HTTP redirection and HTTP cookies.
1. | The OITF requests a service co-located with the SAA function or has requested a service and has been redirected to SAA function. |
2. | If the HTTP request to the SAA has a User-Agent string that includes CE-HTML/1.0 as defined in [CEA-2014-A], or the "accept" HTTP header includes (explicitly or implicitly) a CE-HTML accept header (“application/ce html+xml”), the SAA responds with a CE-HTML compatible web form for requesting user credentials. User credentials provisioning are out of scope of this specification. |
3. | The web form is displayed in the DAE. |
4. | The user enters his credentials and validates the form. |
5. | The form validation posts the user credentials to the SAA. |
6. | The SAA checks the credentials. |
7. | If verification is successful, the SAA/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response may contain session management information (cookie, URL parameter). |
This section specifies optional functionality by which an OITF can use HTTP Digest credentials in an IG, if present in the home network, for user authentication to HTTP services relying on IMS credentials. The mechanism specified here allows the use of different types of credentials, depending on the capabilities of the IG, and in a way transparent to the OITF, including an extension mechanism to future authentication mechanisms. The OITF discovers the authentication mechanisms supported by IG and the associated credentials stored in the IG, and offers them towards an application server. The application server selects one of the offered authentication mechanisms.
The IG shall signal that it supports HTTP Digest Authentication in its description during UPnP discovery as specified in [OIPF_PROT2], section 10.1.1.1.3.
HTTP Basic authentication shall not be used.
NOTE: The criteria that determine under which circumstances the functionality by which an OITF can use the HTTP Digest credentials in a Gateway Function is implemented in an OITF are out of the scope of the present document.
When the OITF is powered up and if the IG supports HTTP Digest Authentication, the OITF shall request supported HTTP Digest authentication realms from the IG as described in [OIPF_PROT2], section 5.4.6.3.1. Receiving this request:
The OITF may check the returned User-Agent token. The OITF shall accept unknown User-Agent tokens, in order to allow evolution of the authentication procedure.
The OITF shall append the returned User-Agent token to its User-Agent.
Note: If the IG supports GBA Authentication, as the IG adds "3gpp-gba" to the returned User-Agent token, the OITF acts as a User Equipment in [3GPP24.109] and signals in its User Agent that it supports GBA Authentication.
Figure 24 shows the message sequence for initial procedure to ensure HTTP Digest authentication using IG. It contains the following steps:
1. | The OITF is powered on. |
2. | The OITF performs a user registration as defined in section 5.5. |
3. | The OITF sends a Fetch HTTP realms request to IG as defined in [OIPF_PROT2], section 5.4.6.3.1, step 1. The IG validates the request. The IG may require at that stage any authentication mechanism specified in section 5.2.2 and/or any mechanism and security (i.e. TLS/SSL) specified in section 5.2.3. For simplification, none of this mechanism is shown in Figure 24. |
4. | If IG supports GBA, the IG performs GBA Bootstrapping procedure according to [3GPP33.220] towards the GBA Single Sign-on (BSF) function in the provider's network. If successful, this results in establishing a shared key Ks on both ends. The GBA Single Sign-on function also sends the lifetime of the key Ks and a session identifier B-TID to the IG. |
5. | The IG returns the list of supported realm and user-agent string to the OITF as defined in [OIPF_PROT2], section 5.4.6.3.1, step 2. |
If the OITF has registered to an IG which supports HTTP Digest Authentication, each time the OITF needs to access a service offered by an application server that requires HTTP Digest authentication, the OITF shall check the realm against the realms retrieved from IG in the initial procedure. If the realm matches to one of the IG supported realms, the OITF shall retrieve HTTP credentials and HTTP headers from the IG, as specified in [OIPF_PROT2], section 5.4.6.3.2.
As a pre-requisite to this procedure, the IMS registration must have been successfully completed.
The IG may provide the following HTTP header:
The SAA may verify that the intended identity matches to the authenticated identity.
Note: The intended identity is used to identify the user when credentials are shared among users. The service provider should define and enforce policies for sharing of credentials among users.
The OITF may check the returned HTTP Headers. The OITF shall accept unknown User-Agent tokens, in order to allow evolution of the authentication procedure.
The OITF shall use the returned credentials towards the application server, using HTTP Digest authentication as specified by [RFC2617] and shall add the returned HTTP headers to the outgoing HTTP requests for this realm.
Note: The service provider should define and enforce policies for sharing of credentials among application servers.
The same credentials and realm as for SIP digest may be used, this is an operator security and deployment choice (managed in the IG and the network). In this case:
Figure 25 shows the message sequence for authentication between an OITF function and an SAA based on HTTP credentials retrieved from the IG. It contains the following steps:
1. | OITF function sends a request for a resource (e.g., service) to the SAA. It is assumed here that the resource requires authentication. |
2. | The SAA returns a 401 Unauthorized message as defined in [RFC2617] |
3. | The OITF checks the realms. The realm is one of the realms supported by the IG for HTTP Digest authentication. The OITF sends a request including the IMPU, the auth-scheme and realm and additional authentication parameters in case of digest authentication to the IG to retrieve HTTP credentials for the registered user. The request format is specified in [OIPF_PROT2], section 5.4.6.3.2, step 1. |
4. | IG returns the authentication credentials and optionally HTTP Headers. The nature of the authentication credentials and the response format are specified in [OIPF_PROT2], section 5.4.6.3.2, step 2. The IG may require at that stage any authentication mechanism specified in section 5.2.2 and/or any mechanism and security (i.e. TLS/SSL) specified in section 5.2.3 for access control and/or protection of the credentials. For simplification, none of this mechanism is shown in Figure 25. |
5. | The OITF function repeats the request 1. with an Authorisation header, using returned authentication credentials. The OITF adds the returned HTTP headers, if any, to the request. |
6. | SAA requests from the User Database for the subscriber specified via its user-id, its HTTP credentials (authentication vector) and possible identities. |
7. | The SAA gets the authentication vector and possible identities from the User Database. The SAA checks the user-id and password. The SAA may verify that the intended identity provided in the HTTP header belongs to the possible identities of the subscriber. Note: it is assumed that there exists a trust relation between SAA and User Database. Details are out of scope of this specification. |
8. | Upon successful authentication, the SAA/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response may contain session management information (cookie, URL parameter). |
The message format for steps 3 and 4 are specified in the section 5.4.6.3.2 of [OIPF_PROT2].
The key Ks that was established during the GBA registration may be used later on for authentication between OITF functions and services (i.e., Application Servers). Each time an OITF needs to access a service offered by an AS (i.e., NAF) that requires GBA Authentication, a specific key Ks_NAF in case of GBA-ME or Ks_ext_NAF in case of GBA-U shall be derived by the IG or ISIM in IG respectively and the server side GBA Single Sign-on function (acting like a BSF in [3GPP24.109]). For clarity this specific key is named in the rest of the document Ks_(ext)_NAF and will refer to Ks_NAF in case of GBA_ME and Ks_ext_NAF in case of GBA_U. This generated key shall be conveyed to the OITF function in the residential network by the IG, and to the AS by the server side GBA Single Sign-on function (BSF). The key Ks_(ext)_NAF shall then be used for authentication between the OITF function and the AS, using HTTP Digest authentication as specified by [3GPP24.109].
When a SAA (acting like a NAF in [3GPP24.109]) requests GBA Authentication (perceived as regular HTTP Digest authentication by the OITF), the OITF shall retrieve HTTP credentials, in this case GBA Credentials, and HTTP Headers and shall perform HTTP Digest authentication.
As a pre-requisite to this procedure, the GBA registration must have been successfully completed by the IG in the initial procedure (cf. 5.4.4.1).
Figure 26 shows the message sequence for authentication between an OITF function and an SAA based on the previously established GBA bootstrapping. It contains the following steps:
1. | OITF function sends a request for a resource (e.g., service) to the SAA (NAF). It is assumed here that the resource requires authentication. The User-Agent string in the HTTP request contains "3gpp-gba" indicating to the SAA that it supports GBA authentication. Note: the user-agent string has previously been sent from IG to OITF, |
2. | The SAA (NAF) returns a 401 Unauthorized message, the realm indicates that 3GPP bootstrapping is used and provides the NAF FQDN as defined in [3GPP24.109]. |
3. | The OITF checks the realms. The realm is one of the
realms supported by the IG for HTTP Digest authentication. The OITF
sends a request including the IMPU, the auth-scheme and realm and
additional authentication parameters for digest authentication to the IG
to retrieve HTTP credentials for the registered user. The request
format is specified in [OIPF_PROT2], section 5.4.6.3.2,
step 1. The IG identifies from the realm that GBA authentication is
requested. IG generates Ks_NAF in case of GBA_ME or Ks_ext_NAF with the
co-operation of the ISIM in case of GBA_U (Ks_(ext)_NAF). Note:
according to [3GPP33.220],
the NAF_ID is constructed as follows: NAF_ID = FQDN of the NAF || Ua
security protocol identifier. The FQDN of the NAF is included in the
realm. The identifier for Ua security protocol HTTP Digest
authentication according to [3GPP24.109] is (0x01,0x00,0x00, 0x00,0x02). Ks_(ext)_NAF is computed as Ks_(ext)_NAF = KDF (Ks, "gba-me", RAND, IMPI, NAF_ID), where KDF is the key derivation function as specified in Annex B of [3GPP33.220], and the key derivation parameters consist of the user's IMPI, the NAF_ID and RAND. |
4. | IG returns the authentication credentials and optionally HTTP Headers. The B-TID is used as username and Ks_(ext)_NAF as password. The IG may return a "X-3GPP-Intended-Identity" HTTP header containing the identity of the current user, as specified in [3GPP24.109]. The response format is specified in [OIPF_PROT2], section 5.4.6.3.2, step 2. |
5. | The OITF function repeats the request 1. with an Authorisation header, using authentication credentials returned from IG in step 4. The OITF adds the returned HTTP headers, if any, to the request. |
6. | SAA (NAF) sends B-TID and its NAF_ID to the GBA Single Sign-on function (BSF) in provider network, the GBA Single Sign-on function retrieves Ks and calculates Ks_(ext)_NAF. |
7. | The GBA Single Sign-on function (BSF) in provider network returns Ks_(ext)_NAF, together with its lifetime, to SAA (NAF). Note the key lifetime returned by the GBA Single Sign-on function (BSF) is equal to the lifetime of the corresponding Ks. But the SAA (NAF) may choose a shorter key lifetime based on local policy and/or application-specific needs. |
8. | If Ks_(ext)_NAF has expired, the SAA (NAF) shall send a suitable bootstrapping renegotiation request to the OITF, according to [3GPP33.220] and [3GPP24.109]. Otherwise the SAA (NAF) uses Ks_(ext)_NAF to authenticate the request. Upon successful authentication, the SAA (NAF)/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response may contain session management information (cookie, URL parameter). |
The message format for steps 3 and 4 are specified in the section 5.4.6.3.2 of [OIPF_PROT2].
Note that GBA authentication can be achieved using either the mechanism in section 5.4.5 GBA Authentication using IMS Gateway or the, more general, mechanism in section 5.4.4 HTTP Digest Authentication using IMS Gateway. 5.4.4 allows the use of different authentication mechanism in a way that is transparent to the OITF, including possible future authentication mechanisms, and should preferably be used. It is expected that section 5.4.5 GBA Authentication using IMS Gateway will be deprecated and removed in future versions of this specification.
This section specifies optional functionality by which an OITF can use the ISIM in an IG, if present in the home network, for user authentication to services relying on IMS credentials. This section is based on the principles described in [OIPF_ARCH2] Appendix B, but extends that section.
The IG shall signal that it supports GBA Authentication in its description during UPnP discovery as specified in [OIPF_PROT2], section 10.1.1.1.3.
NOTE: The criteria that determine under which circumstances the functionality by which an OITF can use the ISIM in a Gateway Function is implemented in an OITF are out of the scope of the present document.
When the OITF is powered up or when the user initiates a registration, i.e. when the OITF requests a User Registration from the IG, and if the IG supports GBA Authentication, the OITF shall, after the User Registration from the IG, request a GBA Registration from the IG as described in [OIPF_PROT2]. Receiving this request, the IG shall perform a GBA registration for the current IMS registered user towards the GBA Single Sign-On Function (acting like a BSF), according to [3GPP33.220]. The GBA registration is based on secrets shared between the ISIM and the network provider. The result of a successful GBA run is the establishment of a session identifier, B-TID, and a shared key, Ks. This key Ks can later be re-used to derive server side application (NAF) specific keys. These keys can also be passed on to trusted applications in the home network, and can later be used for authentication based on the GBA authentication, but without further need for IG-provider network communication.
Figure 27 shows the message sequence for initial GBA registration. It contains the following steps:
1. | The OITF is powered on (automatic default registration) or the user requests a personalised registration. |
2. | The OITF performs a user registration as defined in section 5.4.5. |
3. | The OITF sends a GBA registration request to IG as defined in [OIPF_PROT2], section 5.4.6.2.1, step 1. |
4. | The IG validates the request. The IG may require at that stage any authentication mechanism specified in section 5.2.2 and/or any mechanism and security (i.e. TLS/SSL) specified in section 5.2.3. For simplification, none of this mechanism is shown in Figure 27. |
5. | The IG performs GBA bootstrapping procedure according to [3GPP33.220] towards the GBA Single Sign-on function (BSF) in the provider's network. If successful, this results in establishing a shared key Ks on both ends. The GBA Single Sign-on function (BSF) also sends the lifetime of the key Ks and a session identifier B-TID to the IG. |
6. | The IG returns the outcome of the GBA registration process to the OITF as defined in [OIPF_PROT2], section 5.3.6.2.1, step 2. |
7. | If the result of the registration procedure is successful, a registration state is created and maintained in IG. |
8. | An indication is sent to the user that includes the outcome of the registration process. |
The key Ks that was established during the GBA registration may be used later on for authentication between OITF functions and services (i.e., Application Servers). Each time an OITF needs to access a service offered by an AS (i.e., NAF) that requires GBA Authentication, a specific key Ks_(ext)_NAF shall be derived by the IG and the server side GBA Single Sign-on function (acting like a BSF in [3GPP24.109]). This generated key shall be conveyed to the OITF function in the residential network by the IG, and to the AS by the server side GBA Single Sign-on function (BSF). The key Ks_(ext)_NAF shall then be used for authentication between the OITF function and the AS, using HTTP Digest authentication as specified by [3GPP24.109].
If the OITF has registered to an IG which supports GBA Authentication, the OITF shall act as a User Equipment in [3GPP24.109] and therefore shall signal in its User Agent that it supports GBA Authentication.
When a SAA (acting like a NAF in [3GPP24.109]) requests GBA Authentication, the OITF shall retrieve GBA Credentials for the specified SAA (NAF) from the IG as specified in [OIPF_PROT2], and shall perform HTTP Digest authentication as specified by [3GPP24.109].
If the OITF retrieves an X-HNI-IGI-Intended-Identity HTTP header from the IG, it shall use it as intended user identity and shall add an "X-3GPP-Intended-Identity" HTTP header to the outgoing HTTP requests to the SAA (NAF); as specified in [3GPP24.109]. The SAA may verify that the intended identity belongs to the user (i.e. the identity matches one of the user’s public identities indicated in the user security setting that was retrieved from the GBA Single Sign-On Function (BSF)).
As a pre-requisite to this procedure, the GBA registration (cf. 5.4.5.1) must have been successfully completed.
Figure 28 shows the message sequence for authentication between an OITF function and an SAA based on the previously established GBA key. It contains the following steps:
1. | OITF function sends a request for a resource (e.g., service) to the SAA (NAF). It is assumed here that the resource requires authentication. The User-Agent string in the HTTP request contains "3gpp-gba" indicating to the SAA (NAF) that it supports GBA authentication. |
2. | The SAA (NAF) returns a 401 Unauthorized message, the realm indicates that 3GPP bootstrapping is used and provides the NAF FQDN as defined in [3GPP24.109]. |
3. | OITF sends a request including the NAF FQDN to the IG
to retrieve GBA credentials, and IG generates Ks_NAF in case of GBA_ME
or Ks_ext_NAF with the co-operation of the ISIM in case of GBA_U
(Ks_(ext)_NAF). Note: according to [3GPP33.220],
the NAF_ID is constructed as follows: NAF_ID = FQDN of the NAF || Ua
security protocol identifier. The identifier for Ua security protocol
HTTP Digest authentication according to [3GPP24.109] is (0x01,0x00,0x00, 0x00,0x02). The request format is specified in [OIPF_PROT2], section 5.3.6.2.2, step 1. Ks_(ext)_NAF is computed as Ks_(ext)_NAF = KDF (Ks, "gba-me", RAND, IMPI, NAF_ID), where KDF is the key derivation function as specified in Annex B of [3GPP33.220], and the key derivation parameters consist of the user's IMPI, the NAF_ID and RAND. |
4. | IG returns Ks_(ext)_NAF, B-TID, the lifetime of the key Ks_(ext)_NAF and optionally the intended identity to OITF. The lifetime indicates the expiry time of the key Ks_(ext)_NAF and is equal to the lifetime of the key Ks (which was specified by the BSF during the GBA bootstrapping procedure). The response format is specified in [OIPF_PROT2], section 5.3.6.2.2, step 2. |
5. | The OITF function repeats the request with an Authorisation header, using B-TID as username and Ks_(ext)_NAF as password. If a non empty intended identity is returned from the IG, the OITF adds an X-3GPP-Intended-Identity HTTP Header containing the intended identity. If no intended identity is returned from the IG, the OITF shall not add an X-3GPP-Intended-Identiy. |
6. | SAA (NAF) sends B-TID and its NAF_ID to the GBA Single Sign-on function (BSF) in provider network, the GBA Single Sign-on function (BSF) retrieves Ks and calculates Ks_(ext)_NAF. |
7. | The GBA Single Sign-on function (BSF) in provider network returns Ks_(ext)_NAF, together with its lifetime, to SAA (NAF). Note the key lifetime returned by the GBA Single Sign-on function (BSF) is equal to the lifetime of the corresponding Ks. But the SAA (NAF) may choose a shorter key lifetime based on local policy and/or application-specific needs. |
8. | If Ks_(ext)_NAF has expired, the SAA (NAF) shall send a suitable bootstrapping renegotiation request to the OITF, according to [3GPP33.220]. Otherwise the SAA (NAF) uses Ks_(ext)_NAF to authenticate the request. Upon successful authentication, the SAA (NAF)/service serves the request or redirects the OITF to the service (e.g. by using SAML HTTP-POST binding, SAML HTTP Post SimpleSign binding or HTTP redirection). The response may contain session management information (cookie, URL parameter). |
The message format for steps 3 and 4 are specified in the section 5.3.6.2.2 of [OIPF_PROT2].
GBA authenticates ISIM/IMPI, not the device. On the other hand, DRM (e.g. Marlin) relies on device authentication; the device must have a valid certificate issued by the DRM trust authority. To avoid security issues e.g. allowing a legitimate (from a DRM point of view) device that is however not in fact authorised by a user accessing services, the GBA (user) authentication and the DRM device authentication need to be securely linked together.
This section specifies the message flows for IMS Registration using SIP Digest (*) authentication or IMS AKA authentication by means of which Service Platform Providers and IMS Gateways located in Residential Networks can authenticate each other. These message flows are based on [3GPP33.203] and [3GPP24.229] (stage 3 specification).
(*) This section specifies authentication-related details of certain SIP messages. Elsewhere, for example at ETSI TISPAN, this SIP authentication method is often called “HTTP Digest” as SIP Digest [RFC3261] is identical to HTTP Digest [RFC2617] – despite the fact that the protocol in question is SIP and not HTTP. The authentication method treated in this section is referred to as “SIP Digest” since the name “HTTP Digest” might lead to the wrong impression that the protocol in question is HTTP.
Figure 29 extracts the functional entities and reference points relevant for IMS Registration from the OIPF Provider and Residential Network Architectures (see Figures 5-2 and 5-4 in [OIPF_ARCH2]):
SIP Digest authentication, and respectively IMS AKA authentication is interlaced into the IMS Registration message exchange between the IMS Gateway (IG) and the Authentication and Session Management (ASM) functional entities. IMS Registration occurs either when the IG is powered up or when the IG receives a corresponding request from an OITF. The User Database supplies the ASM with authentication vectors needed for SIP Digest authentication, and respectively IMS AKA authentication.
Prior to the first IMS Registration (and hence prior to the first SIP Digest or IMS AKA) protocol execution, the following parameters must be provisioned:
In case of IMS AKA, these parameters are in a UICC with an ISIM or USIM application.
Methods for provisioning these parameters to IG and User Database functional entities are out of scope of this specification.
Figure 30 shows the message flow for SIP Digest authentication, which is interlaced into IMS Registration messages:
0. | The IG is powered up. This can initiate the execution of steps 2 – 7. |
1. | OITF to IG: Registration Request The OITF sends a request for registration to the IMS Gateway (IG), when needed (the end user explicitly logs on for personalized services). |
2. | IG to ASM: SIP REGISTER This request contains the SPP Network Domain Name of the IG’s IMS home network, an IMPI and an IMPU. If the ASM has a valid SIP Digest authentication vector (SD-AV) for the specific IMPI, steps 3, 4 and 5 are omitted. |
3. | ASM to User Database: DIAMETER MULTIMEDIA AUTH REQUEST (MAR) The ASM requests a SD-AV from the User Database with respect to the IMPI received in step 2. |
4. | User Database to ASM: DIAMETER MULTIMEDIA AUTH ANSWER (MAA) Along with the IMPI, the User Database sends a SD-AV to the ASM containing the following data: qop value (quality of protection), the authentication algorithm, realm, and a hash value H(A1) of the IMPI, realm, and password. [RFC2617] provides additional information on the values in the authentication vector for SIP Digest based authentication. Upon reception of the MAA message, the ASM stores the H(A1) value and generates the nonce value needed to challenge the IG. |
5. | ASM to IG: SIP 401 Unauthorized The ASM denies the IG authentication but sends a SIP 401 Unauthorized message to the IG in order to challenge the IG. This message contains the IMPI, the nonce, the authentication algorithm, and the realm and qop values. |
6. | IG to ASM: SIP REGISTER After reception message 5, the IG generates a client nonce (cnonce) and calculates an authentication response value using this cnonce and other values received in step 5 (see [RFC2617]). The IG sends a new SIP REGISTER request to the ASM, this time with the authentication response along with the parameters IMPI, realm, nonce, response, cnonce, qop, nonce-count, and algorithm. |
7. | ASM to IG: SIP 200 OK (successful case) After reception of the SIP REGISTER message containing the authentication response value, the ASM calculates the expected response value using the previously stored H(A1) and the stored nonce value together with other parameters (see [RFC2617]). If the response value received from the IG equals the expected response value, the IG has been authenticated and the IMPU is registered in the ASM. In this successful case, the ASM sends the SIP 200 OK from ASM to the IG, enabling the IG to authenticate the SPP Network. This SIP 200 OK message contains a response digest calculated using the cnonce value generated by the IG prior to sending message 6. |
8. | IG to OITF: Registration Response The IG informs the OITF about the result of the registration procedure (when step 1 was executed). |
The details of the messages 2 – 7 are specified in [3GPP24.229].
To support IMS AKA, a UICC with an ISIM or USIM application must be integrated into the IMS Gateway (IG). From the IMS point of view, the IG thereby takes the role of an IMS Subscriber. The UICC stores a long-term secret key K which is shared between the ISIM or USIM application and a User Database belonging to the network operator that provides the ISIM or the USIM. Figure 31 shows the high-level message flows for user identification and authentication based on the IMS AKA procedure
0. | The IG is powered up. This can initiate the execution of steps 2-7 |
1. | OITF to IG: Registration Request The OITF sends a request for registration to the IMS Gateway (IG), when needed (the end user explicitly logs on for personalized services) |
2. | IG to ASM: SIP REGISTER This request contains the SPP Network Domain Name of the IG's IMS home network, the IMPI and the IMPU. All this data is read from the ISIM. |
3. | ASM to User Database: DIAMETER MULTIMEDIA AUTH REQUEST (MAR) ASM requests authentication data from the User Database with respect to the IMPI received in step 2. |
4. | User Database to ASM: DIAMETER MULTIMEDIA AUTH ANSWER (MAA) The User Database sends an Authentication Vectors (AV) to the ASM containing the following data: random challenge RAND, answer XRES expected by the IG in step 6, network authentication token AUTN, integrity key IK, and ciphering key CK. The authentication token AUTN contains a message authentication code (MAC) enabling the IG to authenticate the SPP Network (see step 5). |
5. | ASM to IG: SIP 401 Unauthorized At this point in time, the ASM denies the IG authentication. Instead, it sends a SIP Unauthorized message with a WWW-Authenticate header to the IG. This header contains RAND and AUTN. After reception of this message, the IG verifies the message authentication code contained in AUTN thereby authenticating its SPP Network. |
6. | IG to ASM: SIP REGISTER ISIM computes the value RES on input of its version of the secret key K stored on the UICC of the IG. The IG sends a new SIP REGISTER request to the ASM, this time with RES as response to the challenge the ASM initiated in step 5. |
7. | ASM to IG: SIP 200 OK If RES = XRES (successful case), ASM considers the IG as authenticated, and binds IMPU to the IP address <IP address>. |
8. | IG to OITF: Registration Response The IG informs the OITF about the result of the registration procedure. (when step 1 was executed) |
In case of success, the ISIM of the IG is able, based on its knowledge of the secret key K and the authentication token AUTN, to calculate the same values of the integrity key IK and the ciphering key CK as those that the ASM received in step 4 from the User Database. The IG and the ASM use IK and CK to establish IPSec Security Associations for protecting SIP signaling messages over the IG – ASM reference point
The details of the messages 2-7 are specified in [3GPP24.229].
User authentication does not need to be performed with each request. In order to avoid re-authentication at each request, a Service (and/or SSA) can rely on authentication session management and Single Sign On. The following authentication session management can be used: cookies, URL parameters and HTTP authentication session, if HTTP or GBA authentication has been used. SAML Web-based Single Sign On can be used.
The OITF shall support HTTP session management using cookies as described in [RFC2109]. The cookie is opaque data to the OITF.
Persistent cookies shall be stored in non-volatile memory (Flash, HDD, etc.) in the OITF.
All OITF applications using HTTP (not only DAE) shall be able to create, read and delete persistent cookies with respect to domain restriction as specified in [RFC2109]. Persistent cookies should be shared between all components in an OITF.
User shall have the possibility to delete persistent cookies in OITF.
The following figure shows an example of sequences based using cookie session:
1. | The OITF requests a service with no valid cookie. |
2. | The service triggers the SAA authentication and the SAA performs the wanted authentication. |
3. | The service or SAA sets a cookie using Set-Cookie response header as specified in [RFC2109]. |
4. | The OITF requests a service. Applicable cookies are provided in each HTTP request as specified in [RFC2109] (domain-match, port-match, path-match, Max_Age-match, etc.). |
5. | The service checks the cookie. Cookie checking is out of scope of this specification. |
6. | The service optionally refreshes the cookie and sets it again using Set-Cookie response header as specified in [RFC2109]. |
Steps 4 to 6 are performed for each new HTTP request according to cookie matching.
An alternative to cookies for passing session data is the use of hidden input fields in forms or URL parameters in requests passed to the server. These mechanisms are transparent to the OITF. Below is an example message flow using URL parameters. Note that the use of hidden input fields can also be achieved with HTTP POST. The mechanism of using HTTP POST is not described in this section.
1. | The OITF requests a service with no valid authentication session. |
2. | The service triggers the SAA authentication and the SAA performs the wanted authentication. |
3. | The service or SAA redirects to the service with a new URL parameter for session data. |
4. | The OITF requests a service with the URL parameter. |
5. | The service checks the session data in the URL parameter. Session data is opaque data and out of scope of this specification. |
6. | The service serves the request. |
NOTE: URL parameters are often used to pass session information from an HTTP session to a session using another protocol (e.g. RTSP).
NOTE: a web server (service or SAA) can maintain an HTTP session using this technique. But the server is responsible for modifying every link URL, so that the session data is posted in a form or appended to the request.
NOTE: Passing information through URL parameters is highly insecure.
When using HTTP authentication, a server can rely on HTTP authentication session as specified in [RFC2617].
The User may be prompted to allow OITF to store HTTP authentication parameters, i.e. username and password, in non-volatile memory.
All OITF applications using HTTP (not only DAE) should have access to HTTP authentication parameters, i.e. username and password.
All OITF applications using HTTP (not only DAE) should share the current HTTP authentication session (e.g. B-TID, Ks_NAF, nonce, cnonce, nonce-count and opaque values).
If username and password can be stored, the user shall have the possibility to change stored username and passwords in OITF for a given protection space as specified in [RFC2617].
The following figure shows an example of sequences based on HTTP authentication session:
1. | The OITF requests a service with no valid HTTP authentication session. |
2. | The service/SAA performs HTTP or GBA authentication. |
3. | The service/SAA serves the request including an AuthenticationInfo header as specified in [RFC2617]. |
4. | The OITF requests again a service. Appropriate HTTP Authorisation headers are provided in each HTTP request within the protection space (specified by domain) as specified in [RFC2617]. |
5. | The Service/SAA checks the Authorisation header. |
6. | The Service/SAA serves the request including an AuthenticationInfo header. |
Steps 4 to 6 can be performed for each new HTTP request within the protection space.
This section specifies the functionality and possible message flows for basic SAML web-based single sign-on.
SAML Web-based single sign-on shall adhere to section 4.1 of [SAMLPROF], whereby either a SAML HTTP POST or a SAML HTTP SimpleSign binding of a SAML <Response> message from the SAA shall use MIME-type “application/ce html+xml” as defined in [CEA-2014-A]. A standard CEA-2014-A compatible browser is able to handle the SAML HTTP redirect and POST bindings defined in this section, without requiring any extensions to CEA-2014-A. This profile of SAML therefore does not add requirements to the OITF besides supporting DAE functionality.
The remainder of this section describes sequences of how SAML Web-based single sign-on is handled between the different relevant entities, i.e. the service, the SAA, and the OITF.
The sequences assume that the SAA and service provider share a logical identification of the user in advance of the described sequence. The user is known to the SAA. The SAA maintains knowledge of the user’s authentication credentials.
1. | The OITF requests a service. Authentication is needed and there is no valid authenticated service session. |
2. | The requested service triggers SAA authentication by issuing a redirect request using SAML HTTP Redirect binding, i.e. an HTTP Response with HTTP "302 Found" or “303 See Other” (Location = SAA) , with a SAML <AuthnRequest> message (as defined in section 3.4.1 of [SAMLCORE]). |
3. | The SAA authenticates the user. Various methods exist for this. Valid methods include the authentication methods as defined in sections 5.4.1 through 5.4.5 of this document. |
4. | The SAA responds with either a SAML HTTP POST or HTTP POST SimpleSign binding of a SAML <Response> message (as defined in section 3.3.3 of [SAMLCORE]). Since the browser of the OITF is CE-HTML compliant, the SAA response message must use MIME-type “application/ce-html+xml” as defined in [CEA-2014-A]. The CE-HTML browser will load the CE HTML page with the SAML POST binding, after which it issues an HTTP POST request to the target service with the SAML <Response> message as payload. |
5. | The requested service checks the SAML <Response> message to see if authentication succeeded. If succeeded, the service serves the request. |
Content may contain navigation constraints for forced playout, see [OIPF_MEDIA2] sections 4.1 and 4.2.
If an OITF supports DMZ navigation constraints signalled in zone maps within MP4 files or MPEG-2 TS, it shall indicate this via the appropriate capability signalling [OIPF_DAE2]. If an OITF does not understand the navigation constraints, this capability description is either absent or set to “false”. If the capability description to support such DMZ navigation constraints is set to “true”, an OITF shall obey the signalled constrains and shall not ignore the presence of navigation constraints.
Note: When this capability description is not sent or is set to “false”, it is the choice of the service provider whether the content shall be sent to the OITF as there is no guarantee whether the navigation constraints will be obeyed.
For navigation constraints pertaining to protected content, the zone map information may be integrity protected using an included signature as described in [MRL-DMZ]. If the zone map is integrity protected using a signature, and if the terminal-centric approach is used for content protection, the key used for signature is derived as described in [MRL-DMZ] sections 2.1 and 2.3 for MP4 (using a key derived from the content key), and as described in [MRL-DMZ] section 7.2.2 for MPEG-2 TS (using a signature key signalled in ECMs). Note that the [MRL-DMZ] specification contains normative language on what should happen if the integrity of the signalled constraints cannot be verified. If an OITF supports DMZ navigation constraints and if integrity protection is used, the OITF shall verify the integrity of the signalled constraints, If the integrity of the signalled constraints cannot be verified, the OITF shall not play the associated content.
Note: Server-based play out control is described in [OIPF_PROT2], section 6.1.2.3. The concept there is applicable to interactive streaming where the server may or may not grant requests for trick-mode commands like fast forward.
This section describes the generic mechanism to link user authentication result with device authentication in OITF. Although the device authentication mechanism is provided by Marlin, the user authentication mechanism varies depending on the system environment.
The mechanism described in this section uses HTTP Digest Authentication [RFC2617] and assumes that user identifier and its secret information (e.g. password, Ks_NAF) are shared between OITF and Providers Network in advance of the sequences between CSP and CSP-T Server.
The sequence below explains how the user authentication and device authentication are securely correlated with each other by Marlin Action Token Acquisition and Marlin Protocol.
1. | The CSP requests a Marlin Action Token to the CSP-T Server. |
2. | When the CSP-T Server receives the request from CSP for the Marlin Action Token, the CSP-T Server responds with a "401 Unauthorized" status code with a WWW-Authenticate header defined in [RFC2617]. |
3. | When the CSP receives the response, the CSP sends the request which includes an Authorisation header defined in [RFC2617]. The user identifier and its secret information are used as username and password for generation of the Authorisation header. |
4. | When the CSP-T Server receives the Authorisation header,
|
5. | Given the Marlin Action Token, the CSP sends a (Marlin Protocol) request to CSP-T Server which includes Authorisation header calculated from its username and password, and the Business Token. |
6. | When the CSP-T Server receives the Authorisation header in the (Marlin Protocol) request, which includes the Business Token,
|
This is the XML schema for MarlinPrivateDataType Structure (see section 4.1.7.2):
<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <!-- schema filename is csp-MarlinPrivateData.xsd --> <xs:include schemaLocation="csp-DRMPrivateDataType.xsd"/> <xs:complexType name="MarlinPrivateDataType"> <xs:complexContent> <xs:extension base="DRMPrivateDataType"> <xs:sequence> <xs:choice> <xs:element name="MarlinLicense" type="xs:base64Binary"/> <xs:element name="MarlinToken" type="xs:base64Binary"/> </xs:choice> <xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> </xs:schema>
The DRMPrivateDataType structure is defined in the included file “csp-DRMPrivateDataType.xsd” as
<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:complexType name="DRMPrivateDataType" abstract="true"> <xs:attribute name="mimeType" type="xs:string" use="optional"/> <!-- NOTE: DRMPrivateDataType is an abstract type that can be extended and replaced by a specific instance type to carry messages for a particular DRM system. Derived types of <DRMPrivateData> should include an <any> construct to be prepared for future extensibility, as is done for example for <MarlinPrivateData> --> </xs:complexType> </xs:schema>
This is the XML schema for MIPPVControlMessage (see section 4.1.7.3.1):
<?xml version="1.0" encoding="UTF-8"?> <xs:schema targetNamespace="urn:oipf:csp:MIPPVControlMessage:2008" xmlns:tns="urn:oipf:csp:MIPPVControlMessage:2008" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <!-- schema filename is csp-MIPPVControlMessage.xsd --> <xs:element name="MIPPVControlMessage"> <xs:complexType> <xs:sequence> <xs:element name="MarlinLicense" type="xs:base64Binary" minOccurs="0"/> <xs:element name="MarlinActionToken" minOccurs="0"> <xs:complexType> <xs:simpleContent> <xs:extension base="xs:base64Binary"> <xs:attribute name="absoluteAcquisitionTiming" type="xs:dateTime" use="optional"/> <xs:attribute name="relativeAcquisitionTiming" type="xs:duration" use="optional"/> </xs:extension> </xs:simpleContent> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>
This is the XML schema for HexBinaryPrivateDataType Structure (see 4.2.3.10.2):
<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <!-- schema filename is csp-HexBinaryPrivateDataType.xsd --> <xs:include schemaLocation="csp-DRMPrivateDataType.xsd"/> <xs:complexType name="HexBinaryPrivateDataType"> <xs:complexContent> <xs:extension base="DRMPrivateDataType"> <xs:sequence> <xs:element name="Message" type="xs:hexBinary"/> <xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> </xs:schema>
The DRMPrivateDataType structure is defined in the included file csp-DRMPrivateDataType.xsd and is shown in section B.1.
The following table summarizes the DRM messages and their MIME-types used in sendDRMMessage API defined in [OIPF_DAE2].
Mime-type | Description |
---|---|
application/vnd.marlin.drm.actiontoken+xml | Marlin Action Token defined by [MRL-BNSP] |
application/vnd.oipf.mippvcontrolmessage+xml | MIPPVControl Message as described in section 4.1.7.3.1 |
application/vnd.oipf.cspg-hexbinary | CSPG-CI+ message as described in section 4.2.3.4.1.1.2, “Mapping of messages to DAE API or Events”
Note: This type may also be used for CSPG messages in the case the gateway is combined with the OITF as introduced in section 4.2. |
application/vnd.marlin.drm.actiontoken2+xml | Marlin Action Token defined by [MRL-MS3] |
CI+ Host is the function in the OITF responsible for managing the dialog with the CSPG-CI+. CSPG-CI+ is referred to as CI+ CAM in [CI+] specifications. It is an internal function in OITF, not identified in [OIPF_ARCH2]. It is shown on the following sequence diagrams to help understanding of interaction with other identified functions.
Management of content protection using CSPG-CI+ has no impact on the protocols used for service discovery, Scheduled Content or CoD session establishment and management and delivery, as defined in [OIPF_PROT2]. CSPG-CI+ protected services can be Scheduled Content services or CoD services (multicast streaming, unicast streaming or download IPTV services). Following sequence diagrams are only examples of services.
During initial power-on, the CSPG-CI+ and the OITF mutually authenticate each other using the CI+ authentication mechanism. Figure 37 is an overview of the mechanism. For further detail, please refer to [CI+], section 6.
During initialization, if the CSPG-CI+ has stored authentication information, it only verifies that this authentication information is shared with the OITF. Figure 38 is an overview of the mechanism. For further detail, please refer to [CI+], section 6.
This appendix describes session setup sequences with CSPG-DTCP for following use cases:
Note that SIP messages over HNI-IGI (between OITF and IG) are delivered over HTTP as specified in [OIPF_PROT2].
Figure 43 describes session setup sequence for multicast streaming with SIP session management:
Figure 44 describes CSPG-DTCP initiated teardown sequence for multicast IPTV service. Note that OITF and Network initiated teardown sequences are the same as defined in [OIPF_PROT2]:
Figure 45 describes session setup sequence for unicast streaming with SIP session management:
Figure 46 describes session setup sequence for unicast streaming with RTSP session management:
Figure 47 describes session setup sequence for HTTP streaming and download:
As introduced in section 4.2, the CSP Gateway-Centric Approach allows for co-location of an embedded (virtual) CSPG in the same physical device that hosts the OITF. This is a purely conceptual approach that in practice facilitates that the embedded CSPG can terminate any chosen CA or DRM solution deployed in that device, for the reception of services that implement the chosen CA/DRM system. This appendix provides an informative description of the embedded CSPG approach.
The following deployments are possible implementations of OIPF specifications:
For a CSPG embedded in the same device as OITF, the following figure applies:
As shown on the figure above:
With the embedded (virtual) CSPG approach, there is no normatively specified interface between the OITF and CSPG. The DAE application communicates directly with the chosen CA/DRM solution using the common DRM agent communication API’s defined for the DAE [[.OIPF_DAE2] section 7.6. The embedded CSPG is not signalled as a CSPG implementation at all; all communications via the DRM agent API take place using the usual CA/DRM system identifier and DRM capability indication mechanisms, as described in section 4.2.2.
The following example shows the signaling for a device with both embedded (virtual) CSPG and (non-embedded) CSPG-CI+ capabilities as defined in section 9.3.10 DRM capability indication of [OIPF_DAE2].
Example:
<drm DRMSystemID="urn:dvb:casystemid:01535">TS_PF</drm> <drm DRMSystemID="urn:dvb:casystemid:12348" protectionGateways="ci+">TS_PF TTS_PF</drm>
For an embedded CSPG, the following interface mappings can be described:
The call flow in Figure 48 depicts an example of sequence for getting credential and applies when secure streaming of content is triggered by the end-user.
1. | The end-user browses the catalog and selects a content for playing. |
2. | The server provides DRMControlInformation associated to the content. |
3. | The DAE Application asks the DRM client to provide authentication means via the DAE API. Note that the full authentication sequence is not described here for simplification and because it is specific to the DRM implementation. |
4. | The DRM client replies to the requests via the DAE API. |
5. | The DAE Application requests credentials to the IPTV Application providing DRMControlInformation associated to the content and authentication means bound to the OITF DRM client. |
6. | The IPTV Application transmits the request to the DRM Server. |
7. | The DRM Server returns credentials to allow access to the content. |
8. | The IPTV Application returns the credentials to the DAE Application. Note: the retrieval of credentials could also be performed through a proprietary communication between the CSPG and the CSP-G Server. In this case the reply to DAE application in step 4 above is limited to an acknowledgement that credentials are available for play. |
9. | The DAE Application provides the credentials to the DRM Client via the DAE API. |
10. | The DRM client checks the credential and extracts the content key. The DRM client provides the content key to the Player. |
11. | The DAE Application triggers the streaming of the content. |
12. | The CDN streams the content to the OITF. The decryption process associated to the Player uses the content key to render the content in clear. |