View a markdown version of this page

SPEKE API v2.1 - Secure Packager and Encoder Key Exchange API Specification

SPEKE API v2.1

This is the REST API for Secure Packager and Encoder Key Exchange (SPEKE) v2.1. Use this specification to provide DRM copyright protection for customers who use encryption. To be SPEKE-compliant, your DRM key provider must expose the REST API described in this specification. The encryptor makes API calls to your key provider.

Note

The code examples in this specification are for illustration purposes only. You can’t run the examples because they aren’t part of a complete SPEKE implementation.

SPEKE v2.1 is a minor revision of SPEKE v2.0 that aligns with the DASH Industry Forum CPIX 2.4 specification on the DASH-IF website. A SPEKE v2.1 request is a SPEKE v2.0 request with the additions described in Changes from SPEKE v2.0. All SPEKE v2.0 behavior that is not listed as a change applies to SPEKE v2.1 without modification.

As with SPEKE v2.0, the X-Speke-Version HTTP request header indicates the version on the SPEKE side. The CPIX@version attribute indicates the version on the CPIX side. For SPEKE v2.1, the encryptor sends X-Speke-Version value 2.1 and CPIX@version value 2.4. If the key provider does not support the SPEKE version used by the encryptor, it returns an error with description 'Unsupported SPEKE version' and does not process the CPIX document.

Topics