Szenariobasierter Migrationsleitfaden für den Inhaltsschutz

  • Artikel

Logo des Migrationsleitfadens

Schritte bei der Migration 2

Wichtig

Es ist nicht mehr erforderlich, von Azure Media Service v2 zu v3 zu migrieren, da die Veraltetkeit der V2-API mit der Einstellung von Azure Media Services übereinstimmt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von Azure Media Services .

Dieser Artikel enthält ausführliche Informationen und Anleitungen zur Migration von Inhaltsschutz-Anwendungsfällen von der v2-API bis zur neuen Azure Media Services v3-API.

Inhaltsschutz in der V3-API

Die zugehörigen Schritte finden Sie in den Konzepten, Tutorials und Schrittanleitungen zum Inhaltsschutz am Ende dieses Artikels.

Hinweis

Im weiteren Verlauf dieses Artikels wird erläutert, wie Sie Ihren v2-Inhaltsschutz mit .NET zu v3 migrieren können. Wenn Sie Anweisungen oder Beispielcode für eine andere Sprache oder Methode benötigen, erstellen Sie ein GitHub-Problem für diese Seite.

Einstellung von AMS als eigenständiger Lizenzbereitstellungsserver (hybrid-lokaler Modus)

Für die v3-API wurde die Unterstützung der Schlüsselübermittlungsdienste als eigenständige Funktion für den Inhaltsschutz für Anwendungsfälle eingestellt, in denen der Schlüsselübermittlungsdienst für die Bereitstellung von Lizenzen für Inhalte verwendet wird, die über Ursprungsserver von Drittanbietern gestreamt bzw. übertragen werden. Das bedeutet, dass AMS in der v3-API keine Szenarien mehr unterstützt, die nur die Schlüsselübermittlung beinhalten, sondern für die Bereitstellung mit v3 ein Streaming von AMS-Ursprungsservern mit dynamischer Paketerstellung und Verschlüsselung voraussetzt.

Vorhandene Inhalte, die mit der v2-API verschlüsselt und im Rahmen eines „Hybridmodells“ bereitgestellt wurden, funktionieren weiterhin, d. h., die Schlüssel können nach wie vor auf Datenebene abgerufen werden. Die Verwaltung dieser Schlüssel (Aktualisierungen und Bearbeitungen) sowohl in v2 als auch in v3 wird jedoch ab 29. Februar 2024 nicht mehr unterstützt.

Hinweis

Alle neuen Inhalte, die mit v3 bereitgestellt werden, unterstützen Inhaltsschutz und Streaming nur aus AMS. Der „Hybridmodus“ wird für diese Inhalte nicht unterstützt. Die Datenebene liefert weiterhin bestehende, in v2 erstellte Schlüssel und Lizenzen, jedoch wird die Verwaltung oder Aktualisierung über die v2- oder v3-API nicht mehr unterstützt.

v3-Sichtbarkeit von v2-Ressourcen, StreamingLocators und Eigenschaften

In der v2-API wurden Assets, StreamingLocators und ContentKeys verwendet, um Ihre Streaminginhalte zu schützen. Wenn Sie zur v3-API migrieren, werden Ihre v2-API-Assets, -StreamingLocators und -ContentKeys automatisch in der v3-API verfügbar gemacht, und Sie können auf alle auf ihnen befindlichen Daten zugreifen.

Allerdings können Sie keine Eigenschaften von v2-Entitäten über die v3-API aktualisieren, die in v2 erstellt wurden.

Wenn Sie in v2-Entitäten gespeicherte Inhalte aktualisieren oder ändern müssen, aktualisieren Sie diese mit der v2-API, oder erstellen Sie neue v3-API-Entitäten, um sie zu migrieren.

Unterschiede bei Ressourcenbezeichnern

Um zu migrieren, müssen Sie auf Eigenschaften oder Inhaltsschlüssel aus Ihren v2-Ressourcen zugreifen. Sie müssen wissen, dass die v2-API die AssetId als primären Identifikationsschlüssel verwendet, aber die neue v3-API den Azure-Ressourcenverwaltungsnamen der Entität als primären Bezeichner verwendet. (Die v2-Asset.Name-Eigenschaft wird nicht als eindeutiger Bezeichner verwendet.) Mit der v3-API wird der v2-Ressourcenname nun als Asset.Description angezeigt.

