Scenariobaserad migreringsvägledning för innehållsskydd

  • Artikel

logotyp för migreringsguiden

migreringssteg 2

Viktigt

Du behöver inte längre migrera från Azure Media Service v2 till v3 eftersom utfasningen av V2-API:et överensstämmer med tillbakadragandet av Azure Media Services. Mer information finns i guiden för azure Media Services-pensionering .

Den här artikeln innehåller information och vägledning om migrering av användningsfall för innehållsskydd från v2-API:et till det nya Azure Media Services v3-API:et.

Skydda innehåll i v3 API

Se innehållsskyddsbegrepp, självstudier och guider i slutet av den här artikeln för specifika steg.

Anteckning

Resten av den här artikeln beskriver hur du kan migrera v2-innehållsskyddet till v3 med .NET. Om du behöver instruktioner eller exempelkod för ett annat språk eller en annan metod skapar du ett GitHub-problem för den här sidan.

Utfasning av AMS som en fristående licensleveransserver (hybrid lokalt läge)

V3-API:et stöder inte längre användning av viktiga leveranstjänster som en fristående funktion för innehållsskydd där nyckelleveranstjänsten kan användas för att leverera licens för innehåll som strömmas eller levereras via andra ursprungsservrar från tredje part. Det innebär att AMS inte längre stöder scenarier med endast nyckelleverans i V3-API:et och kräver att du strömmar från AMS-ursprungstjänster med dynamisk paketering och kryptering när du levererar med v3.

Befintligt innehåll som krypterades med v2-API:et och levereras i en hybridmodell fortsätter att fungera (nycklar kan fortfarande hämtas på dataplanet), men hanteringen av dessa nycklar (uppdateringar och redigeringar) via v2-hanteringsplanet eller v3-hanteringsplanet fungerar inte längre efter den 29 februari 2024.

Anteckning

Allt nytt innehåll som levereras med v3 stöder endast innehållsskydd och direktuppspelning från AMS och stöder inte längre hybridläge. Dataplanet fortsätter att leverera befintliga nycklar och licenser som skapats i v2, men stöder inte längre hantering eller uppdateringar via v2- eller v3-API:et.

v3 synlighet för v2-tillgångar, StreamingLocators och egenskaper

I v2-API:et, Assets, StreamingLocatorsoch ContentKeys användes för att skydda ditt strömmande innehåll. När du migrerar till v3-API:et exponeras ditt v2-API Assets, StreamingLocatorsoch ContentKeys alla exponeras automatiskt i v3-API:et och alla data på dem är tillgängliga för dig att komma åt.

Du kan dock inte uppdatera några egenskaper på v2-entiteter via v3-API:et som skapades i v2.

Om du behöver uppdatera, ändra eller ändra innehåll som lagras på v2-entiteter uppdaterar du dem med v2-API:et eller skapar nya v3 API-entiteter för att migrera dem.

Skillnader i tillgångsidentifierare

Om du vill migrera måste du komma åt egenskaper eller innehållsnycklar från dina v2-tillgångar. Det är viktigt att förstå att v2-API:et använder AssetId som primär identifieringsnyckel, men det nya v3-API:et använder Azure Resource Management-namnet på entiteten som primär identifierare. (Egenskapen v2 Asset.Name används inte som en unik identifierare.) Med v3-API:et visas ditt v2-tillgångsnamn nu som Asset.Description.

Om du till exempel tidigare hade en v2-tillgång med ID nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8:t för är identifieraren nu i slutet av GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Du ser detta när du listar dina v2-tillgångar via v3-API:et.

Alla tillgångar som har skapats och publicerats med v2-API:et har både en ContentKeyPolicy och en ContentKey i v3-API:et i stället för en standardprincip för innehållsnyckeln på StreamingPolicy.

Mer information finns i dokumentationen om innehållsnyckelprinciper och dokumentationen om strömningsprinciper .

Använd verktygen Azure Media Services Explorer (AMSE) v2 och AMSE v3 sida vid sida

Använd verktyget v2 Azure Media Services Explorer tillsammans med verktyget v3 Azure Media Services Explorer för att jämföra data sida vid sida för en tillgång som skapats och publicerats via v2-API:er. Alla egenskaper ska vara synliga, men på olika platser.

Använda migreringsexemplet för .NET-innehållsskydd

Du hittar ett kodexempel för att jämföra skillnaderna i tillgångsidentifierare med hjälp av v2tov3MigrationSample under ContentProtection i Media Services-kodexemplet.

Visa en lista över positionerare för direktuppspelning

Du kan köra frågor mot de StreamingLocators tillgångar som skapats i v2-API:et med hjälp av den nya v3-metoden ListStreamingLocators i tillgångsentiteten. Referera även till .NET-klientens SDK-version av ListStreamingLocatorsAsync

Resultatet av ListStreamingLocators metoden ger dig Name lokaliseraren och StreamingLocatorId tillsammans med StreamingPolicyName.

Hitta innehållsnycklarna

Om du vill hitta den ContentKeys som används med kan StreamingLocatorsdu anropa metoden StreamingLocator.ListContentKeysAsync .

Mer information om innehållsskydd i v3-API:et finns i artikeln Skydda ditt innehåll med dynamisk Media Services-kryptering.

Ändra att v2 ContentKeyPolicy behåller samma ContentKey

Du bör först avpublicera (ta bort alla positionerare för direktuppspelning) på tillgången via v2 SDK. Gör så här:

  1. Ta bort lokaliseraren.
  2. Ta bort länk till ContentKeyAuthorizationPolicy.
  3. Ta bort länk till AssetDeliveryPolicy.
  4. Ta bort länk till ContentKey.
  5. ContentKeyTa bort .
  6. Skapa en ny StreamingLocator i v3 med hjälp av en v3 StreamingPolicy och ContentKeyPolicy, som anger den specifika innehållsnyckelidentifierare och nyckelvärde som behövs.

Anteckning

Det går att ta bort v2-lokaliseraren med hjälp av v3-API:et, men detta tar inte bort innehållsnyckeln eller innehållsnyckelprincipen om de skapades i v2-API:et.

Innehållsskyddsbegrepp, självstudier och guider

Begrepp

Självstudier

Snabbstart: Använd portalen för att kryptera innehåll

Guider

Verktyg

Få hjälp och support

Du kan kontakta Media Services med frågor eller följa våra uppdateringar med någon av följande metoder: