SPEKE API v2.1 - DASH-IF 仕様のカスタマイズと制約

SPEKE は、エンクリプタコンシューマーのワークフローに従います。

暗号化されたコンテンツキーの場合、SPEKE により次の制限が適用されます。

SPEKE は CPIX 機能のサブセットのみを使用します。

SPEKE v2.1 と交換される CPIX ドキュメントでは、標準ペイロードコンポーネントページまたは暗号化契約ページで「サポートされている」として参照される要素または属性のみを使用できます。

すべての要素および属性は、エンクリプタが CPIX リクエストに含めている場合、キープロバイダーの CPIX レスポンスで有効な値を保持します。そうでない場合、エンクリプタは停止してエラーをスローします。

SPEKE は KeyPeriodFilter 要素でキーローテーションをサポートします。SPEKE は ContentKeyPeriod@indexを使用してキー期間を追跡します。SPEKE v2.1 では、エンクリプタは に加えて、キー期間がカバーする時間間隔を通知することもできます@index。ライブコンテンツの場合は、 属性ContentKeyPeriod@startと ContentKeyPeriod@end 属性 (ウォールクロックの開始時刻と終了時刻) を使用します。VOD コンテンツの場合は、 属性ContentKeyPeriod@startOffsetと ContentKeyPeriod@endOffset 属性を使用します。

HLS シグナリングでは、複数のDRMSystem.HLSSignalingData要素を使用する必要があります。1 つはDRMSystem.HLSSignalingData@playlist属性値が「media」で、もう 1 つはDRMSystem.HLSSignalingData@playlist属性値が「master」です。

キーをリクエストするとき、エンクリプタは、ContentKey 要素にオプションの @explicitIV 属性を使用することがあります。キープロバイダーは、属性がリクエストに含まれていなくても、@explicitIV を使用して IV で応答することができます。

エンクリプタはキー識別子 (KID) を生成しますが、これは与えられたコンテンツ ID とキー期間に対して同じです。キープロバイダーには、リクエストドキュメントに対するレスポンスとして KID が含まれます。

エンクリプタは CPIX@contentId 属性の値を含めます。この属性の空の値を受け取ると、キープロバイダーは「CPIX@contentId の欠落」という説明のエラーを返します。キープロバイダーはCPIX@contentId値を上書きできません。

CPIX@id 値が null でない場合は、キープロバイダーによって無視されます。

エンクリプタは CPIX@version 属性の値を含めます。この属性に空の値を受け取ると、キープロバイダーは「Missing CPIX@version」(CPIX@version がありません) という説明を含むエラーを返します。サポートされていないバージョンのリクエストを受け取った場合、キープロバイダーから返されるエラーの説明は「Unsupported CPIX@version」(サポートされていない CPIX@version です) になります。

CPIX@version 値はキープロバイダーによって上書きできません。

エンクリプタは、リクエストされたキーごとに ContentKey@commonEncryptionScheme 属性の値を含めます。この属性に空の値を受け取ると、キープロバイダーは「Missing ContentKey@commonEncryptionScheme for KID id」(KID id の ContentKey@commonEncryptionScheme がありません) という説明を含むエラーを返します。

一意の CPIX ドキュメントでは、異なる ContentKey@commonEncryptionScheme 属性に複数の値を混在させることはできません。このような組み合わせを受信すると、キープロバイダーは「Non compliant ContentKey@commonEncryptionScheme combination」(非準拠の ContentKey @commonEncryptionScheme の組み合わせがあります) という説明を含むエラーを返します。

すべての ContentKey@commonEncryptionScheme 値がすべての DRM テクノロジと互換性があるわけではありません。このような組み合わせを受信すると、キープロバイダーは「ContentKey@commonEncryptionScheme non compatible with DRMSystem id」(ContentKey@commonEncryptionScheme は DRMSystem id と互換性がありません) という説明を含むエラーを返します。

ContentKey@commonEncryptionScheme 値はキープロバイダーによって上書きできません。

CPIX レスポンス本文で DRMSystem@PSSH と DRMSystem.ContentProtectionData innerXML <pssh> 要素に異なる値を受け取った場合、エンクリプタは停止してエラーをスローします。

キープロバイダーは、X-Speke-User-Agent HTTP レスポンスヘッダーの値を含めます。

SPEKE 準拠のエンクリプタはクライアントとして機能し、POST オペレーションをキープロバイダーエンドポイントに送信します。

エンクリプタには、X-Speke-VersionHTTP リクエストヘッダーの値を含める必要があります。リクエストで使用される SPEKE バージョンは、SPEKE v2.1 の '2.1' のように MajorVersion.MinorVersion, として定式化されます。キープロバイダーがエンクリプタによって使用される SPEKE バージョンを現在のリクエストでサポートしていない場合、キープロバイダーは「Unsupported SPEKE version」(サポート対象外の SPEKE バージョン) という説明を含むエラーを返し、ベストエフォートベースでの CPIX ドキュメントの処理を試行しません。

キープロバイダーは、エンクリプタによって定義された X-Speke-Version ヘッダー値をリクエストへのレスポンスで変更できません。

レスポンス本文でエラーを受信すると、エンクリプタはエラーをスローし、SPEKE v1.0 のバージョニングでリクエストを再試行しません。

キープロバイダーがエラーを返さないものの、必須情報を含む CPIX ドキュメントを返さない場合、エンクリプタは停止してエラーをスローする必要があります。