Skip to main content

Managing Widevine Data Sets

Axinom License Service Management API allows you to manage Widevine Service Certificates (Widevine Data Sets) that are used when issuing Widevine DRM licenses.

By default it is not necessary to manage Widevine Service Certificates, as the Axinom License Service automatically handles the creation and renewal of these certificates. However, there can be cases when it's desirable to configure and manage your Widevine Server Certificate(s) manually.

One of the cases is when you intend to balance load between two (or more) DRM service providers (you may want to do this for different reasons, e. g. to improve fail-safety or optimize request/response latency). Two Widevine services with different certificates can break playback. Here is why: When you place two unrelated Widevine DRM providers (say, Provider A and Provider B) behind a load balancer, the Widevine DRM license interactions with end users' browsers look like this:

  1. the browser sends a certificate request which the load balancer randomly forwards to either Provider A or Provider B
  2. the provider responds with its certificate
  3. the browser creates a license request which is cryptographically bound to the certificate it received
  4. the browser sends the license request and the load balancer randomly forwards it to either Provider A or Provider B
  5. if the certificate request and the subsequent license request were handled by different providers, the license request will fail because it is bound to a certificate that the provider does not recognize

Unless you have some "intelligence" in your load balancer that routes the certificate request and the license request to the same provider, your users will run into playback issues.

The obvious solution, which even works with any naive load balancer, is to configure the two providers with the same Widevine Service Certificate.

The /WidevineDataSets endpoint serves the purpose of managing Widevine Service Certificates (Widevine Data Sets). It allows you to create, update, and delete Widevine Data Sets, which are used by the Axinom License Service to issue Widevine DRM licenses.

For details about API requests and responses please refer to the management API help page at

https://drm-management.axprod.net/api/Help#WidevineDataSets