Regulation

Configuring the Regulation system.

Authelia can temporarily ban accounts when there are too many authentication attempts. This helps prevent brute-force attacks.

Configuration

regulation:
  max_retries: 3
  find_time: 2m
  ban_time: 5m

Options

This section describes the individual configuration options.

max_retries

integer 3 not required

The number of failed login attempts before a user may be banned. Setting this option to 0 disables regulation entirely.

find_time

duration 2m not required

Note: This setting uses the duration notation format. Please see the common options documentation for information on this format.

The period of time analyzed for failed attempts. For example if you set max_retries to 3 and find_time to 2m this means the user must have 3 failed logins in 2 minutes.

ban_time

duration 5m not required

Note: This setting uses the duration notation format. Please see the common options documentation for information on this format.

The period of time the user is banned for after meeting the max_retries and find_time configuration. After this duration the account will be able to login again.