Wenn Sie z. B. zuvor über eine v2-Ressource mit der ID nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8 verfügten, befindet sich der Bezeichner nun am Ende der GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Dies wird angezeigt, wenn Sie Ihre v2-Ressourcen über die v3-API auflisten.

Alle Ressourcen, die mit der v2-API erstellt und veröffentlicht wurden, verfügen in der v3-API sowohl über eine ContentKeyPolicy als auch einen ContentKey anstelle einer standardmäßigen Inhaltsschlüsselrichtlinie in der StreamingPolicy.

Weitere Informationen finden Sie in den Dokumentationen Richtlinien für Inhaltsschlüssel und Streamingrichtlinien.

Parallele Verwendung von Azure Media Services Explorer (AMSE) v2- und AMSE v3-Tools

Verwenden Sie das v2 Azure Media Services Explorer-Tool zusammen mit dem v3 Azure Media Services Explorer-Tool, um die Daten für eine über v2-APIs erstellte und veröffentlichte Ressource nebeneinander zu vergleichen. Alle Eigenschaften sollten sichtbar sein, aber an verschiedenen Orten.

Verwenden des .NET-Inhaltsschutz-Migrationsbeispiels

Ein Codebeispiel zum Vergleichen der Unterschiede in Ressourcenbezeichnern mit v2tov3MigrationSample finden Sie unter ContentProtection in den Media Services-Codebeispielen.

Auflisten der Streaminglocators

Sie können die StreamingLocators, die mit den in der v2-API mit der neuen v3-Methode ListStreamingLocators erstellten Ressourcen verknüpft sind, auf der Ressourcenentität abfragen. Verweisen Sie auch auf die .NET-Client-SDK-Version von ListStreamingLocatorsAsync.

Die Ergebnisse der ListStreamingLocators-Methode stellen für Sie den Name und die StreamingLocatorId des Locators zusammen mit dem StreamingPolicyName bereit.

Suchen der Inhaltsschlüssel

Um die mit Ihren StreamingLocators verwendeten ContentKeys zu suchen, können Sie die StreamingLocator.ListContentKeysAsync-Methode aufrufen.

Weitere Informationen zum Inhaltsschutz in der v3-API finden Sie im Artikel Schützen Sie Ihren Inhalt mit der dynamischen Verschlüsselung von Media Services.

Ändern der v2-ContentKeyPolicy unter Beibehalten desselben ContentKey-Werts

Sie sollten zuerst die Veröffentlichung auf der Ressource über das v2-SDK aufheben (alle Streaminglocators entfernen). Gehen Sie dazu wie folgt vor:

  1. Löschen Sie den Locator.
  2. Heben Sie die Verknüpfung der ContentKeyAuthorizationPolicy auf.
  3. Heben Sie die Verknüpfung der AssetDeliveryPolicy auf.
  4. Heben Sie die Verknüpfung des ContentKey auf.
  5. Löschen Sie den ContentKey.
  6. Erstellen Sie einen neuen StreamingLocator in v3 mit einer v3-StreamingPolicy und einer v3-ContentKeyPolicy, und geben Sie dabei den spezifischen Inhaltsschlüsselbezeichner und den erforderlichen Schlüsselwert an.

Hinweis

Es ist möglich, den v2-Locator mit der v3-API zu löschen, aber dadurch wird der Inhaltsschlüssel oder die Inhaltsschlüsselrichtlinie nicht entfernt, wenn sie in der v2-API erstellt wurden.

Konzepte, Tutorials und Schrittanleitungen zum Inhaltsschutz

Konzepte

Lernprogramme

Schnellstart: Verschlüsseln von Inhalten mithilfe des Portals

Anleitungen

Tools

Anfordern von Hilfe und Support

Sie können Media Services mit Fragen kontaktieren oder unsere Updates mit einer der folgenden Methoden verfolgen: