HTTP Smooth Streaming (HSS)

Table of Contents

PlayReady DRM

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.

--iss.key

The 128 bits Key ID (KID) and 128 bits Content Encryption Key (CEK) are passed with the --iss.key option where KID and CEK are separated by a colon, e.g. --iss.key=KID:CEK

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).

Note

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.

--iss.key_iv

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.

--iss.license_server_url

The URL used by the player to retrieve the key.

--iss.drm_specific_data

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

VOD Example

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

Live Example

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.