Orientações de migração baseadas em cenários de proteção de conteúdos

  • Artigo

logótipo do guia de migração

passos de migração 2

Importante

Já não é necessário migrar do Serviço de Multimédia do Azure v2 para o v3, uma vez que a preterição da API V2 será alinhada com a extinção dos Serviços de Multimédia do Azure. Veja o Guia de extinção dos Serviços de Multimédia do Azure para obter mais informações.

Este artigo fornece-lhe detalhes e orientações sobre a migração de casos de utilização da proteção de conteúdos da API v2 para a nova API v3 dos Serviços de Multimédia do Azure.

Proteger conteúdo na API v3

Veja conceitos, tutoriais e guias de proteção de conteúdos no final deste artigo para obter passos específicos.

Nota

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

Descontinuação do AMS como um servidor de entrega de licenças autónomo (modo híbrido no local)

A API v3 já não suporta a utilização dos principais serviços de entrega como uma funcionalidade autónoma para a proteção de conteúdos em que o serviço de entrega de chaves pode ser utilizado para fornecer licenças para conteúdos transmitidos ou entregues através de outros servidores de origem de terceiros. Isto significa que o AMS já não suporta cenários apenas de entrega de chaves na API V3 e requer que transmita a partir de serviços de origem AMS através de empacotamento e encriptação dinâmicos ao fornecer com v3.

Os conteúdos existentes que foram encriptados com a API v2 e que são entregues num modelo "híbrido" continuarão a funcionar (as chaves continuarão a ser recuperáveis no plano de dados), mas a gestão dessas chaves (atualizações e edições) através do plano de gestão v2 ou do plano de gestão v3 deixará de funcionar após 29 de fevereiro de 2024.

Nota

Todos os novos conteúdos fornecidos através da v3 só suportarão a proteção de conteúdos e a transmissão em fluxo a partir do AMS e deixarão de suportar o modo "híbrido". O plano de dados continuará a fornecer chaves e licenças existentes criadas na v2, mas deixará de suportar a gestão ou atualizações através da API v2 ou v3.

visibilidade v3 dos Recursos v2, StreamingLocators e propriedades

Na API v2, Assets, StreamingLocatorse ContentKeys foram utilizados para proteger os seus conteúdos de transmissão em fluxo. Ao migrar para a API v3, a sua API Assetsv2 , StreamingLocators, e ContentKeys são todos expostos automaticamente na API v3 e todos os dados nos mesmos estão disponíveis para acesso.

No entanto, não pode atualizar quaisquer propriedades em entidades v2 através da API v3 que foram criadas na v2.

Se precisar de atualizar, alterar ou alterar conteúdos armazenados em entidades v2, atualize-os com a API v2 ou crie novas entidades da API v3 para as migrar.

Diferenças do identificador de recursos

Para migrar, terá de aceder a propriedades ou chaves de conteúdo a partir dos recursos v2. É importante compreender que a API v2 utiliza a AssetId como chave de identificação primária, mas a nova API v3 utiliza o nome Azure Resource Management da entidade como o identificador principal. (A propriedade v2 Asset.Name não é utilizada como identificador exclusivo.) Com a API v3, o nome do recurso v2 aparece agora como .Asset.Description

Por exemplo, se anteriormente tinha um Recurso v2 com o ID de nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, o identificador está agora no final do GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Verá isto ao listar os recursos v2 através da API v3.

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

Para obter mais informações, veja a Documentação da política de chave de conteúdo e a documentação da Política de Transmissão em Fluxo .

Utilizar as ferramentas Azure Media Services Explorer (AMSE) v2 e AMSE v3 lado a lado

Utilize a ferramenta V2 do Explorador de Serviços de Multimédia do Azure , juntamente com a ferramenta Explorador de Serviços de Multimédia do Azure v3 , para comparar os dados lado a lado com um Recurso criado e publicado através de APIs v2. Todas as propriedades devem estar visíveis, mas em localizações diferentes.

Utilizar o exemplo de migração de proteção de conteúdos .NET

Pode encontrar um exemplo de código para comparar as diferenças em Identificadores de recursos com v2tov3MigrationSample em ContentProtection nos exemplos de código dos Serviços de Multimédia.

Listar os Localizadores de Transmissão em Fluxo

Pode consultar os StreamingLocators associados aos Recursos criados na API v2 com o novo método v3 ListStreamingLocators na entidade Asset. Veja também a versão do SDK do cliente .NET de ListStreamingLocatorsAsync

Os resultados do ListStreamingLocators método irão fornecer-lhe o Name e StreamingLocatorId do localizador juntamente com o StreamingPolicyName.

Localizar as chaves de conteúdo

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

Para obter mais informações sobre a proteção de conteúdos na API v3, veja o artigo Proteger o seu conteúdo com a encriptação dinâmica dos Serviços de Multimédia.

Alterar o ContentKeyPolicy v2 mantendo a mesma ContentKey

Primeiro, deve anular a publicação (remover todos os Localizadores de Transmissão em Fluxo) no Recurso através do SDK v2. Eis como:

  1. Elimine o localizador.
  2. Desassociar o ContentKeyAuthorizationPolicy.
  3. Desassociar o AssetDeliveryPolicy.
  4. Desassociar o ContentKey.
  5. Elimine o ContentKey.
  6. Crie um novo StreamingLocator no v3 com um v3 StreamingPolicy e ContentKeyPolicy, especificando o identificador de chave de conteúdo específico e o valor de chave necessário.

Nota

É possível eliminar o localizador v2 com a API v3, mas isto não removerá a chave de conteúdo ou a política de chave de conteúdo se tiverem sido criados na API v2.

Conceitos de proteção de conteúdos, tutoriais e guias de procedimentos

Conceitos

Tutoriais

Início Rápido: Utilizar o portal para encriptar conteúdo

Guias de procedimentos

Ferramentas

Obter ajuda e suporte

Pode contactar os Serviços de Multimédia com perguntas ou seguir as nossas atualizações através de um dos seguintes métodos: