All Products
Search
Document Center

Web Application Firewall:daftar putih

Last Updated:Aug 05, 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 "Tidak Diterapkan".

      • 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: Mendefinisikan 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 menambahkan beberapa objek yang dilindungi ke dalam kelompok objek yang dilindungi untuk manajemen terpusat.

Prosedur

Catatan

Sebelum memulai, pastikan objek yang dilindungi sudah ada, yaitu layanan web Anda telah ditambahkan ke WAF. Jika belum, 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) dari 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 Anda 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.

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

  • Template Name: Masukkan nama untuk templat.

  • 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 mengatur 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 mengatur 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.

  • 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 mencakup beberapa kondisi, permintaan harus memenuhi seluruhnya (dengan hubungan logika AND) agar sesuai dengan aturan tersebut. Untuk informasi lebih lanjut mengenai 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 client 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 besar.

        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 menetapkan URL atau Path URL.

        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 tertentu yang dikonfigurasi berdasarkan nama aturannya. Fitur 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 menerapkan templat bergantung pada konfigurasi yang ditetapkan di Langkah 1:

  • Untuk templat default: Anda tidak perlu mengatur 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 secara manual objek yang dilindungi dan kelompok objek yang dilindungi tempat 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 dalam 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 dalam daftar aturan:

  • Lihat informasi seperti Rule ID dan Rule Condition.

  • Aktifkan atau nonaktifkan aturan menggunakan sakelar Status.

  • Edit atau Delete aturan.

Kuota dan batasan

  • Saat Match Field diatur ke IP, hanya alamat IP publik yang didukung. Alamat IP privat tidak diperbolehkan.

  • Anda tidak dapat menggunakan Konsol WAF untuk mengekspor daftar lengkap alamat IP daftar putih yang dikonfigurasi atau melakukan ekspor batch aturan daftar putih.

FAQ

Mengapa daftar putih yang dikonfigurasi tidak berfungsi?

Jika aturan yang dikonfigurasi tidak berlaku, periksa hal-hal berikut secara berurutan:

  • Sakelar templat: Pastikan Status templat dan Status aturannya keduanya diaktifkan.

  • Objek yang dilindungi: Di halaman Edit, di area Apply To, gunakan tombol filter Effective dan Ineffective untuk memastikan objek yang dilindungi telah dikaitkan dengan benar ke templat.

  • Konfigurasi aturan: Pastikan konfigurasi aturan daftar putih. Perhatikan dengan seksama Match Conditions untuk memastikan bahwa kondisi tersebut secara akurat mencocokkan permintaan yang dimaksud.

Apa itu templat "AutoTemplate"?

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

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

  • Anda dapat menandai event yang terdeteksi oleh modul web core protection rule atau bot management sebagai Suppress False Positive dalam laporan keamanan. Untuk informasi selengkapnya, 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 melewatkan semua atau modul perlindungan tertentu terhadap permintaan yang memenuhi kriteria tertentu. Untuk menerapkan kontrol akses berbasis IP, gunakan modul Custom Rule. Contoh detail tersedia di Restrict admin panel access to specific IP addresses only.

Apakah fitur daftar putih dan penekanan false positive dikenai biaya?

Fitur daftar putih tidak dikenai biaya tambahan karena biayanya sudah termasuk dalam biaya traffic dasar.

Fitur Suppress False Positive dalam laporan keamanan menambahkan aturan ke templat daftar putih AutoTemplate. Aturan-aturan ini tidak dikenai biaya tambahan.

Apa yang harus dilakukan jika WAF memblokir lalu lintas layanan yang sah?

Jika WAF memblokir lalu lintas layanan yang sah, ikuti langkah-langkah berikut untuk menambahkan traffic tersebut ke daftar putih.

  1. Di panel navigasi kiri, pilih Detection and Response > Security Reports.

    Catatan

    Jika Anda telah mengaktifkan Simple Log Service, Anda juga dapat membuka Detection and Response > Log Service untuk melihat log permintaan lengkap.

  2. Filter berdasarkan Time, Protected Object (nama domain atau instans produk cloud yang diakses), dan Rule Action untuk menemukan permintaan yang diblokir secara spesifik.

  3. Jika Anda memastikan bahwa permintaan yang sah diblokir, di area Logs di bagian bawah halaman, klik Suppress False Positive di kolom Actions untuk menambahkan aturan daftar putih untuk permintaan tersebut.

    Jika permintaan menunjukkan fitur pengelompokan, seperti satu alamat IP tepercaya yang memicu beberapa aturan perlindungan, analisis false positive tersebut. Cari ciri-ciri umum seperti path URL tertentu, format parameter, atau jenis antarmuka layanan. Kemudian, tambahkan aturan daftar putih yang tepat berdasarkan prinsip hak istimewa minimal:

    • Cocokkan kombinasi path URL dan parameter kunci. Misalnya, Anda hanya dapat mengizinkan permintaan layanan tertentu seperti /api/v1/order?source=internal.

    • Buat pengecualian yang ditargetkan untuk kombinasi ID aturan dan skenario bisnis. Misalnya, Anda dapat memasukkan ke daftar putih aturan validasi tertentu hanya untuk antarmuka pembayaran.

    • Hindari mengonfigurasi aturan yang mengizinkan semua traffic. Aturan yang tepat mengurangi upaya yang diperlukan untuk menangani pengecualian secara individual, serta meningkatkan efisiensi O&M tanpa mengorbankan keamanan.

Apakah aturan daftar putih memiliki prioritas lebih tinggi daripada modul lainnya?

Ya, aturan daftar putih memiliki prioritas tertinggi. Ketika permintaan mengenai aturan daftar putih yang dikonfigurasi untuk melewati modul tertentu, seperti daftar hitam IP atau aturan perlindungan inti web, aksi izinkan dieksekusi segera, mengesampingkan aturan apa pun dalam modul yang dilewati tersebut.