Using castLabs to deliver Widevine licenses to Azure Media Services
This article describes how you can use Azure Media Services (AMS) to deliver a stream that is dynamically encrypted by AMS with both PlayReady and Widevine DRMs. The PlayReady license comes from Media Services PlayReady license server and Widevine license is delivered by castLabs license server.
The following diagram demonstrates a high-level Azure Media Services and castLabs integration architecture.
Typical system set up
- Media content is stored in AMS.
- Key IDs of content keys are stored in both castLabs and AMS.
- castLabs and AMS both have token authentication built in. The following sections discuss authentication tokens.
- When a client requests to stream the video, the content is dynamically encrypted with Common Encryption (CENC) and dynamically packaged by AMS to Smooth Streaming and DASH. We also deliver PlayReady M2TS elementary stream encryption for HLS streaming protocol.
- PlayReady license is retrieved from AMS license server and Widevine license is retrieved from castLabs license server.
- Media Player automatically decides which license to fetch based on the client platform capability.
Authentication token generation for getting a license
Both castLabs and AMS support JWT (JSON Web Token) token format used to authorize a license.
JWT token in AMS
The following table describes JWT token in AMS.
|Issuer||Issuer string from the chosen Secure Token Service (STS)|
|Audience||Audience string from the used STS|
|Claims||A set of claims|
|NotBefore||Start validity of the token|
|Expires||End validity of the token|
|SigningCredentials||The key that is shared among PlayReady License Server, castLabs License Server and STS, it could be either symmetric or asymmetric key.|
JWT token in castLabs
The following table describes JWT token in castLabs.
|optData||A JSON string containing information about you.|
|crt||A JSON string containing information about the asset, its license info and playback rights.|
|iat||The current datetime in epoch.|
|jti||A unique identifier about this token (every token can only be used once in the castLabs system).|
Sample solution setup
The sample solution consists of two projects:
- A console app that can be used to set DRM restrictions on an already ingested asset, for both PlayReady and Widevine.
- A Web Application that hands out tokens, which could be seen as a VERY SIMPLIFIED version of an STS.
To use the console application:
Change the app.config to setup AMS credentials, castLabs credentials, STS configuration and shared key.
Upload an Asset into AMS.
Get the UUID from the uploaded Asset, and change Line 32 in the Program.cs file:
var objIAsset = _context.Assets.Where(x => x.Id == "nb:cid:UUID:dac53a5d-1500-80bd-b864-f1e4b62594cf").FirstOrDefault();
Use an AssetId for naming the asset in the castLabs system (Line 44 in the Program.cs file).
You must set AssetId for castLabs; it needs to be a unique alphanumeric string.
Run the program.
To use the Web Application (STS):
- Change the web.config to setup castlabs merchant ID, the STS configuration and the shared key.
- Deploy to Azure Websites.
- Navigate to the website.
Playing back a video
To play back a video encrypted with common encryption (PlayReady and/or Widevine), you can use the Azure Media Player. When running the console app, the Content Key ID and the Manifest URL are echoed.
Open a new tab and launch your STS: http://[yourStsName].azurewebsites.net/api/token/assetid/[yourCastLabsAssetId]/contentkeyid/[thecontentkeyid].
Go to Azure Media Player.
Paste in the streaming URL.
Click the Advanced Options checkbox.
In the Protection dropdown, select PlayReady and/or Widevine.
Paste the token that you got from your STS in the Token textbox.
The castLab license server does not need the “Bearer=” prefix in front of the token. So please remove that before submitting the token.
Update the player.
The video should be playing.
Media Services learning paths
Media Services v3 (latest)
Check out the latest version of Azure Media Services!
Media Services v2 (legacy)
Use the User Voice forum to provide feedback and make suggestions on how to improve Azure Media Services. You also can go directly to one of the following categories: