Recommandations en matière de migration basées sur un scénario de protection de contenu

  • Article

logo du guide de migration

étapes de migration 2

Important

Il n’est plus nécessaire de migrer d’Azure Media Service v2 vers v3, car la dépréciation de l’API V2 s’aligne sur la mise hors service d’Azure Media Services. Pour plus d’informations, consultez le guide de mise hors service d’Azure Media Services .

Cet article fournit des informations et des conseils sur la migration de cas d’utilisation de protection de contenu de l’API v2 vers la nouvelle API v3 d’Azure Media Services.

Protection de contenu dans l’API v3

Pour connaître les étapes spécifiques, consultez Concepts, tutoriels et guides pratiques relatifs à la protection de contenu à la fin de cet article.

Notes

Le reste de cet article explique comment vous pouvez migrer votre protection du contenu v2 vers v3 avec .NET. Si vous avez besoin d’instructions ou d’un exemple de code pour un autre langage ou une autre méthode, créez un problème GitHub pour cette page.

Dépréciation d’AMS en tant que serveur de remise de licence autonome (mode local hybride)

L’API v3 ne prend plus en charge l’utilisation des services de distribution de clés en tant que fonctionnalité autonome pour la protection du contenu où le service de distribution de clés peut être utilisé afin de fournir une licence pour le contenu diffusé en continu ou remis par le biais d’autres serveurs d’origine tierce. Cela signifie qu’AMS ne prend plus en charge les scénarios de distribution de clés uniquement dans l’API v3 et vous oblige à diffuser en continu à partir des services d’origine AMS à l’aide de l’empaquetage et du chiffrement dynamiques lors de la livraison avec v3.

Le contenu existant qui a été chiffré avec l’API v2 et qui est distribué dans un modèle « hybride » continuera de fonctionner (les clés seront toujours récupérables sur le plan de données), mais la gestion de ces clés (mises à jour et modifications) via le plan de gestion v2 ou le plan de gestion v3 ne fonctionnera plus après le 29 février 2024.

Notes

Tous les nouveaux contenus distribués à l’aide de la version v3 prennent uniquement en charge la protection du contenu et la diffusion en continu à partir d’AMS et ne prennent plus en charge le mode « hybride ». Le plan de données continuera de distribuer des clés et des licences existantes créées dans v2, mais ne prendra plus en charge la gestion ou les mises à jour via l’API v2 ou v3.

Visibilité v3 des ressources v2, StreamingLocators et propriétés

Dans l’API v2, Assets, StreamingLocators et ContentKeys servaient à protéger votre contenu diffusé. Lors de la migration vers l’API V3, vos Assets, StreamingLocators et ContentKeys de l’API v2 sont toutes exposées automatiquement dans l’API V3, et toutes leurs données y sont accessibles.

Cependant, vous ne pouvez pas mettre à jour les propriétés des entités v2 via l’API v3 si elles ont été créées dans la v2.

Si vous devez mettre à jour, modifier ou transformer du contenu stocké sur des entités v2, mettez-les à jour via l’API v2 ou créer des entités d’API v3 pour les migrer.

Différences entre les identificateurs de ressource

Pour migrer, vous devez accéder aux propriétés ou aux clés de contenu à partir de vos ressources v2. Il est important de comprendre que l’API v2 utilise l’AssetId comme clé d’identification principale, et que la nouvelle API v3 utilise le nom de Gestion des ressources Azure de l’entité comme identificateur principal. (La propriété Asset.Name v2 n’est pas utilisée comme identificateur unique.) Avec l’API v3, votre nom de ressource v2 s’affiche désormais en tant que Asset.Description.

Par exemple, si vous aviez précédemment une ressource v2 avec l’ID nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, l’identificateur se trouve maintenant à la fin du GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Vous le verrez lorsque vous répertorierez vos ressources v2 par le biais de l’API v3.

Toutes les ressources créées et publiées à l’aide de l’API v2 auront une ContentKeyPolicy et une ContentKey dans l’API v3, au lieu d’utiliser une stratégie de clé de contenu par défaut sur la StreamingPolicy.

Pour plus d’informations, consultez la documentation sur la stratégie de clé de contenu et la documentation sur la stratégie de diffusion en continu.

Utiliser les outils Azure Media Services Explorer (AMSE) v2 et AMSE v3 côte à côte

Utilisez l’outil Azure Media Services Explorer v2 avec l’outil Azure Media Services Explorer v3 pour comparer des données côte à côte pour un élément créé et publié via les API v2. Les propriétés doivent toutes être visibles, mais à des emplacements différents.

Utiliser l’exemple de migration de la protection du contenu .NET

Vous trouverez un exemple de code pour comparer les différences des identificateurs de ressource à l’aide de v2tov3MigrationSample sous ContentProtection dans les exemples de code de Media Services.

Répertorier les localisateurs de streaming

Vous pouvez interroger les StreamingLocators associés aux ressources créées dans l’API v2 à l’aide de la nouvelle méthode v3 ListStreamingLocators sur l’entité Ressource. Référencez également la version de Kit de développement logiciel (SDK) de client .NET ListStreamingLocatorsAsync

Les résultats de la méthode ListStreamingLocators vous fourniront les valeurs Name et StreamingLocatorId du localisateur, ainsi que la valeur StreamingPolicyName.

Rechercher les clés de contenu

Pour trouver les ContentKeys utilisées dans vos StreamingLocators, vous pouvez appeler la méthode StreamingLocator.ListContentKeysAsync.

Pour plus d’informations sur la protection du contenu dans l’API v3, consultez l’article Protéger votre contenu à l’aide du chiffrement dynamique de Media Services.

Modifier la ContentKeyPolicy v2 en conservant la même ContentKey

Vous devez d’abord annuler la publication (supprimer tous les localisateurs de streaming) sur la ressource via le kit de développement logiciel (SDK) v2. Voici comment faire :

  1. Supprimez le localisateur.
  2. Dissociez la ContentKeyAuthorizationPolicy.
  3. Dissociez la AssetDeliveryPolicy.
  4. Dissociez la ContentKey.
  5. Supprimez la ContentKey.
  6. Créez un nouveau StreamingLocator dans v3 à l’aide de StreamingPolicy et ContentKeyPolicy v3 en spécifiant l’identificateur de clé de contenu et la valeur de clé spécifiques nécessaires.

Notes

Il est possible de supprimer le localisateur v2 à l’aide de l’API v3, mais que cela n’a pas pour effet de supprimer la clé de contenu ou la stratégie de clé de contenu si elles ont été créées dans l’API v2.

Concepts, tutoriels et guides pratiques relatifs à la protection de contenu

Concepts

Tutoriels

Démarrage rapide : Utiliser le portail pour chiffrer du contenu

Guides pratiques

Outils

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour toute question ou suivre nos mises à jour selon l’une des méthodes suivantes :