Diretrizes de migração baseadas em cenário de proteção de conteúdo

  • Artigo

logotipo do guia de migração

etapas da migração 2

Importante

Não é mais necessário migrar do Serviço de Mídia do Azure v2 para v3, pois a substituição da API V2 se alinhará à desativação dos Serviços de Mídia do Azure. Consulte o guia de desativação dos Serviços de Mídia do Azure para obter mais informações.

Este artigo fornece detalhes e diretrizes sobre a migração de casos de uso de proteção de conteúdo da API v2 para a nova API Serviços de Mídia do Azure v3.

Proteger o conteúdo na API v3

Confira conceitos de proteção de conteúdo, tutoriais e guias de como fazer no final deste artigo para ver etapas específicas.

Observação

O restante deste artigo discute como você pode migrar sua proteção de conteúdo v2 para a v3 com o .NET. Se você precisar de instruções ou código de exemplo para uma linguagem ou método diferente, crie um problema do GitHub para esta página.

Substituição do AMS como um servidor de entrega de licença autônomo (modo local híbrido)

A API v3 não dá mais suporte ao uso dos serviços de entrega de chave como um recurso autônomo para proteção de conteúdo, em que o serviço de entrega de chave pode ser usado para fornecer licença para conteúdo transmitido ou entregue por meio de outros servidores de origem de terceiros. Isso significa que o AMS não dá mais suporte a cenários somente de entrega de chaves na API V3 e exige que você transmita de serviços de origem AMS usando empacotamento dinâmico e criptografia ao fornecer com v3.

O conteúdo existente criptografado com a API v2 e entregue em um modelo "híbrido" continuará funcionando (as chaves ainda poderão ser recuperadas no plano de dados), mas o gerenciamento dessas chaves (atualizações e edições) por meio do plano de gerenciamento v2 ou v3 não funcionará mais após 29 de fevereiro de 2024.

Observação

Todo o novo conteúdo fornecido usando o v3 só dará suporte à proteção de conteúdo e streaming do AMS e não oferecerá mais suporte ao modo "híbrido". O plano de dados continuará fornecendo chaves e licenças existentes criadas na v2, mas não dará mais suporte ao gerenciamento ou às atualizações por meio da API v2 ou v3.

Visibilidade v3 de ativos v2, StreamingLocators e propriedades

Na API v2, Assets, StreamingLocators e ContentKeys foram usados para proteger seu conteúdo de streaming. Ao migrar para a API v3, sua API v2 Assets, StreamingLocators e ContentKeyssão todos expostos automaticamente na API v3 e todos os dados neles estão disponíveis para acesso.

No entanto, você não pode atualizar nenhuma propriedade em entidades v2 por meio da API v3 que foram criadas na v2.

Se você precisar atualizar, alterar ou alterar o conteúdo armazenado em entidades v2, atualize-os com a API v2 ou crie novas entidades de API v3 para migrá-las.

Diferenças de identificador de ativo

Para migrar, você precisará acessar propriedades ou chaves de conteúdo de seus ativos v2. É importante entender que a API v2 usa o AssetIdcomo a chave de identificação primária, mas a nova API v3 usa o nome do Gerenciamento de Recursos do Azure da entidade como o identificador primário. (A propriedade v2 Asset.Name não é usada como um identificador exclusivo.) Com a API v3, o nome do ativo v2 agora aparece como o Asset.Description.

Por exemplo, se você já tinha um Ativo v2 com a ID de, o identificador agora está no nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8 final do GUID8cb39104-122c-496e-9ac5-7f9e2c2547b8. Você verá isso ao listar seus ativos v2 por meio da API v3.

Todos os ativos que foram criados e publicados usando a API v2 terão um ContentKeyPolicy e um ContentKey na API v3, em vez de uma política de chave de conteúdo padrão no StreamingPolicy.

Para obter mais informações, consulte a documentação da Política de chave de conteúdo e a documentação da Política de Streaming.

Usar as ferramentas do Gerenciador de serviços de mídia do Azure (AMSE) V2 e AMSE v3 lado a lado

Use a ferramenta do Gerenciador de serviços de mídia do Azure v2 junto com a ferramenta do Gerenciador de serviços de mídia do Azure v3 para comparar os dados lado a lado para um ativo criado e publicado por meio de APIs v2. Todas as propriedades devem estar visíveis, mas em locais diferentes.

Usar o exemplo de migração de proteção de conteúdo do .NET

Você pode encontrar um exemplo de código para comparar as diferenças nos identificadores de ativos usando o v2tov3MigrationSample em ContentProtection nos exemplos de código dos serviços de mídia.

Lista de Localizadores de Streaming

Você pode consultar o StreamingLocators associado aos ativos criados na API v2 usando o novo método v3 ListStreamingLocators na entidade de ativo. Também referenciar a versão SDK do cliente .NET do ListStreamingLocatorsAsync

Os resultados do ListStreamingLocators método fornecerão o e o NameStreamingLocatorId do localizador, juntamente com o StreamingPolicyName.

Localizar as chaves de conteúdo

Para localizar o ContentKeys usado com seu StreamingLocators, você pode chamar o método StreamingLocator. ListContentKeysAsync.

Para obter mais informações sobre a proteção de conteúdo na API v3, consulte o artigo Proteger seu conteúdo com a criptografia dinâmica dos serviços de mídia.

Alterar o ContentKeyPolicy v2 mantendo o mesmo ContentKey

Você deve primeiro cancelar a publicação (remover todos os localizadores de streaming) no ativo por meio do SDK v2. Aqui está como:

  1. Exclua o localizador.
  2. Desvincular o ContentKeyAuthorizationPolicy.
  3. Desvincular o AssetDeliveryPolicy.
  4. Desvincular o ContentKey.
  5. Exclua o ContentKey.
  6. Crie um novo StreamingLocator no v3 usando uma v3 StreamingPolicy e ContentKeyPolicy, especificando o identificador de chave de conteúdo específico e o valor de chave necessários.

Observação

É possível excluir o localizador v2 usando a API v3, mas isso não removerá a chave de conteúdo ou a política de chave de conteúdo se eles foram criados na API v2.

Conceitos de proteção de conteúdo, tutoriais e guias de como fazer

Conceitos

Tutoriais

Início Rápido: Usar o portal para criptografar o conteúdo

Guias de como fazer

Ferramentas

Obter ajuda e suporte

Você pode entrar em contato com os Serviços de Mídia com dúvidas ou seguir nossas atualizações por um dos seguintes métodos: