DRMToday

Overview

Bradmax player supports integration with DRMToday DRM provider (castLabs). From player perspective it is matter of passing right configuration.

Your web server has to generate custom data for user, who need access to selected media. It will be used as “pass” for License server for obtaining license. With this license, player will be able to decode encrypted video.

For more details how to generate custom data please contact with DRMToday.

Configuration

For correct playback player needs:

  • Custom data (dt-custom-data) encoded as base64 string
  • PlayReady license server URL
  • Widevine license server URL
  • FairPlay license server URL
  • FairPlay license server certificate URL

Player adds custom data on every license request as dt-custom-data HTTP header, so license server can verify user session.

DRM configuration object

You need to prepare drm configuration object and set it for each media source object . Each media source points to single HLS, MPEG-DASH, MSSmoothStreaming stream. drm object specification:

Field nameTypeDescription
providerstringKey defining provider. For DRMToday should be “drmtoday”.
playreadyobjectPlayReady configuration object. See keys below.
playready.laUrlstringURL address for PlayReady license server.
playready.customDatastringCustom data (dt-custom-data) encoded as base64 string.
widevineobjectWidevine configuration object. See keys below.
widevine.laUrlstringURL address for Widevine license server.
widevine.customDatastringCustom data (dt-custom-data) encoded as base64 string.
widevine.audioRobustnessstringRobustness level for DRM. Default: SW_SECURE_CRYPTO
widevine.videoRobustnessstringRobustness level for DRM. Default: SW_SECURE_CRYPTO
fairplayobjectFairPlay configuration object. See keys below.
fairplay.laUrlstringURL address for FairPlay license server.
fairplay.certUrlstringURL address for FairPlay license server certificate.
fairplay.customDatastringCustom data (dt-custom-data) encoded as base64 string.

Example

// DRM configuration.
var drmCustomDataBase64Encoded = "eyJtZXJjaGFudCI6IjI4MDNlZjgwLTY3ZDgtNDNkNC04ZTcxLWRkZmFlOWNhNGFiZCIsInNlc3Npb25JZCI6Ii4uLiIsInVzZXJJZCI6NzMwfQ==";
var drmConfig = {
    "provider": "drmtoday",
    "playready": {
        "laUrl": "https://lic.drmtoday.com/license-proxy-headerauth/drmtoday/RightsManager.asmx",
        "customData": drmCustomDataBase64Encoded
    },
    "widevine": {
        "laUrl": "https://lic.drmtoday.com/license-proxy-widevine/cenc/?specConform=true",
        "customData": drmCustomDataBase64Encoded
    },
    "fairplay": {
        "laUrl": "https://lic.drmtoday.com/license-server-fairplay/cenc/",
        "customData": drmCustomDataBase64Encoded,
        "certUrl": "https://lic.drmtoday.com/license-server-fairplay/cert/<merchant>"
    }
};

// Setting DRM configuration into player dataProvider object.
var options = {
    "dataProvider": {
        "source": [
            {
                "url": "https://cdn.example.com/g180-avc_a2.0-vbr-aac-128k/r30/dash-wv-pr/stream.mpd",
                "drm": drmConfig
            },
            {
                "url": "https://cdn.example.com/g180-avc_a2.0-vbr-aac-128k/r30/hls-fp/master.m3u8",
                "drm": drmConfig
            }
        ],
        "duration": 718,
        "title": "DRM Demo",
        "splashImages": [
            {
                "url": "https://example.com/startsplash.jpg"
            }
        ]
    }
};
var element = document.getElementById("player");
window.bradmax.player.create(element, options);