Поделиться через

Руководство по миграции защиты содержимого на основе сценариев

  • Статья

логотип руководства по миграции

этапы миграции 2

Важно!

Переход со Службы мультимедиа Azure версии 2 на версию 3 больше не требуется, так как прекращение поддержки API версии 2 будет соответствовать прекращению использования Служб мультимедиа Azure. Дополнительные сведения см. в руководстве по прекращению использования Служб мультимедиа Azure .

Эта статья содержит подробные сведения и рекомендации по переносу вариантов использования защиты содержимого из API версии 2 в новый API служб мультимедиа Azure версии 3.

Защита содержимого в API версии 3

Дополнительные сведения о понятии защиты содержимого, инструкции и руководства указаны в конце завершению этой статьи. С ними следует ознакомиться для помощи на конкретных этапах.

Примечание

Дальнейшая часть данной статьи рассматривает процесс миграции защиты содержимого с версии 2 на версию 3 с помощью .NET. Если вам нужны инструкции или примеры кода для другого языка или метода, создайте вопрос GitHub для этой страницы.

Прекращение поддержки AMS как автономного сервера доставки лицензий (гибридный локальный режим)

API версии 3 больше не поддерживает использование служб доставки ключей в качестве автономной функции для защиты содержимого, в частности для предоставления лицензий на содержимое, транслируемое или доставляемое через другие сторонние серверы. Это означает, что AMS больше не поддерживает сценарии, обеспечивающие только доставку ключей, в API версии 3 и при доставке с помощью версии 3 требует выполнить потоковую передачу из служб AMS, использующих динамическую упаковку и шифрование.

Существующее содержимое, зашифрованное с помощью API версии 2 и доставляемое в рамках "гибридной" модели, будет продолжать работать (ключи по-прежнему будут извлекаться в плоскости данных), но управление этими ключами (обновления и изменения) через плоскость управления версий 2 или 3 станет невозможно после 29 февраля 2024 года.

Примечание

Все новое содержимое, доставленное с помощью версии 3, будет поддерживать только защиту содержимого и потоковую передачу из AMS, но не "гибридный" режим. Плоскость данных по-прежнему будет предоставлять существующие ключи и лицензии, созданные в версии 2, но больше не будет поддерживать управление или обновления с помощью API версий 2 или 3.

Видимость ресурсов версии 2 на версии 3, StreamingLocators и свойства

В API версии 2 Assets, StreamingLocators и ContentKeys использовались для защиты потоковых данных. При переходе на API версии 3 все Assets, StreamingLocators и ContentKeys из предыдущей версии автоматически переходят в API версии 3, и все данные на них становятся доступны для доступа.

Однако нельзя обновить с помощью API версии 3 свойства сущностей версии 2, которые были созданы в версии 2.

Если необходимо обновлять, изменять или изменять содержимое, хранящееся в сущностях версии 2, обновите их с помощью API версии 2 или создайте новые сущности API версии 3 для их переноса.

Различия в идентификаторах ресурсов

Чтобы выполнить миграцию, необходимо получить доступ к свойствам или ключам содержимого из ресурсов версии 2. Важно понимать, что API версии 2 использует в AssetId качестве первичного ключа идентификации, но новый API версии 3 использует имя сущности "Управление ресурсами Azure" в качестве основного идентификатора. (Свойство Asset.Name в версии 2 не используется в качестве уникального идентификатора.) В API версии 3 имя ресурса версии 2 теперь отображается как Asset.Description.

Например, если ранее имелся ресурс версии 2 с идентификатором ID в значении nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, идентификатор теперь находится в конце идентификатора GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Вы увидите это при перечислении ресурсов версии 2 через API версии 3.

Все активы, созданные и опубликованные с помощью API версии 2, будут иметь как ContentKeyPolicy, так и ContentKey в API версии 3 вместо политики ключа содержимого по умолчанию в StreamingPolicy.

Дополнительные сведения см. в документации по политике ключей содержимого и документации по политикам потоковой передачи.

Параллельное использование средств обозревателя служб мультимедиа Azure (AMSE) версий 2 и 3

Используйте средство обозревателя служб мультимедиа Azure версии 2 вместе со средством обозревателя служб мультимедиа Azure версии 3, чтобы наглядно сравнить друг с другом данные для ресурса, созданного и опубликованного через API версии 2. Свойства должны быть видимыми, но находиться в разных расположениях.

Использование образца миграции для защиты содержимого .NET

Вы можете найти пример кода для сравнения различий в идентификаторах ресурсов с помощью v2tov3MigrationSample в разделе ContentProtection (Защита содержимого) в примерах кода служб мультимедиа.

Список указателей потоковой передачи

Вы можете запросить StreamingLocators связанный с ресурсами, созданными в API версии 2, с помощью нового метода версии 3, ListStreamingLocators, в сущности ресурса. Также следует обратить внимание на версию ListStreamingLocatorsAsync в SDK клиента .NET

Результаты метода ListStreamingLocators будут предоставлять Name и StreamingLocatorId указателя, а также и StreamingPolicyName.

Поиск ключей содержимого

Чтобы найти ContentKeys, используемый с StreamingLocators, можно вызвать метод StreamingLocator.ListContentKeysAsync.

Дополнительные сведения о защите содержимого в API версии 3 см. в статье Защита содержимого с помощью динамического шифрования служб мультимедиа.

Изменение ContentKeyPolicy версии 2 для сохранения того же ключа содержимого ContentKey

Сначала необходимо отменить публикацию (удалить все указатели потоковой передачи) в ресурсе с помощью пакета SDK версии 2. Вот как это сделать.

  1. Удалите указатель.
  2. Удалить связь с ContentKeyAuthorizationPolicy.
  3. Удалить связь с AssetDeliveryPolicy.
  4. Удалить связь с ContentKey.
  5. Удалить ContentKey.
  6. Создайте новый объект StreamingLocator в версии 3 с помощью StreamingPolicy и ContentKeyPolicy версии 3, указав конкретный идентификатор ключа содержимого и значение ключа.

Примечание

Можно удалить указатель версии 2 с помощью API версии 3, но это не приведет к удалению ключа содержимого или политики ключа содержимого, если они были созданы в API версии 2.

Основные понятия защиты содержимого, инструкции и руководства

Основные понятия

Учебники

Краткое руководство. Шифрование содержимого с помощью портала

Практические руководства

Инструменты

Справка и поддержка

Вы можете обратиться к Службам мультимедиа с вопросами или следить за нашими обновлениями одним из следующих способов: