All Products
Search

This Product

    ApsaraVideo VOD:Konfigurasi daftar hitam atau daftar putih User-Agent

    Document Center

    ApsaraVideo VOD:Konfigurasi daftar hitam atau daftar putih User-Agent

    Last Updated:Jul 11, 2026

    Header HTTP User-Agent mengidentifikasi klien yang membuat permintaan, termasuk sistem operasi, versi OS, browser, dan versi browser. Anda dapat mengonfigurasi daftar hitam atau daftar putih User-Agent untuk memfilter permintaan berdasarkan identitas klien dan mengontrol akses ke resource ApsaraVideo VOD.

    Catatan penggunaan

    • Daftar putih: Hanya permintaan dengan header User-Agent yang cocok dengan aturan dalam daftar putih yang dapat mengakses resource Anda.

    • Daftar hitam: Permintaan dengan header User-Agent yang cocok dengan aturan dalam daftar hitam akan diblokir.
      Permintaan yang diblokir tetap dapat mencapai POP, tetapi POP tersebut menolaknya dan mengembalikan kode status HTTP 403. Permintaan yang ditolak 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 kiri, pilih Configuration Management > CDN Configuration > Domain Names.

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

    4. Pada panel navigasi kiri untuk nama domain yang dipilih, klik Resource Access Control.

    5. Klik tab User-Agent Blacklist/Whitelist.

    6. Pada tab User-Agent Blacklist/Whitelist, klik Modify.

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

      Item

      Deskripsi

      Type

      Jenis daftar.

      • Blacklist

        Jika header User-Agent permintaan cocok dengan nilai dalam daftar hitam, akses ditolak dan kode status 403 dikembalikan.

      • Whitelist

        Hanya permintaan yang header User-Agent-nya cocok dengan nilai dalam daftar putih yang dapat mengakses resource domain.

      Rules

      Tentukan nilai User-Agent. Pisahkan beberapa nilai dengan tanda pipa vertikal (|). Anda dapat menggunakan tanda bintang (*) sebagai wildcard. Contoh: *curl*|*IE*|*chrome*|*firefox*.

      Catatan

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

        • Pada daftar putih: Jika suatu aturan mencakup this-is-empty-ua, permintaan dengan header User-Agent kosong diizinkan.

        • Pada daftar hitam: Jika suatu aturan mencakup this-is-empty-ua, permintaan dengan header User-Agent kosong ditolak.

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

    8. Klik OK untuk menyelesaikan konfigurasi.

    Contoh konfigurasi

    • Contoh 1: Konfigurasi daftar putih

      Aturan: *IE*|*firefox*

      Hasil yang diharapkan: Hanya permintaan yang dikirim dari IE atau Firefox yang diizinkan mengakses resource di POP.

    • Contoh 2: Konfigurasi daftar hitam

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

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