ICE-NET/docs/security/guard.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- Rust workspace: 7 library crates, icenetd CLI, icenet-city (Slint GUI)
- Sim: fix false Delivered after a route cut, derive traffic class from
  payload size, per-link airtime slots (link capacity, queueing)
- Docs: single docs/STATUS.md for all figures, remove v0.2/egui leftovers,
  drop unimplemented seed claims, uncheck store-and-forward
- License: LGPL-3.0-or-later (LICENSE, LICENSES/GPL-3.0.txt)
2026-11-13 12:28:48 +01:00

35 lines
2.1 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.

# ICE Guard: маленькая предсказуемая защита
## До криптографии
В `icenet-guard` реализованы детерминированные локальные проверки:
1. Разрешён ли сервис (ACL).
2. Не превышен ли лимит размера payload.
3. Есть ли место в очереди (`queue_full`).
4. Replay window per peer по монотонному `sequence`.
5. Token bucket per peer (`rate_limited`, `0` отключает лимит).
6. Передан ли тестовый `authenticated` flag **(не реальное доказательство)**.
Проверка возвращает `Permit | Deny(reason)`. Отказ не расходует replay/rate state;
`sequence` фиксируется только после успешного `Permit`. Время передаёт вызывающий
код (`now_ms`), системные часы не читаются.
**Нельзя** считать `authenticated` защитой от подмены на реальной сети.
## После фиксации криптосхемы
- Проверка подписи/handshake + binding NodeID -> key.
- Replay window per sender/peer, ограничение памяти на окна и очереди.
- Rate limits per interface/per service/per peer.
- Неизвестные пути, ложные announce, Sybil, DoS, packet bombs.
- Автоматическое действие только: log, local drop, local rate-limit, local revoke.
## ICE Learning
Из MVP исключён. Возможно вернётся **после** накопления реальных логов и
оценки ложноположительных блокировок, как отдельное необязательное решение.
## Название
Не путать «ICE Guard» со стандартизированным IETF ICE (Interactive Connectivity Establishment).
Перед публичным релизом обсудить переименование внутреннего security crate.