Linee guida sulla migrazione basata su scenari di protezione del contenuto

  • Articolo

logo della guida alla migrazione

passaggi di migrazione 2

Importante

Non è più necessario eseguire la migrazione da Servizio multimediale di Azure v2 a v3 come deprecazione dell'API V2 allineata al ritiro di Servizi multimediali di Azure. Per altre informazioni, vedere la guida al ritiro di Servizi multimediali di Azure .

Questo articolo fornisce informazioni dettagliate e indicazioni sulla migrazione dei casi d'uso della protezione dei contenuti dall'API v2 alla nuova API di Servizi multimediali di Azure v3.

Proteggere il contenuto nell'API v3

Per passaggi specifici, vedere concetti di protezione del contenuto, esercitazioni e guide alla fine di questo articolo.

Nota

Il resto di questo articolo illustra come eseguire la migrazione della protezione del contenuto v2 a v3 con .NET. Se sono necessarie istruzioni o codice di esempio per un linguaggio o un metodo diverso, creare un problema di GitHub per questa pagina.

Deprecazione di AMS come server di recapito delle licenze autonomo (modalità locale ibrida)

L'API v3 non supporta più l'uso dei servizi di recapito delle chiavi come funzionalità autonoma per la protezione del contenuto in cui il servizio di recapito delle chiavi può essere usato per distribuire la licenza per il contenuto trasmesso o distribuito tramite altri server di origine di terze parti. Ciò significa che AMS non supporta più scenari di distribuzione delle chiavi nell'API V3 e richiede di trasmettere da servizi di origine AMS usando pacchetti dinamici e crittografia durante la distribuzione con v3.

Il contenuto esistente crittografato con l'API v2 e viene recapitato in un modello "ibrido" continuerà a funzionare (le chiavi saranno ancora recuperabili nel piano dati), ma la gestione di tali chiavi (aggiornamenti e modifiche) tramite il piano di gestione v2 o v3 non funzionerebbe più dopo il 29 febbraio 2024.

Nota

Tutti i nuovi contenuti forniti usando la versione 3 supportano solo la protezione del contenuto e lo streaming da AMS e non supportano più la modalità "ibrida". Il piano dati continuerà a distribuire chiavi e licenze esistenti create in v2, ma non supporterà più la gestione o gli aggiornamenti tramite l'API v2 o v3.

Visibilità v3 di Asset, StreamingLocators e proprietà

Nell'API v2, Assets, StreamingLocatorse ContentKeys sono stati usati per proteggere il contenuto di streaming. Quando si esegue la migrazione all'API v3, l'API v2 e StreamingLocatorsvengono esposte automaticamente nell'API Assetsv3 e ContentKeys tutti i dati in essi contenuti sono disponibili per accedere.

Tuttavia, non è possibile aggiornare le proprietà nelle entità v2 tramite l'API v3 creata nella versione 2.

Se è necessario aggiornare, modificare o modificare il contenuto archiviato nelle entità v2, aggiornarli con l'API v2 o creare nuove entità API v3 per eseguirne la migrazione.

Differenze dell'identificatore dell'asset

Per eseguire la migrazione, è necessario accedere alle proprietà o alle chiavi di contenuto dagli asset v2. È importante comprendere che l'API v2 usa come chiave di identificazione primaria, ma la nuova API v3 usa AssetId il nome gestione risorse di Azure dell'entità come identificatore primario. La proprietà v2 Asset.Name non viene usata come identificatore univoco. Con l'API v3, il nome dell'asset v2 viene ora visualizzato come Asset.Description.

Ad esempio, se in precedenza si dispone di un asset v2 con l'ID di nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, l'identificatore è ora alla fine del GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Verrà visualizzato quando si elencano gli asset v2 tramite l'API v3.

Tutti gli asset creati e pubblicati usando l'API v2 avranno sia un ContentKey oggetto ContentKeyPolicy che un nell'API v3 anziché un criterio di chiave di contenuto predefinito nell'oggetto StreamingPolicy.

Per altre informazioni, vedere la documentazione dei criteri chiave contenuto e la documentazione dei criteri di streaming .

Usare Strumenti di Azure Media Services Explorer (AMSE) v2 e AMSE v3 affiancati

Usare lo strumento Esplora servizi multimediali di Azure v2 insieme allo strumento Esplora servizi multimediali di Azure v3 per confrontare i dati affiancati per un asset creato e pubblicato tramite le API v2. Le proprietà devono essere tutte visibili, ma in posizioni diverse.

Usare l'esempio di migrazione della protezione dei contenuti .NET

È possibile trovare un esempio di codice per confrontare le differenze negli identificatori di asset usando l'oggetto v2tov3MigrationSample in ContentProtection negli esempi di codice di Servizi multimediali.

Elencare i localizzatori di streaming

È possibile eseguire una query sull'oggetto StreamingLocators associato agli asset creati nell'API v2 usando il nuovo metodo ListStreamingLocators nell'entità Asset. Fare riferimento anche alla versione dell'SDK client .NET di ListStreamingLocatorsAsync

I risultati del ListStreamingLocators metodo forniscono l'oggetto Name e StreamingLocatorId del localizzatore insieme a StreamingPolicyName.

Trovare le chiavi di contenuto

Per trovare l'oggetto usato con , ContentKeys è possibile chiamare il metodo StreamingLocator.ListContentKeysAsync.StreamingLocators

Per altre informazioni sulla protezione dei contenuti nell'API v3, vedere l'articolo Proteggere il contenuto con la crittografia dinamica di Servizi multimediali.

Modificare contentKeyPolicy v2 mantenendo lo stesso ContentKey

È necessario prima annullare la pubblicazione (rimuovere tutti i localizzatori di streaming) nell'asset tramite l'SDK v2. Ecco come:

  1. Eliminare il localizzatore.
  2. Scollegare l'oggetto ContentKeyAuthorizationPolicy.
  3. Scollegare l'oggetto AssetDeliveryPolicy.
  4. Scollegare l'oggetto ContentKey.
  5. Eliminare .ContentKey
  6. Creare una nuova StreamingLocator versione 3 usando una versione 3 StreamingPolicy e ContentKeyPolicy, specificando l'identificatore di chiave di contenuto e il valore della chiave specifici necessari.

Nota

È possibile eliminare il localizzatore v2 usando l'API v3, ma non rimuoverà la chiave di contenuto o i criteri della chiave di contenuto se sono stati creati nell'API v2.

Concetti di protezione del contenuto, esercitazioni e guide

Concetti

Esercitazioni

Avvio rapido: Usare il portale per crittografare contenuto

Guide pratiche

Strumenti

Guida e supporto tecnico

È possibile contattare Servizi multimediali con domande o seguire gli aggiornamenti in base a uno dei metodi seguenti: