Axinom DRM License Service Message is a JSON data structure designed to deliver data to and from an Axinom DRM License Service. Learn how Entitlement Message is transfered inside the License Service Message.

License Service Message

Axinom DRM License Service Message is a JSON data structure designed to deliver data to and from an Axinom DRM License Service. Axinom DRM License Service Message is used to encapsulate inner messages defined in the context of Axinom DRM. An Axinom DRM License Service Message shall be encoded into a JSON Web Token (JWT) before delivery. The signing algorithm and signing key to be used when encoding an Axinom DRM License Service Message into a JSON Web Token are HMAC-SHA256 and the Key of a Communication Key, respectively.

Delivery

An Axinom DRM License Service Message shall be delivered to Axinom DRM License Service in exactly one of the following:

  • The "X-AxDRM-Message" HTTP header.

  • The "AxDrmMessage" HTTP query string parameter.

    An example of a license acquisition URI where the license service message is provided in the query string:

https://drm-widevine-licensing.axtest.net/AcquireLicense?AxDrmMessage=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.
eyJ2ZXJzaW9uIjoxLCJjb21fa2V5X2lkIjoiNjllNTQwODgtZTllMC00NTMwLThjMWEtMWViNmRjZDBkMTRl
iwiZXhwaXJhdGlvbl9kYXRlIjoiMjAyMC0wMS0wMSIsIm1lc3NhZ2UiOnsidmVyc2lvbiI6MiwidHlwZSI6I
VudGl0bGVtZW50X21lc3NhZ2UiLCJjb250ZW50X2tleXNfc291cmNlIjp7ImlubGluZSI6W3siaWQiOiIyMT
hYzFkYy1jOGEyLTQ1NzUtYmFmNy1mYTRiYTU2YzM4YWMifV19fX0.
LbK1pATJaFJFnPhs-IiuEdj7IVsZaBIv3kwYwQgw0-U
  • The Custom Data part of a PlayReady License Request (PlayReady only).

An Axinom DRM License Service Message delivered from Axinom DRM License Service shall always be in the "X-AxDRM-Message" HTTP header.

Structure

The following is the structure of Axinom DRM License Service Message.

The structure of an Axinom DRM License Service Message.
{
    "version" : 1,

    "begin_date": "2015-08-18T15:22:40+03:00",

    "expiration_date": "2015-08-18T15:22:40+03:00",

    "com_key_id" : "cc36e85d-2fdf-462c-b395-030907447afc",

    "message" :
    {
        "type" : ...

        ...
    }
}

begin_date

The begin_date field refers to the begin date of an Axinom DRM License Service Message. It indicates the date when the Axinom DRM License Service Message becomes active. The License Service rejects a message that is not active.

Required

No.

Default value

None.

Data type

String.

Supported values

Any string that represents a combined date and time value in the ISO 8601 format (time zones are supported as well), for example: "2015-08-18T15:22:40+03:00").

com_key_id (Communication Key ID)

The com_key_id field indicates the ID of the Communication Key that was used to sign an Axinom DRM License Service Message. The License Service rejects a message that has an invalid signature.

Required

Yes.

Data type

String.

Supported values

Any string representation of a valid GUID in the 00000000-0000-0000-0000-000000000000 format.

expiration_date

The expiration_date field refers to the expiration date of an Axinom DRM License Service Message. It indicates the date when the Axinom DRM License Service Message becomes inactive. The License Service rejects a message that is not active.

Required

No.

Default value

None.

Data type

String.

Supported values

Any string that represents a combined date and time value in the ISO 8601 format (time zones are supported as well), for example: "2015-08-18T15:22:40+03:00").

message

The message field refers to the inner message encapsulated by an Axinom DRM License Service Message. It contains an object that represents an inner message defined in the context of Axinom DRM.

Required

Yes.

Data type

Object.

Supported values

Any object that represents a message of the following types:

* Entitlement Message - a message that instructs the License Service how to construct a License.

version

The version field refers to the version of an Axinom DRM License Service Message. It indicates the version of an Axinom DRM License Service Message.

Required

Yes.

Data type

Integer.

Supported values

1

Revision History

The table below outlines and describes the different versions of this document.

Version Date Description

1.0

July 26, 2016

  • Initial version.

2.0

January 27, 2020

  • Axinom DRM License Server Message renamed to Axinom DRM License Service message.

  • New delivery option: "AxDrmMessage" HTTP query parameter.