全部产品
Search

搜索本产品

    CDN：Konfigurasikan daftar hitam atau daftar putih User-Agent

    文档中心

    CDN：Konfigurasikan daftar hitam atau daftar putih User-Agent

    更新时间：Jan 07, 2026

    User-Agent merupakan bagian dari Header permintaan HTTP yang mengidentifikasi sistem operasi, jenis browser, serta versi klien. Gunakan aturan daftar hitam/daftar putih User-Agent untuk mengontrol akses ke sumber daya Anda dan meningkatkan keamanan.

    Catatan

    • Anda dapat mengonfigurasi daftar hitam atau daftar putih User-Agent, tetapi tidak keduanya secara bersamaan.

    • Jika header User-Agent pada suatu permintaan cocok dengan nilai dalam daftar hitam, Titik kehadiran (POP) CDN akan menolak permintaan tersebut, mengembalikan kode status 403, dan mencatat permintaan tersebut ke dalam log.

    • Pemblokiran permintaan tetap mengonsumsi sumber daya POP CDN. Oleh karena itu, Anda mungkin dikenai biaya dalam jumlah kecil untuk traffic dan, jika berlaku, untuk Permintaan HTTPS.

    Prosedur

    1. Masuk ke CDN console.

    2. Di panel navigasi kiri, klik Domain Names.

    3. Pada halaman Domain Names, temukan nama domain yang dituju lalu klik Manage di kolom Actions.

    4. Di panel navigasi domain, klik Access Control.

    5. Klik tab User-Agent Blacklist/Whitelist.

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

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

      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 sumber daya pada nama domain yang dipercepat.

      Rules

      Saat mengonfigurasi bidang User-Agent, gunakan tanda pipa vertikal (|) untuk memisahkan beberapa nilai. Karakter wildcard (*) didukung. Contoh: *curl*|*IE*|*chrome*|*firefox*.

      Catatan

      • Untuk mengontrol akses terhadap 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.

      • Fitur daftar hitam dan daftar putih User-Agent tidak mendukung kontrol akses untuk permintaan yang tidak menyertakan header User-Agent. Anda dapat menggunakan fitur EdgeScript untuk menerapkannya. Untuk informasi selengkapnya, lihat EdgeScript. Atau, atau kirim tiket untuk meminta konfigurasi backend.

      Rule Condition

      Kondisi aturan mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku bagi permintaan tersebut.

      • Do not use: Jangan gunakan kondisi aturan.

      • Untuk menambahkan atau mengedit kondisi aturan, kelola melalui Rules Engine.

    8. Klik OK.

    Contoh konfigurasi

    • Contoh 1: Gunakan daftar putih untuk mengizinkan permintaan dari IE atau Firefox

      Aturan: *IE*|*firefox*

      Hasil: Hanya permintaan dari Internet Explorer atau Firefox yang diizinkan mengakses sumber daya yang diminta. Semua permintaan lainnya ditolak.

    • Contoh 2: Gunakan daftar hitam untuk memblokir permintaan dengan header User-Agent kosong

      Aturan: this-is-empty-ua

      Hasil: Permintaan dengan header User-Agent kosong ditolak.