roundcube-defense/README.md

47 lines
1.4 KiB
Markdown

Roundcube Defense
===================
Protects the Roundcube login page from bruteforce login attempts.
Original concept from the roundcube "security" plugin by Lazlo Westerhof.
Wanting to fix the shortfalls of that plugin led me to a rewrite.
Requires Roundcube 1.3 or higher.
FEATURES
-------------------
- Bruteforce protection
- Ban based on X failed-logins per Y seconds (default: 5 fails / 60m)
- Ban for X seconds. (default: 120)
- Increasing ban duration by power of 4 for repeated offenders (2m, 8m, 32m, 8h32m, etc)
- Whitelist
- Blacklist
- Failed logins log [TODO: Logs are in DB, but no interface yet]
- Only accessible by administrator
![Example](http://i.imgur.com/caJQC3I.png)
INSTALLATION
--------------------
1. Change to plugins/ directory
2. Clone git repository with: git clone https://github.com/stalks/roundcube-defense.git defense
3. Add 'defense' table to SQL structure by using schema in sql/
4. Edit config file 'config.inc.php.dist' and save as 'config.inc.php'
4. Add 'defense' to plugins array at config/main.inc.php
ISSUES
--------------------
Create an issue ticket at https://github.com/stalks/roundcube-defense/issues
HISTORY
--------------------
10.12.2017 -- Version 1.0
21.02.2013 -- Version 0.1
- initial release, functional, still bug checking
===================
Created by Steve Allison - https://www.nooblet.org/
Forked and upgraded by Inpos