Skip to main content

How to issue license

In order to obtain a license, the player should make a POST request to one of the endpoints (depending on the DRM system supported by the device or the browser):

  • Widevine
  • FairPlay
  • Playready

Please check platform compatibility to see which DRM system is required in your case.

Acquisition sequence

If the video player supports DRM, it generates license acquisition event automatically when starting playing DRM encrypted content. Typically, the video player has to be configured with license acquisition URL. The player sends POST request to license acquisition URL. The body of the license request contains payload (or "license challenge") - this payload contains cryptographic data neccessary to create encrypted license. DRM enabled player creates this payload data automatically. The only configuration the player needs is License Acquisition URL, and (in some cases, see below) HTTP headers for authorizating the request.

License acquisition sequence is presented in the diagram below: Licence Acquisition

In the body of the request, the player should place the payload generated by the DRM component of your platform. This payload is automatically attached to the body of license request by most players, no additionall code is required.

Additionally, two parameters are required to authenticate the license request:

  1. BrandGuid - an identifier of your application. This identifier is created by Insys VT and identifies the video services. BrandGuid can be passed as a querystring parameter of the license acquisition URL or in a custom HTTP header X-Drm-BrandGuid. For a FairPlay certificate endpoint, BrandGuid should be placed in a querystring.
  2. UserToken - a JWT token signed with a shared secret that authorizes a given license request. The token should be created and signed in your backend service. The secret key used for token signing should not be used on the frontend side. UserToken can be passed as a querystring parameter of the license acquisition URL or in a custom HTTP header X-Drm-UserToken. The token is not required for a FairPlay certificate request.

Integration parameters

Your dedicated endpoints (License Acquisition URLs) and all parameters for integration can be found in web console. Please login to Cloud Video Kit web console and navigate to DRM -> Configuration -> License acquisition

Licence Acquisition Parameters

FairPlay Streaming Certificate

To use FairPlay on production, you need to generate a FairPlay Streaming Certificate via Apple platform and share it with us. For testing purposes we give you a temporary FPS Certificate, that has to be replaced by your Certificate before you go live. You can find the URL to FPS Certificate attached to your tenant at web console. Please navigate to DRM -> Configuration -> License acquisition -> Fairplay Certificate.

Read more about FPS and how to generate your certificate here.