diff options
| author | Nick Fox <[email protected]> | 2018-12-26 12:07:16 -0500 |
|---|---|---|
| committer | Nick Fox <[email protected]> | 2018-12-26 12:07:16 -0500 |
| commit | 473740c13a36f88a48a9eaf0d44c7d43e838047e (patch) | |
| tree | 9b83c4d796831bc7308c8767d57681f6b165442e | |
| parent | ec715d78fbd04fc4225808797677952dcdab5e37 (diff) | |
| download | vaultwarden-473740c13a36f88a48a9eaf0d44c7d43e838047e.tar.gz vaultwarden-473740c13a36f88a48a9eaf0d44c7d43e838047e.zip | |
Update fail2ban documentation for new logging format
| -rw-r--r-- | README.md | 25 |
1 files changed, 6 insertions, 19 deletions
@@ -451,27 +451,15 @@ Though this is unlikely to be required in small deployment, you can fine-tune so ### Fail2Ban Setup -Bitwarden_rs logs failed login attempts to stdout. We need to set this so the host OS can see these. Then we can setup Fail2Ban. +As of release 1.5.0, bitwarden_rs supports logging to file. See [Logging](#logging) above for information on how to set this up. #### Logging Failed Login Attempts to Syslog -We need to set the logging driver to syslog so the host OS and Fail2Ban can see them. +After specifying the log file location, failed login attempts will appear in the logs in the following format: -If you are using docker commands, you will need to add: `--log-driver syslog --log-opt tag=$TAG` to your command. - -If you are using docker-compose, add this to you yaml file: -``` - bitwarden: - logging: - driver: "syslog" - options: - tag: "$TAG" -``` -With the above settings in the docker-compose file. Any failed login attempts will look like this in your syslog file: ``` -MMM DD hh:mm:ss server-hostname $TAG[773]: [YYYY-MM-DD][hh:mm:ss][bitwarden_rs::api::identity][ERROR] Username or password is incorrect. Try again. IP: XXX.XXX.XXX.XXX. Username: [email protected]. +[YYYY-MM-DD hh:mm:ss][bitwarden_rs::api::identity][ERROR] Username or password is incorrect. Try again. IP: XXX.XXX.XXX.XXX. Username: [email protected]. ``` -You can change the '$TAG' to anything you like. Just remember it because it will be in the Fail2Ban filter. #### Fail2Ban Filter @@ -485,11 +473,9 @@ And add the following before = common.conf [Definition] -_daemon = $TAG -failregex = ^%(__prefix_line)s.*Username or password is incorrect\. Try again\. IP: <HOST>\. Username:.*$ +failregex = ^.*Username or password is incorrect\. Try again\. IP: <HOST>\. Username:.*$ ignoreregex = ``` -Dont forget to change the '$TAG' to what you set it as from above. #### Fail2Ban Jail @@ -504,7 +490,8 @@ enabled = true port = 80,443,8081 filter = bitwarden action = iptables-allports[name=bitwarden] -logpath = /var/log/syslog +logpath = /path/to/bitwarden/log +backend = polling maxretry = 3 bantime = 14400 findtime = 14400 |