All Products
Search
Document Center

Web Application Firewall:daftar putih

Last Updated:May 30, 2026

Anda dapat mengonfigurasi aturan daftar putih untuk mengizinkan permintaan tertentu melewati deteksi oleh beberapa atau seluruh modul perlindungan, seperti aturan perlindungan inti web, daftar hitam IP, aturan kustom, dan perlindungan pemindaian.

Konsep utama

  • Daftar putih: Fitur dalam Web Application Firewall (WAF) yang memungkinkan permintaan tertentu melewati deteksi oleh beberapa atau seluruh modul perlindungan. Anda harus membuat templat perlindungan daftar putih untuk mengaktifkan fitur ini. Sistem memungkinkan pembuatan beberapa templat perlindungan daftar putih.

  • Templat perlindungan daftar putih: Kumpulan aturan daftar putih yang mendefinisikan konten dan cakupan aturan tersebut. Terdiri dari tiga bagian: jenis templat, aturan daftar putih, dan objek yang berlaku.

    • Jenis templat: Anda harus memilih jenis templat saat pembuatan. Jenis tersebut tidak dapat diubah setelahnya. Tersedia dua jenis templat:

      Jenis templat

      Deskripsi

      Kasus penggunaan

      Templat perlindungan default

      • Setelah Anda membeli WAF, sistem secara otomatis membuat templat perlindungan default yang tidak berisi aturan apa pun.

      • Secara default, templat ini berlaku untuk semua objek yang dilindungi dan kelompok objek yang dilindungi yang sudah ada maupun yang akan datang.

      • Anda dapat mengecualikan objek secara manual dengan mengubah statusnya menjadi "Not Applied".

      • Anda hanya dapat membuat satu templat perlindungan default untuk modul daftar putih.

      Terapkan aturan umum yang perlu diterapkan secara global.

      Templat perlindungan kustom

      Anda harus menetapkan templat ini secara manual ke objek yang dilindungi atau kelompok objek yang dilindungi tertentu.

      Terapkan aturan detail halus untuk layanan tertentu, seperti API login atau pembayaran.

    • Aturan daftar putih: Mendefinisikan logika deteksi spesifik dan modul yang dilewati. Satu templat dapat berisi beberapa aturan, dan setiap aturan terdiri dari dua bagian:

      • Kondisi pencocokan: Mendefinisikan karakteristik permintaan yang akan dicocokkan, seperti path permintaan atau alamat IP klien.

      • Modul yang dilewati: Menentukan modul perlindungan mana yang dilewati oleh permintaan yang memenuhi kondisi pencocokan.

    • Objek yang berlaku: Menentukan target penerapan templat tersebut. Dengan mengonfigurasi objek yang berlaku, Anda menerapkan aturan daftar putih ke objek yang dilindungi atau kelompok objek yang dilindungi tertentu. Satu objek yang dilindungi atau kelompok objek yang dilindungi dapat dikaitkan dengan beberapa templat perlindungan daftar putih.

      • Objek yang dilindungi: Untuk setiap nama domain atau instans layanan cloud yang ditambahkan ke WAF, sistem secara otomatis membuat objek yang dilindungi.

      • Kelompok objek yang dilindungi: Anda dapat mengelompokkan beberapa objek yang dilindungi ke dalam satu kelompok objek yang dilindungi untuk manajemen terpusat.

Prosedur

Catatan

Sebelum memulai, pastikan objek yang dilindungi sudah ada, artinya Anda telah menambahkan layanan web Anda ke WAF. Jika belum menambahkan layanan Anda, lihat Tambahkan layanan ke WAF.

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

Langkah 1: Konfigurasikan jenis templat

Setelah Anda membeli WAF, sistem membuat templat perlindungan default bernama user_default tanpa aturan apa pun. Jika tidak memiliki kebutuhan bisnis khusus—seperti mengonfigurasi beberapa templat atau menentukan objek yang berlaku—Anda dapat langsung menggunakan templat user_default. Klik Edit dan lanjutkan ke Langkah 2.image

Di halaman Whitelist, klik Create Template. Di panel Create Template - Whitelist, lengkapi konfigurasi berikut.

  • Template Name: Masukkan nama untuk templat tersebut.

  • Save as Default Template: Anda hanya dapat menetapkan satu templat default untuk modul daftar putih, dan hanya dapat ditetapkan saat membuat templat baru.

    • Yes: Anda tidak perlu menyetel Apply To. Saat templat dibuat, templat tersebut berlaku untuk semua objek yang dilindungi dan kelompok objek secara default. Objek baru juga secara otomatis disertakan. Anda dapat mengecualikan objek tertentu secara manual dengan mengatur statusnya menjadi "Not Applied".

    • No: Anda harus menyetel Apply To dengan menentukan objek yang dilindungi atau kelompok objek secara manual.

