Skip to content

Filtration mode rule

The filtration mode allows you to enable and disable the blocking of requests to various parts of a web application.

To set a filtration mode, create a Set traffic filtration mode rule and select the appropriate mode.

The filtration mode can take one of the following values:

  • Default: the system will work in accordance with the parameters specified in the NGINX configuration files.

  • Disable: the analysis and filtration of requests are disabled completely.

  • Monitorig: the requests are analyzed and displayed in the interface but they are not blocked even if they are originated from blacklisted IPs.

  • Safe blocking: malicious requests are blocked only if they are originated from greylisted IPs.

  • Blocking: malicious requests are blocked and displayed in the interface.

To implement this rule, the NGINX configuration files must permit centralized management of the operation mode.

Changes in the off and monitoring filtration mode logic

Starting with version 3.2, the logic of Wallarm node filtration modes has been changed as follows:

  • Wallarm node analyzes request source only in the safe_blocking and block modes now.
  • If the Wallarm node operating in the off or monitoring mode detects the request originated from the blacklisted IP, it does not block this request.
  • If the Wallarm node operating in the monitoring mode detects the attack originated from the whitelisted IP, it uploads the attack data to the Wallarm Cloud. Uploaded data is displayed in the Events section of Wallarm Console.

During the Wallarm module upgrade, please ensure that deployed Wallarm node processes requests as expected or adjust filtration mode settings to the released changes.

If you have already updated modules, please adjust the filtration mode settings to changes released in version 3.2 (if necessary). Details on filtration mode configuration

Creating and applying the rule

You can create and apply the rule both in the Events and Rules section of Wallarm Console.

  • In the Events section, rules are created with a pre-filled description of endpoints to apply the rule to. The endpoint description corresponds to the request you clicked the Rule button for.

    To complete the rule setup, just select the rule action type and make sure all rule components are configured correctly.

  • In the Rules section, all rule components must be filled in manually.

Example: Disabling Request Blocking During User Registration

If the following conditions take place:

  • new user registration is available at

  • it is better to overlook an attack than to lose a customer

Then, to create a rule disabling blocking during user registration

  1. Go to the Rules tab
  2. Find the branch for, and click Add rule
  3. Choose Set traffic filtration mode
  4. Choose operation mode monitoring
  5. Click Create

Setting traffic filtration mode