All Products
Search
Document Center

Web Application Firewall:Konfigurasikan aturan kustom lanjutan untuk manajemen bot

Last Updated:Jun 23, 2026

Modul aturan kustom lanjutan dalam Bot Management menyediakan bidang pencocokan yang lebih kaya—seperti Client ID, sidik jari JA3/JA4, serta data yang dikumpulkan oleh Web SDK dan App SDK—dan dimensi statistik seperti UMID dan Session, dibandingkan dengan aturan kustom di Core Web Protection. Modul ini mendukung penghitungan deduplikasi dan aksi Header Kustom origin, sehingga memenuhi kebutuhan manajemen lalu lintas bot detail halus dan pertahanan terhadap skenario kompleks.

Prosedur

Catatan

Sebelum memulai, pastikan prasyarat berikut terpenuhi:

  1. Objek yang dilindungi tersedia: Bisnis web Anda harus terhubung ke WAF. Jika belum, lihat Hubungkan bisnis Anda ke WAF.

  2. Bot Management diaktifkan: Pengguna langganan harus mengaktifkan Bot Management (Edisi Dasar Langganan tidak mendukung fitur ini). Untuk informasi selengkapnya, lihat Aktifkan Bot Management.

Masuk ke Konsol Web Application Firewall 3.0. Di bilah navigasi atas, pilih kelompok sumber daya dan wilayah instans WAF Anda (Chinese Mainland atau Outside Chinese Mainland). Di panel navigasi kiri, pilih Protection Config > Bot Management > Advanced Custom Rules.

Langkah 1: Konfigurasikan nama templat dan objek yang dilindungi

Klik Create Template. Di panel New Template - Advanced Custom Rules, konfigurasikan parameter berikut.

Langkah 2: Tambahkan aturan perlindungan ke templat

