HTTP Smooth Streaming (HSS)¶
Table of Contents
USP supports PlayReady DRM. The encryption is applied on-the-fly, so there is no preprocessing involved. The options for enabling encryptions are stored in the server manifest file.
Demo streams can be found in the Unified Streaming Demo.
Options for PlayReady¶
You can enable PlayReady encryption by providing the following options while creating the server manifest.
The 128 bits Key ID (KID) and 128 bits Content Encryption Key (CEK) are passed
--iss.key option where KID and CEK are separated by a colon,
The KID uniquely identifies the content. The CEK is the Content Encryption Key. Note this is NOT the PlayReady Key Seed, but the actual content encryption key.
Both KID and CEK must be coded in hex (base16).
The KID from a PlayReady License server may be formatted as a little-endian GUID. In that case you have to change the endianess as we always use a big-endian UUID representation of the KID.
The 64 bit AES Initialization Vector (IV). This is a random 64 bit value.
The key_iv is used 'as-is', so you must make sure to guarantee that it is unique when encrypting multiple tracks (the key_iv may be used only once with a certain CEK).
When no key_iv is provided one will be generated.
The URL used by the player to retrieve the key.
In the general case this option is not needed for PlayReady as the software generates a PlayReady Header Object from the given key information.
If you want to customize the PlayReady Header Object, for example for adding CUSTOMATTRIBUTES to the Rights Management Header then you can pass the complete PlayReady Header Object as a base64 encoded string.
Use the Webserver for on-the-fly PlayReady¶
The following command creates a VOD server manifest file with the key information embedded:
mp4split -o video.ism \ --iss.key=000102030405060708090a0b0c0d0e0f:000102030405060708090a0b0c0d0e0f \ --iss.key_iv=0001020304050607 \ --iss.license_server_url=http://www.example.com/rightsmanager.asmx \ video.ismv
The following command creates a Live server manifest file with the key information embedded:
mp4split -o channel1.isml --iss.key=000102030405060708090a0b0c0d0e0f:000102030405060708090a0b0c0d0e0f \ --iss.key_iv=0001020304050607 \ --iss.license_server_url=http://www.example.com/rightsmanager.asmx
Please note the different extension for the Live server manifest: '.isml'
Generating a ContentKey from a KeyId and KeySeed¶
If your license server does not give you a ContentKey, but only a KeyId and KeySeed then you may have to generate the ContentKey yourself. The ContentKey is derived from the KeyId and KeySeed and more information may be available in the technical specification 'PlayReady Header Object' document.