Client Status Codes: Verimatrix Key Manager

The below table provides the status codes and their descriptions, expected UI behavior (if applicable), and comments to include if you report the error to Verimatrix Customer Care.

HTTP Error Code

Message

Description

MDRM Error Code

400

Invalid key length; must be either 16, 24 or 32 bytes, 128/192/256 bits

The key length does not match one of the predefined byte lengths.

MDRM-805

400

Encryption context is invalid

MDRM-812

401

Authorization token is required

The request is missing an internal authorization token.

MDRM-801

401

Failed to verify JSON web token; unauthorized

The JWT is invalid or unauthorized.

MDRM-802

401

Failed to decode JSON web token; malformed

The JWT is invalid or unauthorized.

MDRM-810

404

Failed to resolve encryption key for organization

The key was either missing from the database or could not be retrieved.

MDRM-803

404

Unable to retrieve requested leaf key

No content key was found for the organization and subject signaled in the JWT during a license request. This can happen when organizations have multiple accounts and sign the JWT using a service access key from the wrong account, or when they signal the wrong subject in the JWT.

This error code returned by VKM to the Widevine, Fairplay, and Playready Services result the following errors returned to the client:

  • Widevine - MDRM-717
  • Fairplay - MDRM-1011
  • PlayReady - MDRM 1110

MDRM-806

500

An unexpected error occurred while processing the request

Generic error.

MDRM-800

500

Failed to generate leaf encryption key

An error occurred when trying to create a new leaf encryption key in the database for the encryption context.

MDRM-804

500

Failed to derive encryption key

The derivation of the encryption key failed and a key was not returned to the client for decryption.

MDRM-807

500

An error occurred while retrieving leaf key from the database

The leaf key could not be found in the database.

MDRM-808

500

An error occurred while creating leaf key in the database

The leaf key was not found in the cache and the operation failed when trying to create a new one in the database.

MDRM-809

500

Unknown derivation method for leaf key

The derivation method does not match one of the supported internal methods.

MDRM-811