guard/docs/roadmap/v0.4-anti-lockout.md
loki5512344 280284667f
docs: per-task roadmap, architecture and changelog
- 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.
2026-11-16 14:51:50 +01:00

56 lines
2.9 KiB
Markdown
Raw Permalink 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.

# 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-процедура воспроизводится с нуля.