View a markdown version of this page

API SPECE v2.0 - Spesifikasi API Pertukaran Kunci Pengemas dan Encoder yang Aman

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

API SPECE v2.0

Ini adalah REST API untuk Secure Packager dan Encoder Key Exchange (SPEKE) v2. Gunakan spesifikasi ini untuk memberikan perlindungan hak cipta DRM bagi pelanggan yang menggunakan enkripsi. Untuk menjadi SPEKE-compliant, penyedia kunci DRM Anda harus mengekspos REST API yang dijelaskan dalam spesifikasi ini. Enkripsi membuat panggilan API ke penyedia kunci Anda.

catatan

Contoh kode dalam spesifikasi ini hanya untuk tujuan ilustrasi. Anda tidak dapat menjalankan contoh karena mereka bukan bagian dari implementasi SPEKE lengkap.

SPEKE menggunakan definisi struktur data DASH Industry Industry Forum Content Protection Information Exchange Format (DASH-IF-CPIX) untuk pertukaran kunci, dengan beberapa batasan. DASH-IF-CPIX mendefinisikan skema untuk menyediakan pertukaran multi-DRM yang dapat diperluas dari platform DRM ke enkripsi. Ini memungkinkan enkripsi konten untuk semua format pengemasan bitrate adaptif pada saat kompresi dan pengemasan konten. Format pengemasan bitrate adaptif termasuk HLS, DASH, dan MSS.

Dimulai dengan versi 2.0, SPEKE disejajarkan pada versi CPIX tertentu:

Di sisi SPEKE, ini diberlakukan melalui penggunaan header X-Speke-Version HTTP, dan di sisi CPIX melalui penggunaan atribut. CPIX@version Kurangnya elemen-elemen ini dalam permintaan adalah tipikal alur kerja lama SPEKE v1. Dalam alur kerja SPEKE v2, penyedia kunci diharapkan untuk memproses dokumen CPIX hanya jika mendukung kedua parameter versi.

Untuk informasi rinci tentang format pertukaran, lihat spesifikasi DASH Industry Forum CPIX 2.3.

Secara keseluruhan, SPEKE v2.0 membawa evolusi berikut dibandingkan dengan SPEKE v1.0:

  • Semua tag dari namespace XML SPEKE tidak digunakan lagi demi tag setara di namespace XML CPIX

  • SPEKE:ProtectionHeadertidak digunakan lagi dan diganti dengan CPIX:DRMSystem.SmoothStreamingProtectionHeaderData

  • CPIX:URIExtXKey, SPEKE:KeyFormat dan SPEKE:KeyFormatVersions tidak digunakan lagi dan diganti dengan CPIX:DRMSystem.HLSSignalingData

  • CPIX@iddigantikan oleh CPIX@contentId

  • Atribut CPIX wajib baru:CPIX@version, ContentKey@commonEncryptionScheme

  • Elemen CPIX opsional baru: DRMSystem.ContentProtectionData

  • Dukungan untuk beberapa kunci konten

  • Cross-versioning mekanisme antara SPEKE dan CPIX

  • Evolusi header HTTP: X-Speke-Version header baru, Speke-User-Agent header diganti namanya menjadi X-Speke-User-Agent

  • Penghentian Heartbeat API

Karena spesifikasi SPEKE v1.0 tetap tidak berubah, implementasi yang ada tidak perlu diubah untuk terus mendukung alur kerja SPEKE v1.0.