Langkah 2: Tambahkan aturan daftar putih

Di area Rule Configuration, klik Create Rule, lengkapi konfigurasi berikut, lalu klik OK.

  • Rule Name: Masukkan nama untuk aturan tersebut.

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

    Catatan

    Jika suatu aturan berisi beberapa kondisi, permintaan harus memenuhi semuanya (hubungan logika AND) agar cocok dengan aturan tersebut. Untuk informasi lebih lanjut tentang bidang pencocokan dan operator logika, lihat Match conditions.

    Match Field

    Logical Operator

    Match Content

    Description

    URI Path

    Contains

    /login.php

    Aturan ini cocok jika path permintaan berisi /login.php.

    IP

    Belongs to

    192.1.XX.XX

    Aturan ini cocok jika alamat IP klien adalah 192.1.XX.XX.

  • Bypassed Modules: Tentukan modul perlindungan yang dapat dilewati oleh permintaan yang memenuhi Match Condition. Opsi berikut tersedia:

    • Disable All Detections: Gunakan opsi ini untuk mengizinkan traffic yang sepenuhnya Anda percayai.

    • Custom: Pilih modul perlindungan spesifik yang akan dilewati.

      All

      Permintaan yang cocok melewati semua modul perlindungan dan dikirim langsung ke server origin.

      Custom

      Jika Anda memilih opsi ini, pilih modul perlindungan yang akan dilewati dari daftar berikut.

      • Core Protection Rule

        All rules

        Melewati deteksi untuk semua Core Protection Rule.

        Specific rule IDs

        Melewati deteksi untuk aturan dengan ID tertentu. Tekan Enter setelah memasukkan setiap ID aturan.

        Anda dapat memasukkan hingga 50 ID aturan, termasuk aturan untuk perlindungan event penting.

        Specific modules

        Melewati deteksi untuk jenis aturan tertentu. Pilih jenis aturan sesuai kebutuhan.

        Specific fields

        Tentukan bidang yang akan diabaikan oleh aturan perlindungan inti web. Anda dapat menambahkan hingga 10 bidang.

        Field type

        Description

        URI

        • Anda dapat mengonfigurasi semua bidang atau bidang tertentu.

        • Saat mengonfigurasi bidang tertentu, Anda dapat menyetel URL atau URL Path.

        Header

        • Anda dapat mengonfigurasi semua bidang atau bidang tertentu.

        • Jika Anda memasukkan q sebagai bidang tertentu, konten efektif sebenarnya adalah header.q.

        Query string parameter

        • Anda dapat mengonfigurasi semua bidang atau bidang tertentu.

        • Jika Anda memasukkan q sebagai bidang tertentu, konten efektif sebenarnya adalah queryarg.q.

        Cookie name

        • Anda dapat mengonfigurasi semua bidang atau bidang tertentu.

        • Jika Anda memasukkan q sebagai bidang tertentu, konten efektif sebenarnya adalah cookie.q.

        Body

        Anda hanya dapat mengonfigurasi semua bidang.

        Sebagai contoh, pada API pencarian situs e-commerce, kueri pengguna yang berisi karakter khusus seperti & atau " mungkin diblokir sebagai serangan yang dicurigai oleh aturan perlindungan inti web, sehingga pencarian gagal.

        GET /search?q=phone

        Pada contoh ini, atur Field Type ke Query String Parameter, Scope ke Specified Fields, dan masukkan q untuk Specified Fields. Hal ini memungkinkan bidang kueri dimasukkan ke daftar putih tanpa menonaktifkan sepenuhnya aturan perlindungan inti web.

      • IP Address Blacklist

        All rules

        Melewati deteksi untuk semua aturan dalam modul IP Address Blacklist.

        Specific rule IDs

        Melewati deteksi untuk aturan dengan ID tertentu. Tekan Enter setelah memasukkan setiap ID aturan. Anda dapat memasukkan hingga 50 ID aturan.

      • Custom Rule

        All rules

        Melewati deteksi untuk semua aturan dalam modul Custom Rule.

        Specific rule IDs

        Melewati deteksi untuk aturan dengan ID tertentu. Tekan Enter setelah memasukkan setiap ID aturan. Anda dapat memasukkan hingga 50 ID aturan.

      • Scanning Protection: Melewati deteksi untuk semua aturan dalam modul Scanning Protection.

      • HTTP Flood Protection: Melewati deteksi untuk semua aturan dalam modul HTTP Flood Protection.

      • Geo-blocking: Melewati deteksi untuk semua aturan dalam modul Geo-blocking.

      • Website Tamper-proofing : Melewati deteksi untuk semua aturan dalam modul Website Tamper-proofing .

      • Data Leakage Prevention: Melewati deteksi untuk semua aturan dalam modul Data Leakage Prevention.

      • Protection for Critical Events: Melewati deteksi untuk semua aturan dalam modul Protection for Critical Events.

      • Peak Traffic Throttling: Melewati deteksi untuk semua aturan dalam modul Peak Traffic Throttling.

      • AI Application Protection: Melewati deteksi untuk semua aturan dalam modul AI Application Protection.

      • Bot Management

        All rules

        Melewati deteksi untuk semua aturan dalam modul Bot Management.

        Specific rule IDs

        Melewati deteksi untuk aturan dengan ID tertentu. Tekan Enter setelah memasukkan setiap ID aturan. Anda dapat memasukkan hingga 50 ID aturan.

        Specific rules

        Melewati deteksi untuk aturan spesifik yang dikonfigurasi berdasarkan nama aturan. Ini mendukung aturan dari Bot Management for Web dan Bot Management for App. Jika Anda menggunakan legacy Bot Management atau belum mengonfigurasi perlindungan web/aplikasi yang sesuai, pengaturan ini tidak akan berlaku.

