Widevine ライセンステンプレートを使用した Media Services v3 の概要

[アーティクル]
07/12/2023

Azure Media Services では、Google Widevine を使用してコンテンツを暗号化できます。 Media Services も Widevine ライセンスを提供するサービスを提供しています。 Azure Media Services API を使用すると、Widevine ライセンスを構成できます。プレーヤーが Widevine の保護されたコンテンツを再生しようとすると、ライセンスを取得する要求がライセンス配信サービスに送信されます。ライセンスサービスが要求を承認すると、サービスがライセンスを発行します。これはクライアントに送信され、指定されたコンテンツの復号化と再生に使用されます。

Note

Widevine は、GovCloud リージョンでは使用できません。

Widevine ライセンス要求の形式は、JSON メッセージです。

{
    "payload":"<license challenge>",
    "content_id": "<content id>"
    "provider": "<provider>"
    "allowed_track_types":"<types>",
    "content_key_specs":[
        {
            "track_type":"<track type 1>"
        },
        {
            "track_type":"<track type 2>"
        },
        …
    ],
    "policy_overrides":{
        "can_play":<can play>,
        "can persist":<can persist>,
        "can_renew":<can renew>,
        "rental_duration_seconds":<rental duration>,
        "playback_duration_seconds":<playback duration>,
        "license_duration_seconds":<license duration>,
        "renewal_recovery_duration_seconds":<renewal recovery duration>,
        "renewal_server_url":"<renewal server url>",
        "renewal_delay_seconds":<renewal delay>,
        "renewal_retry_interval_seconds":<renewal retry interval>,
        "renew_with_usage":<renew with usage>
    }
}

Note

値のない "{}" だけの空のメッセージを作成できます。その後、ライセンステンプレートが既定値で作成されます。ほとんどの場合、既定値で問題ありません。 Microsoft に基づくライセンス配信シナリオでは常に既定値が使用されます。 "provider" 値と "content_id" 値を設定する必要がある場合、プロバイダーは Widevine 資格情報を照合する必要があります。

JSON メッセージ

名前	値	説明
payload	Base64 でエンコードされた文字列	クライアントから送信されたライセンス要求です。
content_id	Base64 でエンコードされた文字列	各 content_key_specs.track_type のキー ID およびコンテンツキーを取得するために使用される識別子です。
provider	string	コンテンツキーおよびポリシーを検索するために使用されます。 Microsoft キー配信が Widevine ライセンス配信に使用される場合、このパラメーターは無視されます。
policy_name	string	以前に登録されたポリシーの名前です。省略可能。
allowed_track_types	enum	SD_ONLY または SD_HD。どのコンテンツキーをライセンスに含めるかを制御します。
content_key_specs	JSON 構造体の配列。「コンテンツキーの仕様」セクションをご覧ください。	どのコンテンツキーを返すかについて、より細かく制御します。詳細については、「コンテンツキーの仕様」セクションを参照してください。allowed_track_types と content_key_specs の値の 1 つだけを指定できます。
use_policy_overrides_exclusively	ブール値、true または false	policy_overrides に指定されたポリシー属性を使用し、前に格納したポリシーをすべて除外します。
policy_overrides	JSON 構造体。「ポリシーのオーバーライド」セクションをご覧ください。	このライセンスのポリシー設定です。このアセットに事前定義されたポリシーがある場合、これらの指定された値が使用されます。
session_init	JSON 構造体。「セッションの初期化」セクションをご覧ください。	必要に応じて指定できるデータがライセンスに渡されます。
parse_only	ブール値、true または false	ライセンス要求は解析されますが、ライセンスは発行されません。ただし、応答でライセンス要求の値が返されます。

コンテンツキーの仕様

既存のポリシーが存在する場合は、"コンテンツキーの仕様" に値を指定する必要はありません。このコンテンツに関連付けられた既存のポリシーを使用して、HDCP (高帯域幅デジタルコンテンツ保護) および CGMS (Copy General Management System) など、出力の保護が決まります。既存のポリシーが Widevine ライセンスサーバーに登録されていない場合、コンテンツプロバイダーはライセンス要求に値を挿入できます。

use_policy_overrides_exclusively オプションに関係なく、各 content_key_specs 値がすべてのトラックに対して指定されている必要があります。

