Panduan ini menjelaskan cara membuat tanda tangan, serta kolom wajib dan opsional untuk tanda tangan.
Untuk membuat tanda tangan, tulis string yang akan ditandatangani, yang kami sebut sebagai nilai bertanda tangan dalam panduan ini. Nilai yang ditandatangani mencakup parameter yang menjelaskan konten yang Anda lindungi, waktu habis masa berlaku nilai yang ditandatangani, dan seterusnya.
Anda menggunakan nilai yang ditandatangani saat membuat string tanda tangan. Anda membuat string tanda tangan dengan menyusun parameter untuk tanda tangan, seperti tanda tangan Ed25519 kunci asimetris dari nilai yang ditandatangani.
Media CDN menggunakan tanda tangan final yang telah disusun untuk membantu melindungi konten Anda.
Format penandatanganan yang didukung
Media CDN mendukung format permintaan bertanda tangan berikut ini.
Format | Perilaku | Contoh |
---|---|---|
Parameter kueri (URL persis) |
URL yang persis, untuk memberikan akses ke URL tertentu. |
Tepat:
|
Parameter kueri (awalan URL) |
Menentukan URLPrefix memungkinkan Anda menandatangani awalan dan menambahkan
parameter kueri yang sama ke beberapa URL dalam pemutar atau pembuatan
manifes.
|
Apa yang harus ditandatangani:
Ganti |
Komponen jalur |
Awalan: memungkinkan akses ke URL apa pun dengan awalan sebelum komponen
Hal ini memungkinkan URL manifes relatif untuk otomatis mewarisi komponen URL yang ditandatangani saat mengambil sub-resource. |
https://media.example.com/video/edge-cache-token=Expires=EXPIRATION
|
Cookie yang ditandatangani | Awalan: cookie memungkinkan akses ke URL apa pun dengan awalan yang ditentukan
dalam nilai URLPrefix yang ditandatangani.
|
Edge-Cache-Cookie:
|
Membuat tanda tangan
Buat nilai yang ditandatangani dengan menggabungkan string yang berisi kolom tanda tangan yang diperlukan dan kolom tanda tangan opsional yang diinginkan.
Jika ditentukan,
URLPrefix
harus muncul terlebih dahulu, diikuti denganExpires
,KeyName
, lalu parameter opsional apa pun.Pisahkan setiap kolom dan parameter dengan hal berikut:
- Untuk cookie, gunakan karakter
:
titik dua. - Untuk parameter kueri dan komponen jalur, gunakan karakter
&
ampersand.
- Untuk cookie, gunakan karakter
Tanda tangani nilai yang ditandatangani dengan tanda tangan Ed25519.
Tambahkan pemisah kolom (
:
atau&
) diikuti denganSignature=
dan tanda tangan Ed25519 ke akhir string.
Membuat URL yang ditandatangani
Contoh kode berikut menunjukkan cara membuat URL bertanda tangan secara terprogram.
Go
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Buat awalan URL yang ditandatangani
Contoh kode berikut menunjukkan cara membuat awalan URL yang ditandatangani secara terprogram.
Go
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat cookie URL yang ditandatangani
Contoh kode berikut menunjukkan cara membuat cookie URL bertanda tangan secara terprogram.
Go
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat komponen jalur yang ditandatangani
Contoh kode berikut menunjukkan cara membuat komponen jalur yang ditandatangani secara terprogram.
Python
Untuk mengautentikasi ke Media CDN, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Kolom tanda tangan yang wajib diisi
Kolom berikut wajib diisi untuk setiap tanda tangan:
Expires
KeyName
Signature
Jika ada parameter kueri, parameter tersebut harus dikelompokkan bersama sebagai parameter terakhir di URL. Kecuali jika ditentukan lain, nama parameter dan nilainya peka huruf besar/kecil.
Tabel berikut menjelaskan setiap parameter:
Nama kolom | Parameter tanda tangan | Nilai yang ditandatangani |
---|---|---|
Expires |
Bilangan bulat detik yang telah berlalu sejak epoch Unix (1970-01-01T00:00:00Z) | Expires=EXPIRATION_TIME , yang setelahnya
tanda tangan tersebut tidak lagi valid. |
KeyName |
Nama EdgeCacheKeyset yang digunakan untuk menandatangani permintaan ini. KeyName merujuk pada keseluruhan keyset, bukan kunci individual dalam keyset itu sendiri.
|
KeyName=EDGE_CACHE_KEYSET |
Signature |
Versi tanda tangan yang dienkode dengan base-64. | Tidak berlaku |
Kolom tanda tangan opsional
Jika ada parameter kueri, parameter tersebut harus dikelompokkan bersama sebagai parameter terakhir di URL. Kecuali jika ditentukan lain, nama parameter dan nilainya peka huruf besar/kecil.
Tabel berikut menjelaskan nama dan detail setiap parameter untuk parameter tanda tangan opsional:
Nama kolom | Parameter tanda tangan | Nilai yang ditandatangani |
---|---|---|
HeaderName |
Nama kolom header permintaan bernama yang harus ada dalam permintaan. Harus berupa huruf kecil saat ditandatangani karena nama kolom header peka huruf besar/kecil. Media CDN membuat header menjadi huruf kecil sebelum memvalidasi tanda tangan. |
HeaderName=HEADER_NAME |
HeaderValue |
Nilai kolom header permintaan bernama yang harus ada dalam permintaan. ID ini biasanya adalah ID pengguna atau ID buram lainnya. Permintaan dengan HeaderValue tetapi tanpa HeaderName akan ditolak.
|
HeaderValue=HEADER_VALUE |
IPRanges |
Daftar hingga lima alamat IPv4 dan IPv6 dalam format CIDR yang URL ini valid dalam format base64 yang aman bagi web. Misalnya, untuk menentukan rentang IP "192.6.13.13/32,193.5.64.135/32", Anda menentukan IPRange mungkin tidak berguna untuk menyertakan tanda tangan ketika klien berisiko mengalami migrasi WAN, atau saat jalur jaringan ke frontend aplikasi Anda berbeda dengan jalur pengiriman.
Media CDN menolak klien yang memiliki kode Berikut adalah kasus yang dapat menyebabkan Media CDN menolak klien dengan kode
Semua faktor ini dapat berkontribusi agar klien tertentu memiliki alamat IP nondeterministik selama sesi pemutaran video. Jika alamat IP klien berubah setelah Anda memberikan akses, dan klien mencoba mendownload segmen video ke buffer pemutaran, mereka akan menerima |
IPRanges=BASE_64_IP_RANGES |
URLPrefix |
Awalan URL base64 (aman URL) yang akan diberi akses. Menentukan
URLPrefix memungkinkan Anda menandatangani awalan dan menambahkan parameter kueri
yang sama ke beberapa URL dalam pemutar atau pembuatan manifes.
URLPrefix diperlukan saat menggunakan format cookie
yang ditandatangani.
|
URLPrefix=BASE_64_URL_PREFIX |