Permalink
0371acf Jan 29, 2017
36 lines (23 sloc) 1.26 KB

Brute Force Protection

The brute force protection of Kanboard works at the user account level:

  • After 3 authentication failure for the same username, the login form shows a captcha image to prevent automated bot tentatives.
  • After 6 authentication failure, the user account is locked down for a period of 15 minutes.

This feature works only for authentication methods that use the login form.

However, after three authentication failure through the user API, the account has to be unlocked by using the login form.

Kanboard doesn't block any IP addresses since bots can use several anonymous proxies. However, you can use external tools like fail2ban to avoid massive scans.

Configuration

Default settings can be changed with these configuration variables:

// Enable captcha after 3 authentication failure
define('BRUTEFORCE_CAPTCHA', 3);

// Lock the account after 6 authentication failure
define('BRUTEFORCE_LOCKDOWN', 6);

// Lock account duration in minutes
define('BRUTEFORCE_LOCKDOWN_DURATION', 15);

Unlocking users

If you don't want to wait 15 minutes, you can unlock a user from the user interface. As administrator, go to the user profile and click on "Unlock this user".