- Split TODO into a thin status index plus docs/roadmap/ with one file per task (v0.4 reliability, v0.5 product, v0.6 research, icebox). - Add docs/architecture.md (current processes, packet/data path, layers, storage, metrics) and docs/development.md (rules, gates, DoD). - Add CHANGELOG.md reconstructed from history; move round details out of TODO. - Align docs with the code: config defaults and missing [detect]/ [protocol.http] sections, XDP metric names, ClickHouse table and TTL, Redis RDB restore, multiarch clang include, CLI binary name. - Add scripts/check_docs_links.sh and run it in CI. - release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB, http parser bench 314 ns -> 278 ns; panic=abort stays off for catch_unwind in the Redis subscriber. - Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
56 lines
2.9 KiB
Markdown
56 lines
2.9 KiB
Markdown
# v0.4 — Anti-lockout и баны по порту
|
||
|
||
| | |
|
||
|---|---|
|
||
| Milestone | v0.4 |
|
||
| Status | planned |
|
||
| Priority | P1 |
|
||
| Depends on | — |
|
||
|
||
## Цель
|
||
|
||
Админ не может заблокировать сам себя, а бан применяется к конкретному
|
||
защищаемому порту, когда это возможно, вместо всего IP.
|
||
|
||
## Зачем
|
||
|
||
Слепой `XDP_DROP` по IP отрезает SSH и мониторинг вместе с атакой — это известная
|
||
проблема crab-shield и типовая причина отказов от XDP-фильтров. `whitelist` уже
|
||
есть и обходит фильтры, но он не защищает от ошибки в конфиге или от бана
|
||
динамически добавленного админа.
|
||
|
||
## Scope
|
||
|
||
- Защита от самоблокировки: при старте проверять, что текущие SSH-сессии и
|
||
админские сети не попадут под blacklist/ban; предупреждать и (по флагу)
|
||
добавлять их в whitelist.
|
||
- Per-port баны в userspace и, где позволяет формат, в XDP (сейчас ключ бана —
|
||
только IP/CIDR).
|
||
- Документированная процедура восстановления, если нода всё-таки заблокирована.
|
||
|
||
## Non-goals
|
||
|
||
- Полный port-knocking.
|
||
- Замена firewall: Rampart остаётся stateless-фильтром, а не заменой nftables.
|
||
|
||
## Approach
|
||
|
||
1. Сначала — дешёвая часть: startup-проверка `ss -tnp`/`/proc/net/tcp` на активные
|
||
SSH-сессии и предупреждение, если адрес не в whitelist.
|
||
2. Per-port бан: расширить внутренний тип бана (`IpOrCidr` + `Option<u16>`),
|
||
XDP-путь — только если ABI карты допускает без удвоения памяти; иначе
|
||
оставить userspace-путь и зафиксировать это в документации.
|
||
3. Тесты: `tests/connection_limits.rs`/`tests/filter_logic.rs` + новый тест на
|
||
сериализацию ключа бана.
|
||
|
||
## Критерии приёмки
|
||
|
||
- [ ] Edge при старте пишет `WARN`, если SSH-клиент не в whitelist.
|
||
- [ ] Бан по порту не блокирует остальные порты того же IP.
|
||
- [ ] Recovery-процедура проверена в netns и описана в runbook.
|
||
- [ ] Нет изменений ABI XDP без теста в `tests/xdp_ban_keys.rs`.
|
||
|
||
## Верификация
|
||
|
||
netns-стенд: забаненный источник теряет доступ к 25565, но сохраняет SSH-порт;
|
||
runbook-процедура воспроизводится с нуля.
|