- 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.
2.9 KiB
2.9 KiB
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
- Сначала — дешёвая часть: startup-проверка
ss -tnp//proc/net/tcpна активные SSH-сессии и предупреждение, если адрес не в whitelist. - Per-port бан: расширить внутренний тип бана (
IpOrCidr+Option<u16>), XDP-путь — только если ABI карты допускает без удвоения памяти; иначе оставить userspace-путь и зафиксировать это в документации. - Тесты:
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-процедура воспроизводится с нуля.