內容保護案例型移轉指導

  • 發行項

移轉指南標誌

移轉步驟 2

重要

不再需要從 Azure 媒體服務 v2 移轉至 v3，因為 V2 API 的淘汰會與淘汰 Azure 媒體服務一致。 如需詳細資訊，請參閱 Azure 媒體服務淘汰指南 。

本文提供將內容保護使用案例從 v2 API 移轉至新 Azure 媒體服務 v3 API 的詳細資料和指導。

保護 v3 API 中的內容

如需特定步驟，請參閱本文結尾的內容保護概念、教學課程和操作指南。

注意

本文的其餘部分將討論如何使用 .NET 將 v2 內容保護移轉至 v3。 如果您需要不同語言或方法的指示或範例程式碼，請為此頁面建立 GitHub 問題。

將AMS取代為獨立授權傳遞伺服器， (混合式內部部署模式)

v3 API 不再支援使用密鑰傳遞服務作為內容保護的獨立功能，其中密鑰傳遞服務可用來傳遞透過其他第三方源伺服器串流或傳遞的內容授權。 這表示AMS不再支援 V3 API 中的僅金鑰傳遞案例，而且要求您在傳遞 v3 時使用動態封裝和加密從 AMS 原始服務進行串流。

使用 v2 API 加密且以「混合式」模型傳遞的現有內容仍可繼續運作， (密鑰仍可在數據平面上擷取，) 但透過 v2 管理平面或 v3 管理平面管理平面 (更新和) 編輯這些密鑰的管理，在 2 月 29 日之後將無法再運作。 2024.

注意

使用 v3 傳遞的所有新內容只會支援來自AMS的內容保護和串流，不再支援「混合式」模式。 數據平面會繼續傳遞在 v2 中建立的現有密鑰和授權，但不再支援透過 v2 或 v3 API 進行管理或更新。

v2 Assets、StreamingLocators 和屬性的 v3 可見性

在 v2 API 中，使用 Assets、StreamingLocators 和 ContentKeys 來保護您的串流內容。 移轉至 v3 API 時，您的 v2 API Assets、StreamingLocators 和 ContentKeys 都會在 v3 API 中自動公開，且其上所有資料都可供您存取。

不過，您無法透過在 v2 中建立的 v3 API 更新 v2 實體上的任何屬性。

如果您需要更新、變更或變更儲存在 v2 實體上的內容，請使用 v2 API 更新它們，或建立新的 v3 API 實體來移轉它們。

Assets 識別碼差異

若要移轉，您將必須從 v2 Assets 存取屬性或內容金鑰。 請務必了解 v2 API 會使用 AssetId 作為主要識別金鑰，但新的 v3 API 會使用實體的 Azure 資源管理名稱作為主要識別碼。 (v2 Asset.Name 屬性不會作為唯一識別碼。) 使用 v3 API 時，您的 v2 資產名稱現在會顯示為 Asset.Description。

例如，如果您先前有識別碼為 nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8 的 v2 Asset，識別碼現在會位於 GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8 的結尾。 當您透過 v3 API 列出 v2 資產時，會看到此情況。

使用 v2 API 建立和發行的任何 Assets，在 v3 API 中都會有 ContentKeyPolicy 和 ContentKey，而不是 StreamingPolicy 上的預設內容金鑰原則。

如需詳細資訊，請參閱內容金鑰原則文件和串流原則文件。

並排使用 Azure 媒體服務總管 (AMSE) v2 和 AMSE v3 工具

使用 v2 Azure 媒體服務總管工具以及 v3 Azure 媒體服務總管工具，針對透過 v2 API 建立和發佈的 Asset 並排比較資料。 屬性應該全都可見，但位於不同的位置。

使用 .NET 內容保護移轉範例

您可以尋找程式碼範例，以比較 Asset 識別碼中的差異，使用媒體服務程式程式碼範例的 ContentProtection 底下的 v2tov3MigrationSample。

列出串流定位器

您可以使用 Asset 實體上的新 v3 方法 ListStreamingLocators，來查詢與 v2 API 中建立的資產相關聯的 StreamingLocators。 同時參考 ListStreamingLocatorsAsync 的 .NET 用戶端 SDK 版本

ListStreamingLocators 方法的結果將提供您定位器的 Name 和 StreamingLocatorId 與 StreamingPolicyName。

尋找內容金鑰

若要尋找與您的 StreamingLocators 搭配使用的 ContentKeys，您可以呼叫 StreamingLocator.ListContentKeysAsync 方法。

如需 v3 API 中內容保護的詳細資訊，請參閱使用媒體服務動態加密保護您的內容一文。

變更 v2 ContentKeyPolicy 會保留相同的 ContentKey

您應該先在 Assets 上透過 v2 SDK 取消發佈 (移除所有串流定位器)。 方法：

  1. 刪除定位器。
  2. 取消連結 ContentKeyAuthorizationPolicy。
  3. 取消連結 AssetDeliveryPolicy。
  4. 取消連結 ContentKey。
  5. 刪除 ContentKey。
  6. 使用 v3 StreamingPolicy 和 ContentKeyPolicy 在 v3 中建立新的 StreamingLocator，並指定所需的特定內容金鑰識別碼和金鑰值。

注意

您可以使用 v3 API 刪除 v2 定位器，但這不會移除內容金鑰或內容金鑰原則 (如果是在 v2 API 中建立)。

內容保護概念、教學課程和操作指南

概念

教學課程

快速入門：使用入口網站加密內容

使用說明指南

工具

取得說明及支援

您可以連絡媒體服務並詢問問題，或依照下列其中一種方法追蹤我們的更新：