ApsaraVideo VOD:Otentikasi Jarak Jauh

Cara kerja

ApsaraVideo VOD mendukung Penandatanganan URL dan otentikasi jarak jauh untuk mencegah konten Anda diunduh atau di-hotlink secara ilegal. Kedua fitur ini berbeda dalam implementasinya:

• Penandatanganan URL: Anda menetapkan aturan otentikasi untuk nama domain dan mendistribusikannya ke POP CDN. POP CDN kemudian menangani seluruh proses otentikasi. Untuk informasi lebih lanjut, lihat Penandatanganan URL.

• Otentikasi jarak jauh: Anda harus menyediakan dan mengelola server otentikasi sendiri. Saat POP CDN menerima permintaan yang memerlukan otentikasi, permintaan tersebut diteruskan ke server Anda untuk divalidasi.

Diagram berikut menunjukkan proses otentikasi jarak jauh:

1. Pengguna mengirim permintaan untuk sebuah resource ke POP CDN. Permintaan tersebut mencakup parameter otentikasi.

2. POP CDN menerima permintaan pengguna dan meneruskannya ke server otentikasi Anda.

3. Server otentikasi memvalidasi parameter dalam permintaan dan mengembalikan hasilnya ke POP CDN.

4. POP CDN memproses permintaan pengguna berdasarkan hasil otentikasi. Jika otentikasi berhasil, PoP mengizinkan permintaan tersebut. Jika otentikasi gagal, PoP menolak atau membatasi permintaan tersebut. Berikut beberapa contohnya:

   • Contoh 1: Otentikasi berhasil. POP CDN menyajikan konten yang di-cache kepada pengguna.

   • Contoh 2: Otentikasi gagal. POP CDN mengembalikan kode status 403 kepada pengguna.

   • Contoh 3: Otentikasi gagal. POP CDN melakukan throttle terhadap akses pengguna.

   • Contoh 4: Otentikasi timeout. POP CDN mengizinkan permintaan pengguna, yang merupakan aksi default.

Catatan penggunaan

Setelah Anda mengaktifkan otentikasi jarak jauh, setiap permintaan pengguna harus diautentikasi. Jika Anda mengantisipasi volume traffic yang tinggi, pastikan server otentikasi Anda mampu menangani beban tersebut.

Prosedur

1. Masuk ke Konsol ApsaraVideo VOD.

2. Pada panel navigasi kiri, pilih Configuration Management.

3. Pilih CDN Configuration > Domain Names.

4. Temukan nama domain yang ingin Anda konfigurasi dan klik Configure pada kolom Actions.

5. Klik Resource Access Control.

6. Klik tab Remote Authentication.

7. Nyalakan sakelar Remote Authentication dan konfigurasikan pengaturannya.

   Tabel berikut menjelaskan parameter-parameter tersebut.

   Parameter	Deskripsi
   Auth server address	Alamat publik server otentikasi Anda. Alamat tersebut harus memenuhi persyaratan format dan nilai berikut. Persyaratan format Alamat harus dalam salah satu format berikut: http://example.com/auth https://example.com/auth http://192.0.2.1/auth https://192.0.2.1/auth Persyaratan nilai Nilainya tidak boleh 127.0.0.1 atau localhost. Alamat lokal ini tidak valid.
   Request method	Metode permintaan yang didukung oleh server otentikasi Anda. Nilai yang valid: GET, HEAD, dan POST. POST Parameter dikirimkan dalam badan permintaan, dan URL bilah alamat tidak berubah. Tidak ada batasan praktis pada jumlah data yang dikirimkan. Permintaan tidak di-cache atau disimpan dalam riwayat browser. Keamanan relatif tinggi. GET Parameter dikirimkan dalam baris permintaan, dan nilainya terlihat di bilah alamat. Batasan browser membatasi jumlah data yang dapat dikirimkan hingga 1.024 byte. Permintaan dapat di-cache dan disimpan dalam riwayat browser. Keamanan relatif rendah. HEAD Metode HEAD identik dengan metode GET, kecuali bahwa server tidak mengembalikan badan pesan dalam respons.
   File types	All file types: Mengotentikasi permintaan untuk semua jenis file. Specified file types: Mengotentikasi permintaan hanya untuk jenis file yang ditentukan. Untuk menentukan beberapa jenis file, pisahkan dengan tanda pipa vertikal (|), misalnya mp4|flv. Jenis file bersifat case-sensitive. Misalnya, jpg dan JPG dianggap sebagai jenis file yang berbeda.
   Retain parameters	Mengontrol parameter mana dari URL permintaan pengguna yang digunakan untuk otentikasi. Anda dapat memilih Retain all parameters, Retain specified parameters, atau Delete all URL parameters. Jika Anda memilih untuk menyimpan parameter tertentu, pisahkan beberapa parameter dengan tanda pipa vertikal (|), misalnya user|token. Parameter bersifat case-sensitive. Misalnya, key dan KEY dianggap sebagai parameter yang berbeda.
   Add custom parameters	Menambahkan parameter kustom ke URL permintaan yang diteruskan POP CDN ke server otentikasi. Anda dapat memilih Custom untuk mengatur parameter dan nilai kustom, atau memilih Select Parameter untuk menggunakan variabel preset dari Konsol. Saat Anda mengatur parameter dan nilai kustom: Pisahkan beberapa parameter dengan tanda pipa vertikal (|), misalnya token=$arg_token|vendor=ali_cdn. Parameter bersifat case-sensitive. Misalnya, key dan KEY dianggap sebagai parameter yang berbeda. Saat Anda menggunakan variabel preset, Anda dapat mengekstrak nilainya dan menambahkannya ke permintaan yang diteruskan oleh POP CDN. Misalnya, jika Anda memilih variabel $http_host, maka host=$http_host ditambahkan ke URL permintaan, di mana $http_host adalah nilai header Host dalam permintaan pengguna. Untuk daftar variabel dan deskripsinya, lihat Variable names.
   Retain request headers	Mengontrol header mana dari permintaan pengguna yang digunakan untuk otentikasi. Anda dapat memilih Retain all headers, Retain specified headers, atau Delete all request headers. Jika Anda memilih untuk menyimpan header tertentu, pisahkan beberapa header dengan tanda pipa vertikal (|), misalnya user_agent|referer|cookies. Header permintaan tidak case-sensitive. Misalnya, http_remote_addr dan HTTP_Remote_Addr dianggap sebagai header yang sama. Catatan Secara default, POP CDN menghapus header Host. Hal ini karena header Host pada permintaan yang diteruskan berisi nama domain yang dipercepat, yang mungkin tidak dikenali oleh server otentikasi Anda, sehingga berpotensi menyebabkan error 404 atau kegagalan otentikasi. Untuk menyimpan header Host, gunakan Retain specified headers atau Add Custom Parameters.
   Add custom headers	Menambahkan header kustom ke permintaan yang diteruskan POP CDN ke server otentikasi. Anda dapat memilih Custom untuk mengatur header dan nilai kustom, atau memilih Select Parameter untuk menggunakan variabel preset dari Konsol. Saat Anda mengatur parameter dan nilai kustom: Pisahkan beberapa header dengan tanda pipa vertikal (|), misalnya User-Agent=$http_user_agent|vendor=ali_cdn. Header permintaan tidak case-sensitive. Misalnya, http_remote_addr dan HTTP_Remote_Addr dianggap sebagai header yang sama. Saat Anda menggunakan variabel preset, Anda dapat mengekstrak nilainya dan menambahkannya ke permintaan yang diteruskan oleh POP CDN. Misalnya, jika Anda memilih variabel $http_host, maka host=$http_host ditambahkan ke header permintaan, di mana $http_host adalah nilai header Host dalam permintaan pengguna. Untuk daftar variabel dan deskripsinya, lihat Variable names.
   Success status code	Kode status HTTP dari server otentikasi Anda yang menunjukkan keberhasilan. Kami menyarankan Anda menggunakan kode status 2xx. Misalnya, jika Anda mengatur parameter ini ke 200, respons 200 dari server otentikasi Anda berarti berhasil. Jika server mengembalikan kode status yang tidak cocok dengan kode keberhasilan maupun kegagalan, permintaan tersebut dianggap timeout.
   Failure status code	Kode status HTTP dari server otentikasi Anda yang menunjukkan kegagalan. Kami menyarankan Anda menggunakan kode status 4xx. Misalnya, jika Anda mengatur parameter ini ke 403, respons 403 dari server otentikasi Anda berarti gagal. Jika server mengembalikan kode status yang tidak cocok dengan kode keberhasilan maupun kegagalan, permintaan tersebut dianggap timeout.
   Custom response status code	Kode status yang dikembalikan POP CDN kepada pengguna jika permintaan gagal dalam otentikasi. Misalnya, jika Anda mengatur nilai ini ke 403, POP CDN akan mengembalikan kode status 403 kepada pengguna ketika permintaan mereka gagal dalam otentikasi.
   Timeout	Waktu maksimum yang akan ditunggu POP CDN untuk menerima respons dari server otentikasi. Unit: milidetik. Nilai maksimum adalah 3000.
   Action on timeout	Aksi yang diambil POP CDN jika permintaan otentikasi ke server Anda mengalami timeout. Nilai yang valid: allow: Jika terjadi timeout, POP CDN mengizinkan permintaan pengguna. reject: Jika terjadi timeout, POP CDN mengembalikan Custom Response Status Code yang ditentukan kepada pengguna.

8. Klik OK untuk menyimpan konfigurasi.

   Setelah mengonfigurasi otentikasi jarak jauh, Anda dapat kembali ke tab Remote Authentication untuk mengubah pengaturan atau menonaktifkan fitur tersebut.

Variable names

Saat Anda menambahkan parameter kustom, Anda dapat menggunakan variabel preset berikut.

API terkait

BatchSetVodDomainConfigs