Langkah 3: Atur objek yang berlaku

Di area Apply To, pilih objek yang dilindungi dan kelompok objek yang dilindungi untuk menerapkan templat tersebut.

Cara penerapan templat bergantung pada konfigurasi di Langkah 1:

  • Untuk templat default: Anda tidak perlu menyetel objek yang berlaku. Saat templat dibuat, templat tersebut berlaku untuk semua objek yang dilindungi dan kelompok objek secara default. Objek baru juga secara otomatis disertakan. Anda dapat mengecualikan objek tertentu secara manual dengan mengatur statusnya menjadi "Not Applied".

  • Untuk templat kustom: Anda harus menentukan objek yang dilindungi dan kelompok objek yang dilindungi secara manual agar templat tersebut berlaku.

Catatan

Anda dapat menyesuaikan status penerapan objek yang dilindungi atau kelompok objek baik selama maupun setelah pembuatan templat.

Pemeliharaan

Kelola templat daftar putih

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

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

  • Aktifkan atau nonaktifkan templat menggunakan Status.

  • Create Rule untuk templat ini.

  • Edit, Delete, atau Copy templat.

  • Klik ikon 展开图标 di sebelah kiri nama templat untuk melihat aturan yang dikandungnya.

Kelola aturan daftar putih

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

  • Lihat informasi seperti Rule ID dan Rule Condition.

  • Aktifkan atau nonaktifkan aturan menggunakan sakelar Status.

  • Edit atau Delete aturan.

FAQ

Mengapa aturan daftar putih saya tidak berfungsi?

Jika aturan daftar putih tidak berfungsi seperti yang diharapkan, verifikasi pengaturan berikut secara berurutan:

  • Status templat dan aturan: Pastikan templat dan aturan keduanya diaktifkan.image

  • Objek yang berlaku: Konfirmasi bahwa templat berstatus Effective.image

  • Konfigurasi aturan: Tinjau konfigurasi aturan daftar putih, dengan fokus khusus pada kebenaran kondisi pencocokan untuk memastikan kondisi tersebut sesuai dengan permintaan.

Apa itu templat "AutoTemplate"?

WAF secara otomatis membuat templat perlindungan daftar putih bernama AutoTemplate dan menambahkan aturan daftar putih ke dalamnya jika salah satu kondisi berikut terjadi:

  • Engine daftar putih cerdas untuk aturan perlindungan inti web diaktifkan dan mengidentifikasi potensi false positive melalui analisis log. Untuk informasi lebih lanjut, lihat intelligent whitelisting engine.

  • Anda menandai event yang dideteksi oleh modul web core protection rule atau bot management sebagai Suppress False Positive di laporan keamanan. Untuk informasi lebih lanjut, lihat Security reports.

Haruskah saya menggunakan modul daftar putih untuk membatasi akses domain WAF berdasarkan IP?

Tidak. Modul Whitelist yang dijelaskan di sini dirancang untuk melewati semua atau modul perlindungan tertentu untuk permintaan yang memenuhi kriteria tertentu. Untuk menerapkan kontrol akses berbasis IP, gunakan modul Custom Rule. Untuk contoh detail, lihat Restrict access to the admin backend to specific IPs.