Wskazówki dotyczące migracji oparte na scenariuszach ochrony zawartości

  • Artykuł

logo przewodnika migracji

kroki migracji 2

Ważne

Nie trzeba już migrować z usługi Azure Media Service w wersji 2 do wersji 3, ponieważ wycofanie interfejsu API w wersji 2 będzie zgodne z wycofaniem usługi Azure Media Services. Aby uzyskać więcej informacji, zobacz przewodnik po wycofaniu usługi Azure Media Services .

Ten artykuł zawiera szczegółowe informacje i wskazówki dotyczące migracji przypadków użycia ochrony zawartości z interfejsu API w wersji 2 do nowego interfejsu API usługi Azure Media Services w wersji 3.

Ochrona zawartości w interfejsie API w wersji 3

Aby uzyskać szczegółowe instrukcje, zapoznaj się z pojęciami, samouczkami i instrukcjami dotyczącymi ochrony zawartości na końcu tego artykułu.

Uwaga

W dalszej części tego artykułu omówiono sposób migrowania ochrony zawartości w wersji 2 do wersji 3 przy użyciu platformy .NET. Jeśli potrzebujesz instrukcji lub przykładowego kodu dla innego języka lub metody, utwórz problem z usługą GitHub dla tej strony.

Wycofanie usługi AMS jako autonomicznego serwera dostarczania licencji (tryb hybrydowy lokalny)

Interfejs API w wersji 3 nie obsługuje już korzystania z usług dostarczania kluczy jako autonomicznej funkcji ochrony zawartości, w której usługa dostarczania kluczy może służyć do dostarczania licencji na zawartość przesyłaną strumieniowo lub dostarczaną za pośrednictwem innych serwerów pochodzenia innych firm. Oznacza to, że usługa AMS nie obsługuje już scenariuszy dostarczania kluczy tylko w interfejsie API w wersji 3 i wymaga przesyłania strumieniowego z usług źródłowych amS przy użyciu pakietów dynamicznych i szyfrowania podczas dostarczania przy użyciu wersji 3.

Istniejąca zawartość zaszyfrowana za pomocą interfejsu API w wersji 2 i dostarczana w modelu hybrydowym będzie nadal działać (klucze będą nadal pobierane na płaszczyźnie danych), ale zarządzanie tymi kluczami (aktualizacjami i edycjami) za pośrednictwem płaszczyzny zarządzania w wersji 2 lub v3 nie będzie już działać po 29 lutego 2024 r.

Uwaga

Cała nowa zawartość dostarczana przy użyciu programu v3 będzie obsługiwać tylko ochronę zawartości i przesyłanie strumieniowe z systemu AMS i nie obsługuje już trybu "hybrydowego". Płaszczyzna danych będzie nadal dostarczać istniejące klucze i licencje utworzone w wersji 2, ale nie będzie już obsługiwać zarządzania ani aktualizacji za pośrednictwem interfejsu API w wersji 2 lub 3.

Widoczność 3 zasobów w wersji 2, przesyłania strumieniowego przydziałów i właściwości

W interfejsie API w wersji 2 użyto elementów Assets, StreamingLocatorsi ContentKeys do ochrony zawartości przesyłanej strumieniowo. Podczas migracji do interfejsu API w wersji 3 interfejs API w wersji 2 i wszystkie są automatycznie uwidocznione w interfejsie API AssetsStreamingLocatorsContentKeys w wersji 3, a wszystkie dane na nich są dostępne do uzyskania dostępu.

Nie można jednak zaktualizować żadnych właściwości w jednostkach w wersji 2 za pomocą interfejsu API w wersji 3 utworzonego w wersji 2.

Jeśli musisz zaktualizować, zmienić lub zmienić zawartość przechowywaną w jednostkach w wersji 2, zaktualizuj je za pomocą interfejsu API w wersji 2 lub utwórz nowe jednostki interfejsu API w wersji 3, aby je zmigrować.

Różnice identyfikatorów zasobów

Aby przeprowadzić migrację, musisz uzyskać dostęp do właściwości lub kluczy zawartości z zasobów w wersji 2. Ważne jest, aby zrozumieć, że interfejs API w wersji 2 używa elementu AssetId jako podstawowego klucza identyfikacji, ale nowy interfejs API w wersji 3 używa nazwy usługi Azure Resource Management jednostki jako identyfikatora podstawowego. (Właściwość v2 Asset.Name nie jest używana jako unikatowy identyfikator). Przy użyciu interfejsu API w wersji 3 nazwa zasobu w wersji 2 jest teraz wyświetlana Asset.Descriptionjako .

Jeśli na przykład wcześniej miałeś element zawartości w wersji 2 o identyfikatorze nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, identyfikator znajduje się teraz na końcu identyfikatora GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Zobaczysz to podczas wyświetlania listy zasobów w wersji 2 za pośrednictwem interfejsu API w wersji 3.

Wszystkie zasoby, które zostały utworzone i opublikowane przy użyciu interfejsu API w wersji 2, będą miały zarówno element i ContentKeyPolicy w ContentKey interfejsie API w wersji 3, jak i domyślne zasady klucza zawartości w systemie StreamingPolicy.

Aby uzyskać więcej informacji, zobacz dokumentację zasad klucza zawartości i dokumentację zasad przesyłania strumieniowego .

Używanie narzędzi Azure Media Services Explorer (AMSE) w wersji 2 i AMSE w wersji 3 obok siebie

Użyj narzędzia Azure Media Services Explorer w wersji 2 wraz z narzędziem Azure Media Services Explorer w wersji 3, aby porównać dane obok siebie dla zasobu utworzonego i opublikowanego za pośrednictwem interfejsów API w wersji 2. Wszystkie właściwości powinny być widoczne, ale w różnych lokalizacjach.

Korzystanie z przykładu migracji ochrony zawartości platformy .NET

Przykładowy kod można znaleźć, aby porównać różnice w identyfikatorach zasobów przy użyciu elementu v2tov3MigrationSample w obszarze ContentProtection w przykładach kodu usługi Media Services.

Wyświetlanie listy lokalizatorów przesyłania strumieniowego

Możesz wykonać zapytanie StreamingLocators skojarzone z zasobami utworzonymi w interfejsie API w wersji 2 przy użyciu nowej metody v3 ListStreamingLocators w jednostce Asset. Zapoznaj się również z wersją zestawu SDK klienta platformy .NET listStreamingLocatorsAsync

Wyniki ListStreamingLocators metody zapewnią Name element i StreamingLocatorId lokalizatora wraz z elementem StreamingPolicyName.

Znajdowanie kluczy zawartości

Aby znaleźć ContentKeys używane z programem StreamingLocators, możesz wywołać metodę StreamingLocator.ListContentKeysAsync .

Aby uzyskać więcej informacji na temat ochrony zawartości w interfejsie API w wersji 3, zobacz artykuł Ochrona zawartości za pomocą szyfrowania dynamicznego usługi Media Services.

Zmień właściwość ContentKeyPolicy w wersji 2, zachowując tę samą wartość ContentKey

Najpierw należy cofnąć publikowanie (usunąć wszystkie lokalizatory przesyłania strumieniowego) na zasobie za pośrednictwem zestawu SDK w wersji 2. Oto kroki tej procedury:

  1. Usuń lokalizator.
  2. Odłączanie pliku ContentKeyAuthorizationPolicy.
  3. Odłączanie pliku AssetDeliveryPolicy.
  4. Odłączanie pliku ContentKey.
  5. Usuń element ContentKey.
  6. Utwórz nowy StreamingLocator element w wersji 3 przy użyciu wersji 3 StreamingPolicy i ContentKeyPolicy, określając wymagany identyfikator klucza zawartości i wartość klucza.

Uwaga

Istnieje możliwość usunięcia lokalizatora w wersji 2 przy użyciu interfejsu API w wersji 3, ale nie spowoduje to usunięcia klucza zawartości ani zasad klucza zawartości, jeśli zostały utworzone w interfejsie API w wersji 2.

Pojęcia, samouczki i przewodniki dotyczące ochrony zawartości

Pojęcia

Samouczki

Szybki start: szyfrowanie zawartości przy użyciu portalu

Przewodniki z instrukcjami

Narzędzia

Uzyskiwanie pomocy i obsługi technicznej

Możesz skontaktować się z usługą Media Services z pytaniami lub postępować zgodnie z naszymi aktualizacjami przy użyciu jednej z następujących metod: