Configuration Options
  • 26 Feb 2023
  • Dark
    Light

Configuration Options

  • Dark
    Light

Article Summary

The additional features described below allow you to fine-tune the Enforcer to your specific needs.

Guidelines

  • All features must be added to the sub vcl_init block, before the px_module.setup() function.
  • All features are initiated by the px_module.setconffunction and must be written in this format:
    JavaScript
    px_module.setconf("name of configuration", "value")
  • If a feature takes multiple values, each value must be written as a separate line. For example:
    JavaScript
    px_module.setconf("px_whitelist_uri_full", "/login");  
    px_module.setconf("px_whitelist_uri_full", "/user");
    px_module.setconf("px_whitelist_uri_full", "/welcome");

Logger Severity

Sets the Logger Severity mode of the Enforcer.

Name: px_debug

Values:

  • false (default) - The Enforcer logs only errors and fatal events (e.g., exceptions).
  • true - The Enforcer logs all debugging events.

TO enable the feature, switch to true:

px_module.setconf("px_debug", "true")

Module Mode

Sets the working mode of the Enforcer.

Monitor mode - Use this mode to fine-tune and test your system. When in the Monitor mode, the Enforcer will pass through requests that would otherwise be blocked based on their score.
Active Blocking mode - Switch to this mode after making sure the Enforcer is operating properly in the Monitor mode. The Enforcer will block requests, if their score is equal to or higher than the set value.

Name: px_block_enabled

Values:

  • false - Monitor mode (default)
  • true - Active Blocking mode

TO enable the Active Blocking mode, switch to true:

  px_module.setconf("px_block_enabled", "true")

Was this article helpful?