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

2.9 KiB
Raw Permalink Blame History

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