Di bagian Rule Configuration, klik Create Rule dan konfigurasikan parameter berikut.

  • Rule Name: Tetapkan nama yang mudah dikenali untuk aturan perlindungan.

  • Match Condition: Tetapkan karakteristik permintaan yang akan dicocokkan. Klik Add Condition untuk menambahkan kondisi. Setiap kondisi terdiri dari Match Field, Logical Operator, dan Match Content. Tabel berikut menunjukkan contoh konfigurasi:

    Catatan

    Jika suatu aturan berisi beberapa kondisi, permintaan harus memenuhi semua kondisi tersebut (logika AND) agar sesuai dengan aturan. Untuk penjelasan lengkap tentang bidang pencocokan dan operator logika, lihat Bidang pencocokan dan operator logika.

    Match Field

    Logical Operator

    Match Content

    Description

    URI Path

    Contains

    /login.php

    Permintaan sesuai dengan aturan ini ketika path-nya mengandung /login.php.

    IP

    Belongs to

    192.1.XX.XX

    Permintaan sesuai dengan aturan ini ketika IP klien adalah 192.1.XX.XX.

  • Protection Rule Type: Mendukung Access Control dan Rate Limiting.

    • Access Control: Cocok untuk skenario yang memerlukan kontrol presisi terhadap jenis permintaan tertentu.

    • Rate Limiting: Cocok untuk skenario berdasarkan frekuensi akses (seperti anti-brute-force dan anti-scraping).

      Access Control

      Konfigurasikan aturan access control untuk melakukan aksi tertentu terhadap permintaan individual yang memenuhi kondisi.

      Frequency Control

      Konfigurasikan aturan frequency control untuk membatasi akses berlebihan dari klien.

      • Frequency Detection Condition: Ketika satu Statistical Object melebihi Threshold (Times) yang dikonfigurasi dalam Statistical Interval (Seconds) yang ditentukan, aksi blacklist dipicu.

        Configuration Item

        Description

        Statistical Object

        Pilih objek yang frekuensi permintaannya dilacak. Opsi yang tersedia:

        • IP: Lacak frekuensi permintaan dari alamat IP yang sama.

        • Custom Header: Kelompokkan permintaan berdasarkan nilai header permintaan kustom (seperti Referer), dan lacak frekuensi permintaan dengan nilai header yang sama dalam periode waktu tertentu.

        • Custom Parameter: Lacak frekuensi permintaan yang mengandung parameter URL tertentu. Misalnya, jika parameternya adalah user_id, WAF melacak frekuensi permintaan dengan nilai user_id yang sama.

        • Session: WAF membuat identifier sesi dengan menyetel cookie bernama acw_tc dalam respons, dan melacak frekuensi permintaan klien berdasarkan nilai cookie ini.

        • Account: Lacak frekuensi permintaan dari akun yang sama. Anda harus mengonfigurasi User Identification di halaman Protected Objects sebelum mengonfigurasi opsi ini. Untuk informasi selengkapnya, lihat Konfigurasi ekstraksi akun.

        • Body: Lacak frekuensi permintaan yang mengandung parameter body tertentu.

        • App UMID: Lacak frekuensi permintaan dari klien aplikasi yang sama.

        • Web UMID: Lacak frekuensi permintaan dari klien web yang sama.

        Statistical Interval (Seconds)

        Jendela waktu untuk penghitungan frekuensi. Satuan: detik.

        Threshold (Times)

        Tetapkan jumlah maksimum kali Statistical Object dapat memenuhi Match Condition dalam Statistical Interval (Seconds). Melebihi ambang batas ini akan menambahkan objek ke blacklist.

      • Response Code Detection Condition: Saat diaktifkan, hanya respons yang sesuai dengan karakteristik berikut yang dihitung dalam frekuensi. Kondisi ini harus dipenuhi bersamaan dengan kondisi deteksi frekuensi.

        Configuration Item

        Description

        Status Code

        Tetapkan kode respons yang akan dilacak.

        Quantity

        Tetapkan jumlah maksimum kemunculan Status Code tertentu dalam durasi statistik.

        Percentage (%)

        Tetapkan persentase maksimum Status Code tertentu dalam durasi statistik.

      • Deduplication Statistics: Saat diaktifkan, sistem melakukan deduplikasi konten permintaan dan hanya menghitung karakteristik permintaan yang tidak berulang. Jika hasil deduplikasi memenuhi aturan, aksi blacklist dipicu. Klik Add Condition untuk menambahkan kondisi. Setiap kondisi terdiri dari Match Field, Logical Operator, dan Quantity. Tabel berikut menunjukkan contoh konfigurasi:

        Catatan

        Jika suatu aturan berisi beberapa kondisi, permintaan harus memenuhi semua kondisi tersebut (logika AND) agar sesuai dengan aturan.

        Ketika Match Field diatur ke URI, Logical Operator diatur ke Equals, dan Quantity diatur ke 5, sistem melakukan deduplikasi URI permintaan. Aturan dianggap sesuai ketika frekuensi akses URI non-duplikat mencapai 5.

      • Blacklist Action Condition: Tambahkan objek statistik yang memenuhi kondisi deteksi di atas ke blacklist. Dalam Timeout Period, lakukan aksi yang ditentukan di Actions terhadap permintaan dalam cakupan Apply To objek tersebut.

        Configuration Item

        Description

        Apply To

        Tetapkan cakupan tempat aksi blacklist berlaku. Nilai yang tersedia:

        • Current Match Condition: Hanya menangani permintaan yang memenuhi Match Condition aturan saat ini.

        • Protected Object: Melakukan aksi terhadap semua permintaan dari objek statistik (seperti IP) yang mengakses objek yang dilindungi saat ini.

        Timeout Period

        Tetapkan durasi aksi blacklist. Satuan: detik. Nilai valid: 60 hingga 86400.

  • Actions: Pilih aksi yang akan dilakukan ketika permintaan memenuhi aturan ini.

    Configuration item

    Description

    JavaScript Validation

    WAF mengembalikan blok kode validasi JavaScript ke klien. Browser standar secara otomatis mengeksekusi kode ini. Jika klien berhasil menyelesaikan eksekusi, WAF mengizinkan semua permintaan dari klien tersebut untuk periode waktu tertentu, 30 menit secara default. Jika tidak, permintaan diblokir.

    Block

    Memblokir permintaan yang sesuai aturan dan mengembalikan halaman blokir ke klien.

    Catatan

    WAF menggunakan halaman blokir default. Anda juga dapat membuat halaman blokir kustom menggunakan fitur Custom Response.

    Log

    Aksi ini tidak memblokir permintaan yang sesuai aturan, tetapi hanya mencatat permintaan tersebut. Saat menguji aturan, Anda dapat menggunakan mode Log terlebih dahulu untuk menganalisis log WAF dan memastikan tidak terjadi false positive. Setelah itu, Anda dapat mengubah aturan ke aksi lain.

    CAPTCHA

    WAF mengembalikan halaman verifikasi slider ke klien. Jika klien berhasil menyelesaikan tantangan slider, WAF mengizinkan semua permintaan dari klien tersebut untuk periode waktu tertentu, 30 menit secara default. Jika tidak, permintaan diblokir.

    Strict CAPTCHA

    WAF mengembalikan halaman verifikasi slider ke klien. Jika klien berhasil menyelesaikan tantangan slider, permintaan saat ini diizinkan. Jika tidak, permintaan diblokir. Dalam mode ini, klien harus menyelesaikan tantangan slider untuk setiap permintaan yang sesuai aturan.

    Origin Custom Header

    Anda dapat menentukan nama dan konten header kustom, termasuk tipe aturan, ID aturan, dan web UMID. WAF tidak memproses permintaan secara langsung, melainkan menambahkan header untuk meneruskan informasi hit ke server origin. Anda dapat mengintegrasikannya dengan sistem risk control backend Anda untuk pemrosesan sisi bisnis.

    Catatan
    • Validasi JavaScript Validation atau CAPTCHA hanya berlaku untuk permintaan sinkron. Untuk permintaan asinkron seperti XMLHttpRequest atau Fetch, Anda harus menginjeksikan Web SDK; jika tidak, validasi tidak akan berfungsi dengan benar.

  • Rule Type: Tentukan tipe lalu lintas bot. Tipe yang tersedia adalah Suspected Bot dan Malicious Bot. Lalu lintas yang memenuhi aturan diklasifikasikan ke kategori yang sesuai dan ditampilkan dalam grafik tren di halaman Traffic Analytics.

  • Advanced Settings: Konfigurasikan proporsi rilis canary dan strategi waktu efektif untuk aturan.

    Configuration Item

    Description

    Canary Rule

    Konfigurasikan proporsi efektif aturan untuk objek dalam dimensi berbeda.

    Setelah mengaktifkan rilis canary, Anda harus menyetel Dimension dan Canary Release Proportion. Opsi Dimension yang tersedia meliputi: IP, Custom Header, Custom Parameter, Custom Cookie, Session, App UMID, dan Web UMID.

    Catatan

    Rilis canary berlaku berdasarkan Dimension yang dikonfigurasi, bukan dengan menerapkan aturan secara acak ke permintaan sesuai proporsi yang ditentukan. Misalnya, ketika Dimension diatur ke IP dan Canary Release Proportion diatur ke 10%, WAF memilih sekitar 10% alamat IP. Semua permintaan dari alamat IP yang dipilih tunduk pada aturan tersebut, bukan menerapkan aturan ke 10% dari semua permintaan secara acak.

    Effective Mode

    • Permanently Effective (Default): Aturan selalu aktif ketika templat perlindungan diaktifkan.

    • Fixed Schedule: Aturan perlindungan hanya aktif selama periode waktu tertentu.

    • Recurring Schedule: Aturan perlindungan hanya aktif selama jadwal berulang tertentu.

