Files
fail2ban-webui/CHANGELOG.md
T
schiwagoaandClaude Opus 5.5 2e3f79236c Initial version of fail2ban-webui
Web interface to view, ban and unban fail2ban IPs on several hosts via
SSH, generalised from the private f2b-web tool.

- Web UI (Flask/Waitress): hosts.yaml, local/OIDC/proxy authentication,
  English/German UI, origin map, optional Loki/Grafana/GeoIP, CLI helpers
- Agent f2b-webctl with install.sh/uninstall.sh (dedicated user + sudo,
  from= restriction, protected networks, manual jail)
- Hardened Docker image, examples, documentation, smoke test, testbed

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 15:38:17 +01:00

27 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
All notable changes are listed here. Versions follow [Semantic Versioning](https://semver.org).
## [Unreleased] – 1.0.0
First public version, generalised from a private single-site tool.
### Web UI
- Hosts in `config/hosts.yaml` (name, address, port, user); `F2B_HOSTS` still accepted
- Authentication: local user (scrypt hash, lockout after failed logins), OpenID Connect,
reverse-proxy mode with optional source-IP check and user header
- English and German UI with a language dropdown; new languages via `locales/xx.json`
- Optional Loki history, Grafana links and GeoIP (DB-IP Lite auto-download)
- Origin map: banned IPs as points on a world map (bundled, no external tiles); click filters the list
- CLI: `hash-password`, `keygen`, `keyscan`, `check`
- Hardened image: non-root, read-only root filesystem, no pip/setuptools at runtime,
SSH client ignores the system ssh_config and never uses GSSAPI
- Log lines (`LOGIN_FAILED user=… ip=…`) are safe for fail2ban: user-controlled values
are sanitised, so no extra log lines can be injected
### Agent
- `f2b-webctl` reads `/etc/f2b-webctl.conf`; private, own and configured addresses are never banned
- Error codes for translated messages, `version` command, fallback for fail2ban without `--with-time`
- `install.sh` / `uninstall.sh`: dedicated user with sudo rule (or root), `from=` restriction,
custom authorized_keys file, optional manual jail, backups, dry run, self test