全部产品
Search

搜索本产品

    ApsaraVideo VOD：Konfigurasikan daftar hitam atau daftar putih User-Agent

    文档中心

    ApsaraVideo VOD：Konfigurasikan daftar hitam atau daftar putih User-Agent

    更新时间：Jan 27, 2026

    User-Agent adalah Header HTTP yang berisi informasi mengenai klien yang melakukan permintaan, termasuk sistem operasi, versi sistem operasi, browser, dan versi browser. Anda dapat mengonfigurasi daftar hitam atau daftar putih User-Agent untuk mengidentifikasi dan memfilter pengguna, sehingga membantu mengontrol akses ke resource serta meningkatkan keamanannya di ApsaraVideo VOD. Topik ini menjelaskan cara mengonfigurasi daftar hitam atau daftar putih User-Agent.

    Catatan penggunaan

    • Daftar putih: Hanya permintaan HTTP dengan header User-Agent yang tercantum dalam daftar putih yang dapat mengakses resource.

    • Daftar hitam: Permintaan HTTP dengan header User-Agent yang tercantum dalam daftar hitam tidak dapat mengakses resource yang ditentukan.
      Jika header User-Agent suatu permintaan ada dalam daftar hitam, permintaan tersebut tetap dapat mencapai Titik Kehadiran (POP) CDN. Namun, POP akan menolak permintaan tersebut dan mengembalikan kode status 403. Permintaan ini tetap dicatat dalam log CDN.

    • Daftar hitam dan daftar putih bersifat saling eksklusif dan tidak dapat dikonfigurasi secara bersamaan.

    Prosedur

    1. Masuk ke Konsol ApsaraVideo VOD.

    2. Pada panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.

    3. Temukan nama domain yang ingin Anda konfigurasi, lalu klik Configure.

    4. Pada panel navigasi sebelah kiri, klik Resource Access Control.

    5. Klik tab UA Blacklist/Whitelist.

    6. Pada tab UA Blacklist/Whitelist, klik Modify.

    7. Konfigurasikan Blacklist atau Whitelist untuk User-Agent sesuai petunjuk.

      UA黑/白名单

      Parameter

      Deskripsi

      Type

      Berikut adalah jenis daftar User-Agent:

      • Blacklist

        Jika bidang User-Agent dalam Header permintaan HTTP cocok dengan nilai dalam daftar hitam, permintaan tersebut ditolak dan kode status HTTP 403 dikembalikan.

      • Whitelist

        Hanya permintaan yang bidang User-Agent-nya dalam Header permintaan HTTP cocok dengan nilai dalam daftar putih yang diizinkan mengakses resource pada nama domain yang dipercepat.

      Rules

      Saat menentukan nilai User-Agent, pisahkan beberapa nilai dengan tanda pipa vertikal (|). Anda dapat menggunakan karakter wildcard asterisk (*). Contoh: *curl*|*IE*|*chrome*|*firefox*.

      Catatan

      • Untuk mengontrol akses permintaan yang berisi header User-Agent kosong, gunakan parameter this-is-empty-ua untuk merepresentasikan nilai User-Agent kosong.

        • Daftar putih: Jika aturan berisi this-is-empty-ua, permintaan yang berisi header User-Agent kosong diizinkan.

        • Daftar hitam: Jika aturan berisi this-is-empty-ua, permintaan yang berisi header User-Agent kosong ditolak.

      • Daftar hitam dan daftar putih User-Agent tidak mendukung kontrol akses pada permintaan yang tidak berisi header User-Agent. Anda dapat menggunakan EdgeScript untuk mengaktifkan fitur ini. Untuk informasi selengkapnya, lihat EdgeScript overview.

    8. Klik OK untuk menyimpan konfigurasi.

    Contoh konfigurasi

    • Contoh 1: Daftar putih

      Aturan: *IE*|*firefox*

      Hanya permintaan dari Internet Explorer atau Firefox yang dapat mengakses resource. Semua permintaan lainnya ditolak.

    • Contoh 2: Daftar hitam

      Aturan: *IE*|this-is-empty-ua

      Hasil yang diharapkan: Permintaan yang dikirim dari IE atau berisi header User-Agent kosong ditolak.