名前	値	説明
content_key_specs track_type	string	トラックの種類の名前です。ライセンス要求で content_key_specs が指定されている場合は、すべてのトラックの種類を明示的に指定します。指定しないと、直前の 10 秒間を再生できません。
content_key_specs security_level	uint32	再生に関するクライアントの堅牢性の要件を定義します。 - ソフトウェアベースのホワイトボックス暗号化が必須です。 - ソフトウェア暗号化と難読化デコーダーが必須です。 - キーマテリアルと暗号化の操作を、ハードウェアを基盤にした信頼できる実行環境で実行する必要があります。 - コンテンツの暗号化とデコードを、ハードウェアを基盤にした信頼できる実行環境で実行する必要があります。 - 暗号化、デコード、およびメディア (圧縮済みおよび圧縮解除済み) のすべての処理を、ハードウェアを基盤にした信頼できる実行環境で実行する必要があります。
content_key_specs required_output_protection.hdc	文字列、HDCP_NONE、HDCP_V1、HDCP_V2 のいずれか	HDCP が必須かどうかを示します。
content_key_specs key	Base64 でエンコードされた文字列	このトラックで使用するコンテンツキーです。指定した場合、track_type または key_id が必要です。コンテンツプロバイダーはこのオプションを使用して、Widevine ライセンスサーバーでキーを生成または検索する代わりに、このトラックのコンテンツキーを挿入できます。
content_key_specs.key_id	Base64 でエンコードされた文字列バイナリ、16 バイト	キーの一意識別子です。

ポリシーのオーバーライド

名前	値	説明
policy_overrides.can_play	ブール値、true または false	コンテンツの再生が許可されていることを示します。既定値は false です。
policy_overrides.can_persist	ブール値、true または false	オフラインで使用するために、ライセンスを非揮発性ストレージに保持できることを示します。既定値は false です。
policy_overrides.can_renew	ブール値、true または false	このライセンスの更新が許可されていることを示します。 true の場合、ライセンスの期間をハートビートにより延長できます。既定値は false です。
policy_overrides.license_duration_seconds	int64	この特定のライセンスの期間を示します。値 0 は、期間に制限がないことを示します。既定値は 0 です。
policy_overrides.rental_duration_seconds	int64	再生が許可されている期間を示します。値 0 は、期間に制限がないことを示します。既定値は 0 です。
policy_overrides.playback_duration_seconds	int64	ライセンス期間内の再生開始後の視聴期間です。値 0 は、期間に制限がないことを示します。既定値は 0 です。
policy_overrides.renewal_server_url	string	このライセンスのすべてのハートビート (更新) 要求を、指定した URL に転送します。このフィールドは、can_renew が true の場合にのみ使用されます。
policy_overrides.renewal_delay_seconds	int64	license_start_time から、最初に更新が試行されるまでの秒数です。このフィールドは、can_renew が true の場合にのみ使用されます。既定値は 0 です。
policy_overrides.renewal_retry_interval_seconds	int64	ライセンスの更新要求が失敗した場合の後続の要求までの遅延 (秒) を指定します。このフィールドは、can_renew が true の場合にのみ使用されます。
policy_overrides.renewal_recovery_duration_seconds	int64	ライセンスサーバーのバックエンドの問題が原因で、更新が試行されているがまだ成功していないときに、再生の継続が許可される期間です。値 0 は、期間に制限がないことを示します。このフィールドは、can_renew が true の場合にのみ使用されます。
policy_overrides.renew_with_usage	ブール値、true または false	使用が開始されたときに、更新のためにライセンスが送信されることを示します。このフィールドは、can_renew が true の場合にのみ使用されます。

セッションの初期化

名前	値	説明
provider_session_token	Base64 でエンコードされた文字列	このセッショントークンはライセンスに渡され、後続の更新に含まれます。セッショントークンは、セッションの範囲を超えて保持されません。
provider_client_token	Base64 でエンコードされた文字列	ライセンスの応答で返信されるクライアントトークンです。ライセンス要求にクライアントトークンが含まれる場合、この値は無視されます。クライアントトークンは、ライセンスセッションの範囲を超えて保持されます。
override_provider_client_token	ブール値、true または false	値が false で、ライセンス要求にクライアントトークンが含まれているときは、この構造体でクライアントトークンを指定している場合でも要求からのトークンが使用されます。 true の場合は、常に、この構造体で指定したトークンが使用されます。

その他のメモ

Widevine は Google Inc. によって提供されるサービスであり、Google Inc. の利用規約とプライバシーポリシーが適用されます。

ヘルプとサポート

質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。

Q & A
Stack Overflow。質問にタグを付けます azure-media-services。
@MSFTAzureMedia するか、@AzureSupport を使用してサポートを要求します。
Azure portalからサポートチケットを開きます。

Widevine ライセンス テンプレートを使用した Media Services v3 の概要