All Products
Search
Document Center

Web Application Firewall:Configure a whitelist for Access Control/Throttling

Last Updated:Mar 31, 2026

When Access Control/Throttling modules—HTTP Flood Protection, IP Blacklist, Scan Protection, and Custom Protection Policy—block legitimate requests, you can create a whitelist rule to let matching requests skip the modules causing the false positives.

Prerequisites

Before you begin, ensure that you have:

  • A WAF instance purchased

  • A website added to WAF. See Tutorial

How whitelist rules work

Access Control/Throttling provides application-layer access control and traffic management through four detection modules:

ModuleConfiguration guide
HTTP Flood ProtectionRate-based protection against HTTP flood attacks
IP BlacklistBlock requests from specific IP addresses
Scan ProtectionDetect and block automated scanning activity
Custom Protection PolicyUser-defined access control rules

When a whitelist rule matches a request, WAF skips evaluation by the modules you select in Bypassed Modules. The request is not evaluated by those modules and passes through to your website. Other enabled modules that you did not select continue to evaluate the request normally.

Define match conditions as precisely as possible to avoid allowing unintended traffic.

Create a whitelist rule

  1. Log on to the WAF console.

  2. In the top navigation bar, select the resource group and the region where your WAF instance is deployed. You can select Chinese Mainland or Outside Chinese Mainland.

  3. In the left-side navigation pane, choose Protection Configurations > Website Protection.

  4. At the top of the Website Protection page, select the domain name from the Switch Domain Name drop-down list.

    Switch domain name

  5. Click the Access Control/Throttling tab, and then click Settings.

  6. On the Access Control/Throttling - Whitelisting page, click Create Rule.

  7. In the Create Rule dialog box, configure the following parameters.

    ParameterDescription
    Rule nameEnter a name for the rule.
    Matching ConditionDefine the conditions that a request must meet to trigger this rule. Click Add rule to add more conditions (up to five). All conditions must be met simultaneously (AND logic). For field details, see Fields in match conditions.
    Bypassed ModulesSelect one or more detection modules to skip when the match conditions are met. Options: HTTP Flood Protection, Custom Rules, IP Blacklist, Anti-Scan.

    Access Control/Throttling - Whitelisting

  8. Click Save.

The rule is automatically enabled and appears in the rule list on the Access Control/Throttling - Whitelisting page.

Manage whitelist rules

After creating a rule, you can manage it from the rule list on the Access Control/Throttling - Whitelisting page:

ActionDescription
DisableTemporarily stop the rule from matching requests without deleting it
EditModify the rule name, match conditions, or bypassed modules
DeletePermanently remove the rule

What's next

Fields in match conditions