Delen via

Migratierichtlijnen voor inhoudsbeveiligingsscenario's

  • Artikel

logo van migratiehandleiding

migratiestappen 2

Belangrijk

Het is niet langer nodig om te migreren van Azure Media Service v2 naar v3, omdat afschaffing van V2-API wordt afgestemd op de buitengebruikstelling van Azure Media Services. Raadpleeg de handleiding voor buitengebruikstelling van Azure Media Services voor meer informatie.

Dit artikel bevat details en richtlijnen voor de migratie van use cases voor inhoudsbeveiliging van de v2-API naar de nieuwe Azure Media Services v3-API.

Inhoud beveiligen in v3-API

Zie concepten voor inhoudsbeveiliging, zelfstudies en handleidingen aan het einde van dit artikel voor specifieke stappen.

Notitie

In de rest van dit artikel wordt beschreven hoe u uw v2-inhoudsbeveiliging kunt migreren naar v3 met .NET. Als u instructies of voorbeeldcode voor een andere taal of methode nodig hebt, maakt u een GitHub-probleem voor deze pagina.

Afschaffing van AMS als een zelfstandige server voor het leveren van licenties (hybride on-premises modus)

De v3-API biedt geen ondersteuning meer voor het gebruik van de services voor sleutellevering als een zelfstandige functie voor inhoudsbeveiliging, waarbij de service voor sleutellevering kan worden gebruikt voor het leveren van licenties voor inhoud die wordt gestreamd of geleverd via andere oorsprongservers van derden. Dit betekent dat AMS niet langer ondersteuning biedt voor scenario's met alleen sleutellevering in de V3-API en dat u moet streamen vanuit AMS Origin-services met behulp van dynamische pakketten en versleuteling bij het leveren met v3.

Bestaande inhoud die is versleuteld met de v2-API en wordt geleverd in een 'hybride' model, blijft werken (sleutels kunnen nog steeds worden opgehaald op het gegevensvlak), maar het beheer van deze sleutels (updates en bewerkingen) via het v2-beheervlak of v3-beheervlak werkt na 29 februari 2024 niet meer.

Notitie

Alle nieuwe inhoud die wordt geleverd met de v3 biedt alleen ondersteuning voor inhoudsbeveiliging en streaming vanaf AMS en biedt geen ondersteuning meer voor de 'hybride' modus. Het gegevensvlak blijft bestaande sleutels en licenties leveren die zijn gemaakt in v2, maar biedt geen ondersteuning meer voor beheer of updates via de v2- of v3-API.

v3-zichtbaarheid van v2-assets, StreamingLocators en eigenschappen

In de v2-API Assetszijn , StreamingLocatorsen ContentKeys gebruikt om uw streaming-inhoud te beveiligen. Wanneer u migreert naar de v3-API, worden uw v2-API Assets, StreamingLocatorsen ContentKeys automatisch weergegeven in de v3-API en zijn alle gegevens erop beschikbaar voor toegang.

U kunt echter geen eigenschappen bijwerken voor v2-entiteiten via de v3-API die zijn gemaakt in v2.

Als u inhoud wilt bijwerken, wijzigen of wijzigen die is opgeslagen op v2-entiteiten, werkt u deze bij met de v2-API of maakt u nieuwe v3 API-entiteiten om ze te migreren.

Verschillen in asset-id's

Als u wilt migreren, moet u toegang hebben tot eigenschappen of inhoudssleutels van uw v2-assets. Het is belangrijk om te weten dat de v2-API de AssetId gebruikt als primaire identificatiesleutel, maar dat de nieuwe v3-API de Azure Resource Management-naam van de entiteit als primaire id gebruikt. (De eigenschap v2 Asset.Name wordt niet gebruikt als een unieke id.) Met de v3-API wordt de naam van uw v2-asset nu weergegeven als de Asset.Description.

Als u bijvoorbeeld eerder een v2-asset had met de id van nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, bevindt de id zich nu aan het einde van de GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. U ziet dit wanneer u uw v2-assets vermeldt via de v3-API.

Assets die zijn gemaakt en gepubliceerd met behulp van de v2-API, hebben zowel een ContentKeyPolicy als een ContentKey in de v3-API in plaats van een standaardbeleid voor inhoudssleutels op de StreamingPolicy.

Zie de documentatie voor inhoudssleutelbeleid en streamingbeleid voor meer informatie.

Azure Media Services Explorer (AMSE) v2 en AMSE v3-hulpprogramma's naast elkaar gebruiken

Gebruik het hulpprogramma v2 Azure Media Services Explorer in combinatie met het hulpprogramma v3 Azure Media Services Explorer om de gegevens naast elkaar te vergelijken voor een asset die is gemaakt en gepubliceerd via v2-API's. De eigenschappen moeten allemaal zichtbaar zijn, maar op verschillende locaties.

Het migratievoorbeeld voor .NET-inhoudsbeveiliging gebruiken

U vindt een codevoorbeeld om de verschillen in asset-id's te vergelijken met behulp van de v2tov3MigrationSample onder ContentProtection in de Media Services-codevoorbeelden.

De streaming-locators weergeven

U kunt een query uitvoeren op de StreamingLocators gekoppelde assets die zijn gemaakt in de v2-API met behulp van de nieuwe v3-methode ListStreamingLocators op de entiteit Asset. Verwijs ook naar de .NET-client-SDK-versie van ListStreamingLocatorsAsync

De resultaten van de ListStreamingLocators methode bieden u de Name en StreamingLocatorId van de locator, samen met de StreamingPolicyName.

De inhoudssleutels zoeken

Als u wilt zoeken naar de ContentKeys die wordt gebruikt met uw StreamingLocators, kunt u de methode StreamingLocator.ListContentKeysAsync aanroepen.

Zie het artikel Uw inhoud beveiligen met dynamische mediaservicesversleuteling voor meer informatie over inhoudsbeveiliging in de v3-API.

Wijzig de v2 ContentKeyPolicy met behoud van dezelfde ContentKey

U moet de publicatie van de asset eerst ongedaan maken (alle streaming-locators verwijderen) via de v2 SDK. U doet dit als volgt:

  1. Verwijder de locator.
  2. Ontkoppel de ContentKeyAuthorizationPolicy.
  3. Ontkoppel de AssetDeliveryPolicy.
  4. Ontkoppel de ContentKey.
  5. Verwijder de ContentKey.
  6. Maak een nieuwe StreamingLocator in v3 met behulp van een v3 StreamingPolicy en ContentKeyPolicy, waarbij u de specifieke inhoudssleutel-id en sleutelwaarde opgeeft die nodig zijn.

Notitie

Het is mogelijk om de v2-locator te verwijderen met behulp van de v3-API, maar hiermee wordt de inhoudssleutel of het inhoudssleutelbeleid niet verwijderd als deze zijn gemaakt in de v2-API.

Concepten, zelfstudies en handleidingen voor inhoudsbeveiliging

Concepten

Zelfstudies

Quickstart: De portal gebruiken om inhoud te versleutelen

Handleidingen

Hulpprogramma's

Help en ondersteuning

U kunt contact opnemen met Media Services als u vragen hebt of onze updates op een van de volgende manieren volgen: