Tartalomvédelmi forgatókönyvalapú migrálási útmutató

  • Cikk

migrálási útmutató emblémája

migrálási lépések 2

Fontos

Már nem szükséges migrálni az Azure Media Service v2-ről a v3-ra, mivel a V2 API elavulása igazodik az Azure Media Services kivonásához. További információt az Azure Media Services kivonási útmutatójában talál.

Ez a cikk a tartalomvédelmi használati esetek v2 API-ról az új Azure Media Services v3 API-ra való migrálásával kapcsolatos részleteket és útmutatást nyújt.

Tartalom védelme a v3 API-ban

A cikk végén a tartalomvédelmi fogalmakat, oktatóanyagokat és útmutatókat tekinthet meg.

Megjegyzés

A cikk további része azt ismerteti, hogyan migrálhatja a v2 tartalomvédelmet a v3-ra a .NET-tel. Ha egy másik nyelvhez vagy metódushoz útmutatásra vagy mintakódra van szüksége, hozzon létre egy GitHub-problémát ehhez a laphoz.

Az AMS elavulása önálló licenckézbesítési kiszolgálóként (hibrid helyszíni mód)

A v3 API már nem támogatja a kulcskézbesítési szolgáltatások használatát a tartalomvédelem különálló funkciójaként, ahol a kulcskézbesítési szolgáltatás használható a más külső forráskiszolgálókon keresztül streamelt vagy kézbesített tartalmak licencének kézbesítésére. Ez azt jelenti, hogy az AMS már nem támogatja a kulcskézbesítési forgatókönyveket a V3 API-ban, és dinamikus csomagolással és titkosítással kell streamelnie az AMS forrásszolgáltatásaiból a v3-val való kézbesítéskor.

A v2 API-val titkosított és "hibrid" modellben szállított meglévő tartalom továbbra is működni fog (a kulcsok továbbra is lekérthetők lesznek az adatsíkon), de a kulcsok (frissítések és szerkesztések) v2 felügyeleti síkon vagy v3 felügyeleti síkon keresztül történő kezelése 2024. február 29. után már nem működik.

Megjegyzés

A v3-at használó összes új tartalom csak a tartalomvédelmet és az AMS-ből való streamelést támogatja, és a továbbiakban nem támogatja a "hibrid" módot. Az adatsík továbbra is biztosítja a v2-ben létrehozott meglévő kulcsokat és licenceket, de a v2 vagy v3 API-n keresztül már nem támogatja a felügyeletet vagy a frissítéseket.

v3 a v2-eszközök, a StreamingLocators és a tulajdonságok láthatósága

A v2 API-ban, a Assets, StreamingLocatorsés ContentKeys a streamelési tartalom védelmére lettek használva. A v3 API-ra való migráláskor a v2 API Assets, StreamingLocatorsa , és ContentKeys mind automatikusan elérhetővé válnak a v3 API-ban, és a rajtuk lévő összes adat elérhető lesz az Ön számára.

A v2-entitások tulajdonságai azonban nem frissíthetők a v2-ben létrehozott v3 API-n keresztül.

Ha frissítenie, módosítania vagy módosítania kell a v2 entitásokon tárolt tartalmakat, frissítse őket a v2 API-val, vagy hozzon létre új v3 API-entitásokat a migrálásukhoz.

Eszközazonosítók eltérései

A migráláshoz hozzá kell férnie a v2-eszközök tulajdonságaihoz vagy tartalomkulcsaihoz. Fontos tisztában lenni azzal, hogy a v2 API elsődleges azonosítókulcsként használja a AssetId v2 API-t, az új v3 API azonban az entitás Azure Resource Management-nevét használja elsődleges azonosítóként. (A v2 Asset.Name tulajdonság nem használatos egyedi azonosítóként.) A v3 API-val a v2-eszköz neve mostantól a Asset.Descriptionkövetkezőként jelenik meg: .

Ha például korábban volt egy v2-objektuma nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8a azonosítójával, az azonosító most a GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8végén található. Ez akkor jelenik meg, ha a v2-eszközöket a v3 API-val listázzuk.

A v2 API-val létrehozott és közzétett eszközök a v3 API-ban is rendelkeznek egy ContentKeyPolicy és egy ContentKey értékkel, nem pedig az alapértelmezett tartalomkulcs-szabályzattal a StreamingPolicykiszolgálón.

További információkért tekintse meg a Tartalomkulcs-szabályzat dokumentációját és a Streamszabályzat dokumentációját .

Az Azure Media Services Explorer (AMSE) v2 és AZ AMSE v3 eszközök használata egymás mellett

A v2 Azure Media Services Explorer eszköz és a v3 Azure Media Services Explorer eszközzel összehasonlíthatja a v2 API-kkal létrehozott és közzétett objektumok adatait egymás mellett. A tulajdonságoknak mind láthatónak kell lenniük, de különböző helyeken.

A .NET tartalomvédelmi migrálási minta használata

A Media Services-kódmintákBan található ContentProtection területen található v2tov3MigrationSample használatával összehasonlíthatja az eszközazonosítók különbségeit.

A streamelési lokátorok listázása

A StreamingLocators v2 API-ban létrehozott eszközökhöz társított adatokat az Eszköz entitás Új v3 metódusa, a ListStreamingLocators használatával kérdezheti le. Hivatkozzon a ListStreamingLocatorsAsync .NET-ügyfél SDK-verziójára is

A metódus eredményei a ListStreamingLocators lokátor és StreamingLocatorId a lokátor értékét adják Name meg a StreamingPolicyNamekövetkezővel együtt: .

A tartalomkulcsok megkeresése

A ContentKeys használatával használt StreamingLocatorsadatok megkereséséhez meghívhatja a StreamingLocator.ListContentKeysAsync metódust.

A v3 API tartalomvédelméről további információt a Tartalom védelme a Media Services dinamikus titkosításával című cikkben talál.

Módosítsa a 2-s verziós ContentKeyPolicy-t ugyanazzal a ContentKey-sel

Először a v2 SDK-n keresztül kell megszüntetnie a közzétételt (az összes streamelési lokátor eltávolítását). Ezt a következőképpen teheti meg:

  1. Törölje a lokátort.
  2. A leválasztása.ContentKeyAuthorizationPolicy
  3. A leválasztása.AssetDeliveryPolicy
  4. A leválasztása.ContentKey
  5. Törölje a következőt ContentKey: .
  6. Hozzon létre egy újat StreamingLocator a v3 és ContentKeyPolicya v3 StreamingPolicy használatával, megadva a szükséges tartalomkulcs-azonosítót és kulcsértéket.

Megjegyzés

A v2-lokátor törölhető a v3 API használatával, de ez nem távolítja el a tartalomkulcsot vagy a tartalomkulcs-szabályzatot, ha a v2 API-ban lettek létrehozva.

Tartalomvédelmi fogalmak, oktatóanyagok és útmutatók

Alapelvek

Oktatóanyagok

Rövid útmutató: A portál használata a tartalom titkosításához

Útmutatók

Eszközök

Súgó és támogatás

Kérdéseket tehet fel a Media Serviceshez, vagy kövesse a frissítéseket az alábbi módszerek egyikével: