コンテンツ保護のシナリオベースの移行ガイダンス

  • [アーティクル]

移行ガイドのロゴ

移行の手順 2

重要

V2 API の廃止は Azure Media Services の廃止と一致するため、Azure Media Service v2 から v3 に移行する必要はなくなりました。 詳細については、 Azure Media Services の提供終了ガイド を参照してください。

この記事では、v2 API から新しい Azure Media Services v3 API にコンテンツ保護を移行するユースケースに関する詳細とガイダンスを提供します。

v3 API でのコンテンツの保護

具体的な手順については、この記事の最後に記載されている「コンテンツ保護の概念、チュートリアル、およびハウツー ガイド」をご覧ください。

Note

この記事の残りの部分では、v2 コンテンツ保護を .NET で v3 に移行する方法について説明します。 別の言語または方法の手順やサンプル コードが必要な場合は、このページの GitHub の問題を作成してください。

スタンドアロン ライセンス配信サーバー (ハイブリッド オンプレミス モード) としての AMS の廃止

v3 API は、コンテンツ保護のスタンドアロン機能としてのキー配信サービスの使用をサポートしなくなりました。キー配信サービスは、他のサード パーティ配信元サーバーを通じてストリーミングまたは配信されるコンテンツのライセンス配信に使用できます。 つまり、AMS は V3 API によるキー配信のみのシナリオをサポートしなくなり、v3 を使用して配信する場合は、ダイナミック パッケージ化と暗号化を使用して AMS 配信元サービスからストリーミングする必要があります。

v2 API で暗号化され、"ハイブリッド" モデルで配信される既存のコンテンツは引き続き機能しますが (キーはデータ プレーンで引き続き取得可能です)、v2 管理プレーンまたは v3 管理プレーンを介したこれらのキーの管理 (更新と編集) は、2024 年 2 月 29 日以降機能しなくなります。

注意

v3 を使用して配信されるすべての新しいコンテンツは、AMS からのコンテンツ保護とストリーミングのみをサポートし、"ハイブリッド" モードをサポートしなくなりました。 データ プレーンでは、v2 で作成された既存のキーとライセンスが引き続き配信されますが、v2 または v3 API を使用した管理または更新はサポートされなくなります。

v2 資産、StreamingLocators、およびプロパティの v3 可視性

v2 API では、Assets、StreamingLocators、および ContentKeys を使用して、ストリーミング コンテンツが保護されていました。 v3 API に移行すると、v2 API の Assets、StreamingLocators、および ContentKeys がすべて v3 API に自動的に公開され、そのすべてのデータにアクセスできるようになります。

v2 で作成された v2 エンティティのプロパティを、v3 API を使用して更新することはできません。

v2 エンティティに格納されているコンテンツを更新、変更、または修正する必要がある場合は、v2 API を使用して更新するか、新しい v3 API エンティティを作成してそれらを移行してください。

資産識別子の違い

移行するには、v2 資産からプロパティまたはコンテンツ キーにアクセスする必要があります。 v2 API では AssetId をプライマリ ID キーとして使用しますが、新しい v3 API ではエンティティの Azure Resource Management 名をプライマリ ID として使用することを理解するのが重要です。 (v2 Asset.Name プロパティは一意の識別子として使用されません。) v3 API を使用すると、v2 資産名は Asset.Description として表示されるようになりました。

たとえば、以前に ID が nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8 の v2 資産がある場合、識別子は GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8 の末尾になります。 これは、v3 API を使用して v2 資産を一覧表示するときに表示されます。

v2 API を使用して作成および発行されたすべての資産には、v3 API では ContentKeyPolicy と ContentKey の両方が存在し、StreamingPolicy の既定のコンテンツ キー ポリシーは使用されません。

詳細については、コンテンツ キー ポリシーのドキュメントと ストリーミング ポリシーのドキュメントをご覧ください。

Azure Media Services Explorer (AMSE) v2 と AMSE v3 ツールをサイドバイサイドで使用する

v2 Azure Media Services Explorer ツールと v3 Azure Media Services Explorer ツールを一緒に使用すると、v2 API を使用して作成および公開された資産のデータを横並びで比較することができます。 プロパティはすべて表示されるはずですが、場所は変わります。

.NET コンテンツ保護移行のサンプルを使用する

Media Services コード サンプルでは、ContentProtection の下にある v2tov3MigrationSample を使用して、資産識別子の違いを比較するコード サンプルを見つけることができます。

ストリーミング ロケーターを一覧表示する

v2 API で作成された資産に関連付けられた StreamingLocators は、Asset エンティティで新しい v3 メソッド ListStreamingLocators を使用してクエリできます。 また、ListStreamingLocatorsAsync の .NET クライアント SDK バージョンを参照します。

ListStreamingLocators メソッドの結果、StreamingPolicyName と共にロケーターの Name と StreamingLocatorId が提供されます。

コンテンツ キーを検索する

StreamingLocators ととも使用される ContentKeys を検索するには、StreamingLocator.ListContentKeysAsync メソッドを呼び出すことができます。

v3 API でのコンテンツ保護の詳細については、「Media Services 動的暗号化を使用してコンテンツを保護する」の記事を参照してください。

同じ ContentKey を維持したまま v2 ContentKeyPolicy を変更する

まず、v2 SDK を使用して、資産で発行の取り消し (すべてのストリーミング ロケーターを削除) をする必要があります。 次に手順を示します。

  1. ロケーターを削除します。
  2. ContentKeyAuthorizationPolicy のリンクを解除します。
  3. AssetDeliveryPolicy のリンクを解除します。
  4. ContentKey のリンクを解除します。
  5. ContentKey を削除します。
  6. 必要な特定のコンテンツ キー ID とキー値を指定して、v3 StreamingPolicy と ContentKeyPolicy を使用して、新しい StreamingLocator を v3 で作成します。

Note

v3 API を使用して v2 のロケーターを削除することはできますが、この操作によって、使用されるコンテンツ キーおよびコンテンツ キー ポリシーが (これらが v2 API で作成された場合) 削除されるわけではありません。

コンテンツ保護の概念、チュートリアル、およびハウツー ガイド

概念

チュートリアル

クイック スタート:ポータルを使用してコンテンツを暗号化する

ハウツー ガイド

ツール

ヘルプとサポート

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