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 CodeMessageDescriptionMDRM Error Code
400Invalid key length; must be either 16, 24 or 32 bytes, 128/192/256 bitsThe key length does not match one of the predefined byte lengths.MDRM-805
400Encryption context is invalidMDRM-812
401Authorization token is requiredThe request is missing an internal authorization token.MDRM-801
401Failed to verify JSON web token; unauthorizedThe JWT is invalid or unauthorized.MDRM-802
401Failed to decode JSON web token; malformedThe JWT is invalid or unauthorized.MDRM-810
404Failed to resolve encryption key for organizationThe key was either missing from the database or could not be retrieved.MDRM-803
404Unable to retrieve requested leaf keyNo 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
500An unexpected error occurred while processing the requestGeneric error.MDRM-800
500Failed to generate leaf encryption keyAn error occurred when trying to create a new leaf encryption key in the database for the encryption context.MDRM-804
500Failed to derive encryption keyThe derivation of the encryption key failed and a key was not returned to the client for decryption.MDRM-807
500An error occurred while retrieving leaf key from the databaseThe leaf key could not be found in the database.MDRM-808
500An error occurred while creating leaf key in the databaseThe leaf key was not found in the cache and the operation failed when trying to create a new one in the database.MDRM-809
500Unknown derivation method for leaf keyThe derivation method does not match one of the supported internal methods.MDRM-811