Get started with the WAF

Put a proxied name in log-only mode, review what the WAF would block, fix false positives and then switch to active protection.

The WAF protects every name of a zone that has a proxied DNS record (A, AAAA or CNAME with the proxy on). New zones start with the WAF in active mode at the medium level. If the site is already in production, the safest path is to watch first and block later.

  1. Switch to log-only mode. Nothing is blocked; every request the WAF would block is recorded as a security event with action log.

    Open the domain, go to Security → Firewall and, under Protection, choose Mode → Monitor only. Click Save changes, check the preview and confirm.

  2. Pick the application and the level. Set Application to your stack (wordpress matters: it enables the WordPress shield and stops OpenWAF from blocking /wp-admin and /wp-login.php). Keep WAF sensitivity at medium unless you have a reason to change it. See Modes and levels.

  3. Browse and test the site for a few days: sign in, submit forms, use the checkout and the API.

  4. Review the events. In Analytics → Traffic, filter by action log. Each event names the rule that matched (rule_id). See Security events.

  5. Fix false positives with a WAF exception for that rule on that path, instead of lowering the level for the whole site.

  6. Switch to active mode (mode=active, Protect in the dashboard) when the events show only real attacks.

Next steps

Last updated:

↑↓ to navigate↵ to openesc to close