It's better when it's simple

User Tools

Site Tools


tokenbucketauth Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" unknown
  • 2022-07-31 "Igor" unknown
  • 2020-07-29 "Hogfather" yes

plugin Prevent brute force attacks by delaying them using a token bucket

Last updated on

This plugin delays bruteforce attacks by banning an IP address when this IP tries to log in and fails too much time within a defined period.


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually. If you choose to install it manually, beware of the directory name. All files should be within lib/plugins/tokenbucketauth/.

See Configuration and Settings below to understand how the plugin works.

Configuration and Settings

Here is a list of main settings which explain how the plugin works:

  • tba_block_time: how long to block a user, in seconds (default=600, or 10 minutes) 1);
  • tba_nb_attempt: if s/he failed this many attempts (default=5);
  • tba_mean_time: within this many seconds (default=120, or 2 minutes);
  • tba_whitelist: and is not on the whitelist (default=

Here are additional options:

  • tba_send_mail: send email to admins when a user has been banned, leave blank if to noone or don't care;
  • tba_iptime_file: log users attempts into this file;
  • tba_block_file: log blocked users into this one;
  • tba_lockfile: lock file to know when we can put content into the two others.

You should be able to change these default values using the config manager, but you can change them also manually editing the conf/default.php file.

Change Log

Known Bugs and Issues

Look at the github page if there's any!

ToDo/Wish List

Feel free to add wishes here… but I'd prefer you doing it on github


Feel free to add what you think here!

Protip: if you want the attacker to be banned eternally, just put a very high value here, but beware of the legitimate users which can't differentiate the 'a' letter from the 'q' one
plugin/tokenbucketauth.txt · Last modified: 2022-08-10 11:04 by asheenlevrai

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki