Daftar hitam atau daftar putih User-Agent mengontrol akses ke resource di bawah nama domain yang dipercepat berdasarkan bidang User-Agent dalam header permintaan HTTP. Konfigurasikan daftar hitam untuk menolak klien tertentu, atau daftar putih untuk hanya mengizinkan klien tertentu.
Jenis daftar hitam dan daftar putih
Daftar User-Agent mencakup tipe-tipe berikut:
Daftar Hitam — Jika bidang User-Agent dalam header permintaan HTTP sesuai dengan entri dalam daftar hitam, pengguna tidak dapat mengakses resource yang diminta, dan kode status 403 dikembalikan.
Daftar Putih — Pengguna hanya dapat mengakses resource di bawah nama domain yang dipercepat jika bidang User-Agent dalam header permintaan HTTP sesuai dengan entri dalam daftar putih.
Pilih jenis daftar berdasarkan hasil kontrol akses yang diinginkan:
Untuk memblokir klien tertentu, seperti browser IE, dan mengizinkan semua klien lainnya, pilih Daftar Hitam.
Untuk hanya mengizinkan klien tertentu dan memblokir semua klien lainnya, pilih Daftar Putih.
Catatan penggunaan
Sebelum mengonfigurasi daftar hitam atau daftar putih User-Agent, perhatikan hal-hal berikut:
Fitur daftar hitam dan daftar putih User-Agent tidak mendukung kontrol akses untuk permintaan yang tidak membawa header User-Agent. Untuk mengontrol permintaan tersebut, gunakan fitur EdgeScript sebagai gantinya. Untuk informasi selengkapnya, lihat EdgeScript. Atau, submit a ticket untuk mengajukan konfigurasi backend.
Untuk melakukan kontrol akses pada permintaan yang membawa header User-Agent dengan nilai kosong, gunakan
^$untuk merepresentasikan nilai User-Agent kosong. Pola^$hanya cocok dengan nilai User-Agent kosong, bukan permintaan yang tidak membawa header User-Agent.Dalam daftar putih: Jika aturan berisi
^$, permintaan yang membawa header User-Agent dengan nilai kosong diizinkan.Dalam daftar hitam: Jika aturan berisi
^$, permintaan yang membawa header User-Agent dengan nilai kosong ditolak.
Saat fitur ini mereferensikan kondisi aturan dari Rules Engine, urutan eksekusi mengikuti urutan prioritas kondisi aturan yang dikonfigurasi di Rules Engine, bukan urutan prioritas konfigurasi fitur ini sendiri.
Prosedur
Masuk ke DCDN console.
Masuk ke DCDN console.
Masuk ke DCDN console.
Di panel navigasi sebelah kiri, klik Domain Names.
Di panel navigasi sebelah kiri, klik Domain Names.
Pada halaman Domain Names, temukan nama domain yang dituju, lalu klik Configure.
Pada pohon navigasi di sisi kiri nama domain, klik Access Control.
Klik tab User-Agent Blacklist/Whitelist.
Aktifkan sakelar User-Agent Blacklist/Whitelist, lalu ikuti petunjuk di layar untuk mengonfigurasi Blacklist atau Whitelist User-Agent.
Parameter
Description
Type
Jenis daftar User-Agent. Nilai yang valid: Blacklist dan Whitelist. Untuk perilaku masing-masing jenis, lihat Jenis daftar hitam dan daftar putih.
Rules
Saat mengonfigurasi bidang User-Agent, pisahkan beberapa nilai dengan tanda pipa vertikal (|). Wildcard (*) didukung. Contoh:
*curl*|*IE*|*chrome*|*firefox*.CatatanUntuk informasi selengkapnya tentang cara mencocokkan nilai User-Agent kosong dan permintaan yang tidak membawa header User-Agent, lihat Catatan penggunaan.
Klik OK.
Contoh
Contoh 1: Daftar Hitam
Aturan:
*IE*|^$
Hasil: Permintaan dari browser IE atau permintaan yang membawa header User-Agent dengan nilai kosong tidak dapat mengakses resource yang diminta. Permintaan yang tidak membawa header User-Agent tidak terpengaruh oleh aturan ini.
Contoh 2: Daftar Putih
Aturan:
*IE*|*firefox*
Hasil: Hanya permintaan dari browser IE atau Firefox yang dapat mengakses resource yang diminta. Semua permintaan lainnya ditolak.