Allowlists

An allowlist tells one rule to skip a path you recognize. It is how a form, login, or API can stay up when you later promote that rule.

When the card asks

Needs allowlist is the outcome for signature rules whose samples include a known-good path: login, CMS, API, payment, SSO, or a single crawler or monitor path. The card’s “what would change this” line is: save the exception on this card when the log names one path and one method.

The exception uses the path and method already on the card. A country is included only when every legitimate sample agrees and every attack sample on that path and method is a different country. That is not a site-wide country allow. The Advisor does not invent a path, a client address, or a rule from a partial or empty log. You click Save on the card. Nothing is written before that.

Some holds are explicit about not using an allowlist. Rate limits never ask for one. An allowlist on a login-fraud rule would turn that rule off for the page, so the card says keep it in count. The Advisor will not allowlist an admin path. A search crawler on several ordinary paths is Hold, not an allowlist of the whole site. An attack-tool user agent on a known-good path is Hold, because an allowlist would exempt the tool.

After it is saved

The allowlist is not a block. Promote is still a separate click. If the saved rule covers the known-good samples and what remains is an explained attack, the card can say Promote. If the count is still larger than the sample, or a non-attack path remains, or a bot rule has only the allowed path left, it stays Hold.

Always allow runs first, so an address on that list skips the rest of the firewall. A count exception is recorded next and does not skip a later block. A temporary response, an IP block, a country block, and a rate limit run before a path allow. A path allow skips the custom blocks and managed protections after it. It does not skip those earlier controls. A save that would put them in the wrong order is stopped, and nothing is changed.

Removing an allowlist is a recorded change. It does not by itself change the rule from count to block.

Related guides

More in this section