Guía de migración basada en escenarios de protección de contenido

  • Artículo

logotipo de la guía de migración

pasos de migración 2

Importante

Ya no es necesario migrar de Azure Media Service v2 a v3, ya que el desuso de la API V2 se alineará con la retirada de Azure Media Services. Consulte la guía de retirada de Azure Media Services para más información.

En este artículo se proporcionan detalles e instrucciones sobre la migración de casos de uso de protección de contenido de la API v2 a la nueva API de Azure Media Services v3.

Protección del contenido en API v3

Consulte los conceptos, tutoriales y guías de procedimientos de protección de contenido al final de este artículo para conocer los pasos específicos.

Nota

En el resto de este artículo se describe cómo migrar la protección de contenido de la versión v2 a la v3 con .NET. Si necesita instrucciones o código de ejemplo para un lenguaje o método diferentes, cree un problema de GitHub para esta página.

Desuso de AMS como un servidor de entrega de licencias independiente (modo local híbrido)

La API v3 ya no admite el uso de los servicios de entrega de claves como una característica independiente para la protección de contenido en la que el servicio de entrega de claves se puede usar para entregar licencias de contenido que se transmite o se entrega a través de otros servidores de origen de terceros. Esto significa que AMS ya no admite escenarios solo de entrega de claves en la API V3 y requiere que se transmita desde servicios de origen de AMS mediante el empaquetado dinámico y el cifrado al entregar con v3.

El contenido existente que se cifró con la API v2 y se entrega en un modelo «híbrido» seguirá funcionando (las claves seguirán siendo recuperables en el plano de datos), pero la administración de esas claves (actualizaciones y ediciones) a través del plano de administración v2 o el plano de administración v3 ya no funcionaría después del 29 de febrero de 2024.

Nota

Todo el contenido nuevo entregado con la versión v3 solo admitirá la protección de contenido y el streaming desde AMS y ya no admitirá el modo «híbrido». El plano de datos seguirá entregando las claves y licencias existentes creadas en v2, pero ya no admitirá la administración ni las actualizaciones a través de la API v2 o v3.

Visibilidad en la versión v3 de Assets, StreamingLocators y propiedades de la versión v2

En la API v2, Assets, StreamingLocators y ContentKeys se usaban para proteger el contenido de streaming. Al migrar a la API v3, los elementos AssetsStreamingLocators y ContentKeys de la API v2 se exponen de forma automática en la API v3, y todos los datos de los mismos están disponibles para que pueda acceder a ellos.

Sin embargo, no puede actualizar las propiedades de las entidades de la versión v2 que se crearon en dicha versión a través de la API v3.

Si necesita actualizar, cambiar o modificar el contenido almacenado en entidades de la versión v2, actualícelo con la API v2 o cree nuevas entidades de API v3 para migrarlas.

Diferencias en los identificadores de Asset

Para realizar la migración, necesitará acceder a las propiedades o claves de contenido de los elementos Asset de la versión v2. Es importante comprender que la API v2 usa el valor de AssetId como clave de identificación principal, pero la nueva API v3 usa el nombre de administración de recursos de Azure de la entidad como identificador principal. (La propiedad Asset.Name de la versión v2 no se usa como identificador único). Con la API v3, el nombre del elemento Asset de la versión v2 aparece como Asset.Description.

Por ejemplo, si anteriormente tenía un elemento Asset de la versión v2 con el identificador nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, el identificador se encuentra ahora al final del GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Podrá ver esto cuando enumere los elementos Asset de la versión v2 a través de la API v3.

Los elementos Asset que se crearon y publicaron con la API v2 tendrán tanto una propiedad ContentKeyPolicy como una propiedad ContentKey en la API v3, en lugar de una directiva de clave de contenido predeterminada en StreamingPolicy.

Para obtener más información, consulte la documentación de la Directiva de clave de contenido y la documentación de la Directiva de streaming.

Uso de las herramientas de Azure Media Services Explorer v2 (AMSE) y AMSE v3 en paralelo

Use la herramienta Azure Media Services Explorer v2 junto con la herramienta Azure Media Services Explorer v3 para comparar en paralelo los datos de un elemento Asset creado y publicado a través de las API v2. Todas las propiedades deben ser visibles, aunque en ubicaciones diferentes.

Uso del ejemplo de migración de protección de contenido de .NET

Puede consultar un ejemplo de código para comparar las diferencias en los identificadores de elementos Asset en v2tov3MigrationSample, en ContentProtection de los ejemplos de código de Media Services.

Lista de localizadores de streaming

Puede consultar los StreamingLocators asociados a los elementos Asset creados en la API v2 mediante el nuevo método ListStreamingLocatorsde la versión v3 en la entidad Asset. También debe hacer referencia a la versión del SDK de cliente de .NET de ListStreamingLocatorsAsync

Los resultados del método ListStreamingLocators le proporcionarán las propiedades Name y StreamingLocatorId del localizador, junto con StreamingPolicyName.

Búsqueda de las claves de contenido

Para encontrar la propiedad ContentKeys usada con StreamingLocators, puede llamar al método StreamingLocator.ListContentKeysAsync.

Para obtener más información sobre la protección de contenido en la API v3, consulte el artículo Protección del contenido mediante el cifrado dinámico de Media Services.

Cambio de la ContentKeyPolicy v2 mientras se conserva la misma ContentKey

Primero debe anular la publicación (quitar todos los localizadores de streaming) en el elemento Asset a través del SDK v2. A continuación, se indica cómo puede hacerlo.

  1. Elimine el localizador.
  2. Desvincule ContentKeyAuthorizationPolicy.
  3. Desvincule AssetDeliveryPolicy.
  4. Desvincule ContentKey.
  5. Elimine ContentKey.
  6. Cree un nuevo StreamingLocator en la versión v3 con una propiedad StreamingPolicy y ContentKeyPolicy e la versión v3. Para ello, especifique los valores necesarios de identificador de clave de contenido y valor de clave.

Nota

Es posible eliminar el localizador v2 mediante la API v3, pero esto no quitará la clave de contenido ni la directiva de clave de contenido si se crearon en la API v2.

Conceptos, tutoriales y guías de procedimientos de protección de contenido

Conceptos

Tutoriales

Inicio rápido: Uso del portal para cifrar contenido

Guías de procedimientos

Herramientas

Obtener ayuda y soporte técnico

Puede ponerse en contacto con Media Services con preguntas o seguir nuestras actualizaciones mediante uno de los métodos siguientes: