翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SPEKE API v2
<a name="the-speke-api-v2"></a>

これは、Secure Packager and Encoder Key Exchange (SPEKE) v2 用の REST API です。この仕様を使用して、暗号化を使用するお客様に DRM 著作権保護を提供します。SPEKE に準拠するには、DRM キープロバイダーがこの仕様で説明されている REST API を公開する必要があります。エンクリプタはキープロバイダーへ API コールを行います。

**注記**  
この仕様のコード例は、あくまでも説明用です。これらの例は完全な SPEKE 実装の一部ではないため、実行できません。

SPEKE は、DASH Industry Forum Content Protection Information Exchange Format (DASH-IF-CPIX) データ構造定義をキー交換に使用しますが、いくつかの制限があります。DASH-IF-CPIX は、DRM プラットフォームからエンクリプタへの拡張可能なマルチ DRM 交換を提供するスキーマを定義します これにより、コンテンツの圧縮およびパッケージング時に、すべての適応ビットレートパッケージング形式のコンテンツ暗号化が可能になります。適応ビットレートパッケージ形式には、HLS、DASH、および MSS があります。

バージョン 2.0 以降、SPEKE は特定の CPIX バージョンに合わせて調整されます。

SPEKE 側では、これは `X-Speke-Version` HTTP ヘッダーを使用して適用され、CPIX 側では `CPIX@version` 属性を使用して適用されます。リクエストにこれらの要素が欠落していることは、SPEKE v1 レガシーワークフローでは一般的です。SPEKE v2 ワークフローでは、キープロバイダーが両方のバージョンパラメータをサポートしている場合にのみ CPIX ドキュメントを処理することが想定されます。

交換形式の詳細については、DASH Industry Forum の [CPIX 2.3 仕様](https://dashif.org/docs/CPIX2.3/Cpix.html)を参照してください。

大まかに、SPEKE v2.0 は SPEKE v1.0 と比較して以下の進化を遂げました。
+ SPEKE XML 名前空間のすべてのタグは、CPIX XML 名前空間内の同等のタグを優先して非推奨になりました。
+  `SPEKE:ProtectionHeader` は非推奨であり、`CPIX:DRMSystem.SmoothStreamingProtectionHeaderData` に置き換えられます 
+  `CPIX:URIExtXKey`、`SPEKE:KeyFormat`、および `SPEKE:KeyFormatVersions` は非推奨であり、`CPIX:DRMSystem.HLSSignalingData` に置き換えられます 
+  `CPIX@id` は `CPIX@contentId` に置き換えられます 
+ 新しい必須の CPIX 属性: `CPIX@version`、`ContentKey@commonEncryptionScheme`
+ 新しいオプションの CPIX 要素: `DRMSystem.ContentProtectionData` 
+ 複数のコンテンツキーのサポート
+ SPEKE と CPIX 間のクロスバージョン管理メカニズム
+ HTTP ヘッダーの進化: 新しい `X-Speke-Version` ヘッダー、`Speke-User-Agent` ヘッダーが `X-Speke-User-Agent` に名前変更 
+ ハートビート API の非推奨

SPEKE v1.0 の仕様は変更されないため、SPEKE v1.0 ワークフローを継続してサポートするために既存の実装を変更する必要はありません。

**Topics**
+ [SPEKE API v2 - DASH-IF 仕様のカスタマイズと制約](speke-constraints-v2.md)
+ [SPEKE API v2 - 標準ペイロードコンポーネント](standard-payload-components-v2.md)
+ [SPEKE API v2 - 暗号化契約](encryption-contract-v2.md)
+ [SPEKE API v2 - ライブワークフローメソッド呼び出しの例](live-workflow-methods-v2.md)
+ [SPEKE API v2 - VOD ワークフローメソッド呼び出しの例](vod-workflow-method-v2.md)
+ [SPEKE API v2 - コンテンツキーの暗号化](content-key-encryption-v2.md)
+ [SPEKE API v2 - キー識別子のオーバーライド](kid-override-v2.md)