Panduan migrasi berbasis skenario proteksi konten

  • Artikel

logo panduan migrasi

langkah migrasi 2

Penting

Tidak perlu lagi bermigrasi dari Azure Media Service v2 ke v3 karena penghentian V2 API akan selaras dengan penghentian Azure Media Services. Silakan lihat panduan penghentian Azure Media Services untuk informasi selengkapnya.

Artikel ini berisi detail dan panduan tentang migrasi kasus penggunaan perlindungan konten dari API v2 ke Api Azure Media Services v3 baru.

Melindungi konten dalam API v3

Lihat konsep perlindungan konten, tutorial, dan panduan cara penggunaan di akhir artikel ini untuk langkah-langkah tertentu.

Catatan

Bagian lain dari artikel ini membahas bagaimana Anda dapat memigrasikan perlindungan konten v2 ke v3 dengan .NET. Jika Anda memerlukan instruksi atau contoh kode untuk bahasa pemrogram atau metode lain, ajukan masalah GitHub untuk halaman ini.

Penghentian AMS sebagai server pengiriman lisensi mandiri (mode lokal hibrid)

API v3 tidak lagi mendukung penggunaan layanan pengiriman kunci sebagai fitur mandiri untuk perlindungan konten di mana layanan pengiriman kunci dapat digunakan untuk mengirimkan lisensi untuk konten yang dialirkan atau dikirimkan melalui server asal pihak ke-3 lainnya. Ini berarti bahwa AMS tidak lagi mendukung skenario pengiriman kunci saja di API V3, dan mengharuskan Anda melakukan streaming dari layanan asal AMS menggunakan pengemasan dan enkripsi dinamis saat mengirimkan dengan v3.

Konten yang ada yang dienkripsi dengan API v2 dan dikirimkan dalam model "hibrid' akan terus berfungsi (kunci masih akan dapat diambil pada bidang data,) tetapi manajemen kunci tersebut (pembaruan dan pengeditan) melalui bidang manajemen v2 atau bidang manajemen v3 tidak akan lagi berfungsi setelah 29 Februari 2024.

Catatan

Semua konten baru yang dikirimkan menggunakan v3 hanya akan mendukung perlindungan konten dan streaming dari AMS dan tidak lagi mendukung mode "hibrid". Bidang data akan terus mengirimkan kunci dan lisensi yang ada yang dibuat di v2, tetapi tidak akan lagi mendukung manajemen atau pembaruan melalui API v2 atau v3.

Visibilitas v3 Aset v2, StreamingLocator, dan properti

Dalam API v2, Assets, StreamingLocators, dan ContentKeys digunakan untuk melindungi konten streaming Anda. Saat bermigrasi ke API v3, API v2 Assets, StreamingLocators, dan ContentKeys Anda diekspos secara otomatis dalam API v3 dan Anda dapat mengakses semua data di API tersebut.

Namun, Anda tidak dapat memperbarui properti apa pun pada entitas v2 melalui API v3 yang dibuat di v2.

Jika Anda perlu memperbarui, mengubah, atau mengubah konten yang disimpan di entitas v2, perbarui dengan API v2 atau buat entitas API v3 baru untuk memigrasikannya.

Perbedaan pengidentifikasi aset

Untuk bermigrasi, Anda harus mengakses properti atau kunci konten dari Aset v2 Anda. Perlu diketahui bahwa API v2 menggunakan AssetId sebagai kunci identifikasi utama tetapi API v3 baru menggunakan entitas nama Pengelolaan Sumber Daya Azure sebagai pengidentifikasi utama. (Properti Asset.Name v2 tidak digunakan sebagai pengidentifikasi unik.) Dengan API v3, nama Aset v2 kini muncul sebagai Asset.Description.

Misalnya, jika Anda sebelumnya memiliki Aset v2 dengan ID nb:cid:UUID:8cb39104-122c-496e-9ac5-7f9e2c2547b8, pengidentifikasi kini berada di akhir GUID 8cb39104-122c-496e-9ac5-7f9e2c2547b8. Anda akan melihatnya saat mencantumkan aset v2 melalui API v3.

Setiap Aset yang dibuat dan diterbitkan menggunakan API v2 akan memiliki ContentKeyPolicy dan ContentKey di API v3, bukan kebijakan kunci konten default di StreamingPolicy.

Untuk informasi selengkapnya, lihat dokumentasi Kebijakan kunci konten dan dokumentasi Kebijakan Streaming.

Menggunakan alat Azure Media Services Explorer (AMSE) v2 dan AMSE v3 secara berdampingan

Gunakan alat Azure Media Services Explorer v2 bersama dengan alat Azure Media Services Explorer v3 untuk membandingkan data secara berdampingan untuk Aset yang dibuat dan diterbitkan melalui API v2. Semua properti harus terlihat, tetapi di lokasi yang berbeda.

Menggunakan sampel migrasi proteksi konten .NET

Anda dapat menemukan contoh kode untuk membandingkan perbedaan pengidentifikasi Aset menggunakan v2tov3MigrationSample di bagian ContentProtection dalam contoh kode Media Services.

Mencantumkan Pencari Lokasi Streaming

Anda dapat mengkueri StreamingLocators yang terkait dengan Aset yang dibuat di API v2 menggunakan metode v3 baru ListStreamingLocators di entitas Aset. Lihat juga versi SDK klien .NET ListStreamingLocatorsAsync

Hasil metode ListStreamingLocators akan memberi Anda Name dan StreamingLocatorId dari pencari lokasi bersama dengan StreamingPolicyName.

Menemukan kunci konten

Untuk menemukan ContentKeys yang digunakan dengan StreamingLocators, Anda dapat menggunakan metode StreamingLocator.ListContentKeysAsync.

Untuk informasi selengkapnya tentang perlindungan konten di API v3, lihat artikel Melindungi konten Anda dengan enkripsi dinamis Media Services.

Mengubah ContentKeyPolicy v2 dengan menyimpan ContentKey yang sama

Anda harus membatalkan penerbitan terlebih dahulu (menghapus semua Pencari Lokasi Streaming) pada Aset melalui SDK v2. Berikut caranya:

  1. Hapus pencari lokasi.
  2. Batalkan tautan ContentKeyAuthorizationPolicy.
  3. Batalkan tautan AssetDeliveryPolicy.
  4. Batalkan tautan ContentKey.
  5. Hapus ContentKey.
  6. Buat StreamingLocator baru di v3 menggunakan StreamingPolicy dan ContentKeyPolicy v3, dengan tentukan pengidentifikasi kunci konten tertentu serta nilai kunci yang diperlukan.

Catatan

Pencari lokasi v2 dapat dihapus menggunakan API v3, tetapi tindakan ini tidak akan menghapus kunci konten atau kebijakan kunci konten jika dibuat di API v2.

Konsep perlindungan konten, tutorial, dan cara

Konsep

Tutorial

Mulai cepat: Menggunakan portal untuk mengenkripsi konten

Cara memandu

Alat

Mendapatkan bantuan dan dukungan

Anda dapat menghubungi Media Services dengan pertanyaan atau mengikuti pembaruan kami dengan salah satu metode berikut: