Saat mengonfigurasi aturan daftar putih, kustom, atau manajemen bot, Anda perlu menentukan kondisi pencocokan untuk mengidentifikasi fitur-fitur permintaan yang ingin dicocokkan. Topik ini menjelaskan bidang-bidang yang didukung untuk kondisi pencocokan beserta deskripsinya.
Apa itu kondisi pencocokan
Kondisi pencocokan adalah fitur-fitur permintaan yang diperiksa oleh Web Application Firewall (WAF). Saat Anda mengonfigurasi aturan daftar putih, aturan kustom, atau manajemen bot, Anda menentukan Match Conditions untuk menentukan fitur-fitur permintaan yang akan diperiksa oleh WAF. Jika suatu permintaan memenuhi kondisi pencocokan suatu aturan, maka permintaan tersebut mengenai aturan tersebut. WAF kemudian memproses permintaan tersebut berdasarkan aksi yang ditentukan dalam aturan, seperti Allow, Block, atau Challenge.
Satu Match Condition terdiri dari satu Match Field, satu Logical Operator, dan Match Content. Berikut ini adalah contoh konfigurasinya:
Contoh 1: Jika Match Field diatur ke URI, Logical Operator diatur ke Contains, dan Match Content diatur ke
/login.php, maka suatu permintaan mengenai aturan tersebut jika path yang diminta berisi/login.php.Contoh 2: Jika Match Field diatur ke IP, Logical Operator diatur ke Is, dan Match Content diatur ke
192.XX.XX.1, maka permintaan dari klien dengan alamat IP192.XX.XX.1mengenai aturan tersebut.
Konten permintaan yang menggunakan metode pengkodean umum, seperti pengkodean URL, pengkodean HTML, atau pengkodean Unicode, akan didekodekan sebelum dicocokkan dengan konten pencocokan yang ditentukan.
Bidang pencocokan yang didukung
Tabel berikut menjelaskan bidang-bidang pencocokan yang didukung untuk kondisi pencocokan.
Aturan pencocokan untuk instans WAF bayar sesuai penggunaan dikategorikan sebagai aturan lanjutan atau dasar, masing-masing dengan standar penagihan yang berbeda. Untuk informasi selengkapnya, lihat Penagihan.
Instans WAF berlangganan edisi Enterprise atau lebih tinggi mendukung aturan lanjutan, seperti pencocokan ekspresi reguler. Tidak ada biaya tambahan untuk aturan lanjutan pada instans WAF tersebut. Untuk informasi selengkapnya tentang aturan yang didukung oleh berbagai edisi langganan WAF, lihat Panduan Versi.
Konten pencocokan untuk bidang pencocokan berikut tidak membedakan huruf besar dan kecil.
Bidang pencocokan | Deskripsi | Operator logika yang didukung |
URI | Uniform Resource Identifier (URI) dari suatu permintaan. URI menentukan path dari sumber daya yang diminta. Dalam kebanyakan kasus, URI merupakan kombinasi dari URI Path dan Query String. Path harus dimulai dengan |
|
IP | Alamat IP sumber dari suatu permintaan. Ini adalah alamat IP klien yang menginisiasi permintaan. Konten pencocokan harus memenuhi persyaratan berikut:
|
Catatan Satu aturan perlindungan dapat berisi maksimal 100 alamat IP atau blok CIDR alamat IP. Misalnya, jika suatu aturan perlindungan berisi dua kondisi pencocokan dengan bidang pencocokan IP, jumlah total alamat IP atau blok CIDR alamat IP dalam kedua kondisi pencocokan tersebut tidak boleh melebihi 100. Pisahkan beberapa alamat IP atau blok CIDR alamat IP dengan koma (,). |
Referer | URL sumber dari suatu permintaan. Ini menunjukkan halaman tempat permintaan dialihkan. |
|
User-Agent | Informasi mengenai browser klien yang menginisiasi permintaan, seperti pengenal browser, mesin rendering, dan versi. |
|
Query String | String kueri dalam suatu permintaan. Ini mengacu pada bagian yang mengikuti tanda tanya (?) dalam URL. |
|
Cookie | Informasi cookie dalam suatu permintaan. |
|
Content-Type | Tipe konten dari permintaan HTTP, yang ditentukan dalam header permintaan. Ini mengacu pada tipe Multipurpose Internet Mail Extensions (MIME). |
|
Content-Length | Jumlah byte dalam badan permintaan. Nilai yang valid: 0 hingga 2.147.483.648. |
|
X-Forwarded-For | Alamat IP asal klien yang mengirim permintaan. X-Forwarded-For (XFF) adalah bidang header permintaan HTTP yang digunakan untuk mengidentifikasi alamat IP asal klien yang terhubung ke server web melalui proxy HTTP atau instans Server Load Balancer. Hanya permintaan yang diteruskan oleh proxy HTTP atau instans Server Load Balancer yang berisi bidang ini. |
|
Body | Konten dari badan permintaan. Penting Aturan kustom yang menggunakan bidang pencocokan ini merupakan aturan lanjutan. Standar penagihan untuk aturan lanjutan dan aturan dasar berbeda. Untuk informasi selengkapnya, lihat Penagihan. |
|
Http-Method | Metode permintaan, seperti GET, POST, DELETE, PUT, OPTIONS, CONNECT, HEAD, TRACE, atau PATCH. |
|
Header | Header dalam suatu permintaan. Anda dapat menentukan bidang header kustom. |
|
URI Path | Path URI dari suatu permintaan. |
|
Query String Parameter | Nama parameter dalam string kueri. String kueri adalah bagian dari URL yang mengikuti tanda tanya (?). Misalnya, dalam Catatan Nilai yang Anda masukkan untuk parameter string kueri kustom bersifat case-sensitive. |
|
Server-Port | Port server. |
|
File Extension | Ekstensi file dalam path permintaan, seperti .png atau .php. |
|
Filename | Nama file di akhir path permintaan. Misalnya, dalam |
|
Host | Nama domain yang diminta. |
|
Cookie Name | Nama kunci cookie. Misalnya, dalam cookie Catatan Nilai yang Anda masukkan untuk nama cookie kustom bersifat case-sensitive. |
|
Body Parameter | Nama parameter dalam badan permintaan. Misalnya, jika badan permintaan berisi string Catatan Nilai yang Anda masukkan untuk parameter badan kustom bersifat case-sensitive. Penting Aturan kustom yang menggunakan bidang pencocokan ini merupakan aturan lanjutan. Standar penagihan untuk aturan lanjutan dan aturan dasar berbeda. Untuk informasi selengkapnya, lihat Penagihan. |
|