Operasi harian

Kelola templat perlindungan

Templat perlindungan yang baru dibuat diaktifkan secara default. Anda dapat melakukan operasi berikut dalam daftar templat:

  • Lihat jumlah Protected Object/Group yang terkait dengan templat.

  • Aktifkan atau nonaktifkan templat menggunakan sakelar Status.

  • Create Rule untuk templat.

  • Edit, Delete, atau Copy templat perlindungan.

  • Klik ikon Expand icon di sebelah kiri nama templat untuk melihat aturan yang terdapat dalam templat.

Kelola aturan perlindungan

Aturan yang baru dibuat diaktifkan secara default. Anda dapat melakukan operasi berikut dalam daftar aturan:

  • Lihat Rule ID, Rule Condition, dan informasi lainnya.

  • Aktifkan atau nonaktifkan aturan menggunakan sakelar Status.

  • Edit atau Delete aturan.

Kuota dan batasan

  • Maksimal 10 Match Condition dapat ditambahkan ke satu aturan perlindungan.

  • Maksimal 5 kondisi dapat ditambahkan ke aturan Deduplication Statistics.

FAQ

Bot Management aturan kustom lanjutan vs. Core Web Protection aturan kustom: Apa perbedaannya?

Comparison Item

Core Web Protection > Custom Rule

Bot Management > Advanced Custom Rules

Versi dan Biaya yang Diperlukan

  • Tidak didukung di Edisi Dasar Langganan. Termasuk dalam semua edisi langganan lainnya.

  • Tersedia di edisi bayar sesuai penggunaan dengan biaya lebih rendah dibandingkan Bot Management > Advanced Custom Rules.

  • Tidak didukung di Edisi Dasar Langganan. Memerlukan pengaktifan Bot Management tambahan untuk edisi langganan lainnya.

  • Tersedia di edisi bayar sesuai penggunaan dengan biaya tambahan.

Fitur yang Didukung

Menyediakan aturan yang memenuhi kebutuhan perlindungan harian.

Selain fungsionalitas Custom Rule, juga mendukung fitur berikut:

  • Mendukung bidang pencocokan tambahan seperti Client ID, sidik jari JA3/JA4, dan data Web/App SDK.

  • Aturan Rate Limiting mendukung UMID sebagai objek statistik dan dapat digunakan bersama dengan Deduplication Statistics.

  • Mendukung aksi Origin Custom Header.