Initial import: ICE-NET research docs and Rust workspace (v0.4)
Some checks failed
rust-ci / checks (push) Has been cancelled

- 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)
This commit is contained in:
Loki 2026-11-13 12:28:48 +01:00
commit 2e61688eb3
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
141 changed files with 13993 additions and 0 deletions

View file

@ -0,0 +1,35 @@
# Криптография и приватность: проектные принципы
## Цель
Даже если посредники физически хранят и передают данные, они не получают ключей для чтения сообщений. При этом защита от чтения содержимого **не** равна защите от анализа метаданных.
## Стандартные строительные блоки
- Проверенная криптографическая библиотека, не собственный алгоритм шифрования.
- Аутентифицированный обмен ключами; исследовать [Noise](../sources/part1.md#s26).
- E2E сообщения с аутентификацией и подтверждением криптографического sender identity; варианты [HPKE](../sources/part1.md#s08) и [MLS для групп](../sources/part1.md#s07).
- DTN требует защищать **данные в очереди** (encryption at rest, TTL, квоты). Полезен [BPSec](../sources/part1.md#s05).
- Отдельный слой авторизации сервисов: корректная подпись Node ID не означает право читать «фото-ящик».
## Приватность географии и графа контактов
Сильный шифр не скрывает, что два устройства часто переписываются, когда передают и какой relay используют. Публикация стабильного хеша ID в каждой вышке может построить базу перемещений. План защиты:
1. Не объявлять GPS/местоположение автоматически.
2. По умолчанию лишь ephemeral идентификаторы поиска соседей, насколько это совместимо с маршрутизацией.
3. Не строить публичные «списки присутствующих людей на вышке».
4. Хранить маршрутизаторные кэши недолго; минимизировать журналы.
5. Обсудить возможные атаки корреляцией сигнала, времени и размера пакетов.
## Конфликт приватности и маршрутизации
Ротация псевдонимов увеличивает цену поиска. Глобальная discoverability уменьшает privacy. Нет бесплатной магии — оценивать компромиссы отдельно для городского high-bandwidth домена и LoRa.
## Модель доверия
`NodeID = криптографическая идентичность`, `Contact = утверждение пользователя`, `Service permission = локальная политика`. Не смешивать эти три понятия.
## Криптографический релиз-гейт
Никакого публичного «100% безопасно» до независимого аудита, тестовых векторов, результатов fuzz и воспроизводимой сборки. Даже при аудите формулировать ограниченную угроз-модель.

View file

@ -0,0 +1,52 @@
# ICE Guard: маленькая локальная система безопасности
> Слово ICE вдохновлено Cyberpunk; его нужно отличать от [Interactive Connectivity Establishment (RFC 8445)](../sources/part1.md#s09). Внутреннее название **ICE Guard** пока рабочее. Система **не** атакует чужие компьютеры.
## Цель
Дешёвый модуль, который выполняет *проверку входящих сетевых событий* и не требует нейросети, GPU и постоянного сервера. Полезно разделить защиту на **обязательные правила** и **адаптивную оценку риска**.
## Базовый путь решения
```text
RX packet
│
├─ parser + caps → malformed? → DROP
├─ cryptographic auth → invalid? → DROP
├─ ACL service → denied? → DENY
├─ anti-replay → replay? → DROP
├─ rate limiter → over quota? → DELAY/DROP
└─ behavior telemetry → anomaly? → SCORE / REVIEW / THROTTLE
└─ allowed? → forward / deliver
```
## Подходящие CPU-only методы
| Метод | Для чего | Ограничение |
|---|---|---|
| FSM | допустимые переходы состояний | фиксированные правила |
| Decision tree | быстрый предсказуемый классификатор | зависит от качества обучения |
| Байесовская модель | оценка риска по признакам | независимость признаков может быть неверной |
| EWMA/statistics | необычные потоки/скорость запросов | ошибка при смене нормального поведения |
| Token bucket | гарантированные rate caps | не распознаёт сложные угрозы |
| Exact ACL + signatures | права доступа и подлинность | требует корректной криптографии |
## Архитектура
- **ICE Core:** C/Rust, детерминированные проверки, лимиты байтов и CPU, фиксированные профили сервисов.
- **ICE Policy:** настройки владельца («этот сервис только контакты», «мобильная батарея не ретранслирует»).
- **ICE Learning:** необязательный офлайн-процесс: анализирует анонимизированные журналы/пометки, строит маленькое дерево и предлагает **новую версию правил**, но не включает её автоматически.
## Важные предохранители
1. Не блокировать доступ только из-за отклонения от статистики: false positive высоки в нестабильных радиосетях.
2. Не обучаться бесконтрольно на открытом трафике — возможно poisoning.
3. Не хранить бессрочно чужие адреса/локаторы и геопозиции.
4. Не отсылать ответные «атаки», вредоносные payload или сетевое сканирование чужих хостов.
5. Не задерживать критически важный текст ради сложной классификации: сначала дешёвые проверки и fair queue.
## Измерять
p95 времени проверки, CPU/пакет, память на 10k соседей, число ошибочных блокировок, устойчивость к burst, скорость восстановления честного узла, наличие удалённой возможности изменить политику без перезапуска.
Основной RFC-подход к security для задержанной доставки см. [BPSec](../sources/part1.md#s05). Подход к рукопожатиям — [Noise](../sources/part1.md#s26).

View file

@ -0,0 +1,41 @@
# Модель угроз ICE-NET
## Активы
Закрытые ключи пользователя; сообщения и фото; metadata об участниках и маршрутах; airtime и батарея; память/диск реле; таблицы путей; контроль над сервисами.
## Противники
1. Пассивный наблюдатель радио: видит передачу, длительность, сигнал, даже если содержимое зашифровано.
2. Чужой relay: может задерживать, изменять, удалять пакеты, заявлять ложные маршруты.
3. Массовый участник: создаёт множество ключей (Sybil), фальшивые объявления, пытается истощить память и радиоэфир.
4. Владелец скомпрометированного конечного устройства: криптография не исправит заражённый endpoint.
5. Сбойный узел без злого умысла: дублирует пакеты, забывает state, путает время.
## Угрозы и контроль
| Угроза | Контроль | Остаточный риск |
|---|---|---|
| Подделка Node ID | подпись challenge, валидные ключи | адрес можно создать новый, Sybil остаётся |
| Подмена/чтение трафика relay | E2E encryption + integrity | relay видит часть metadata и может сбросить |
| Replay | уникальные packet IDs, ограниченные replay windows | при DTN окна сложнее |
| Flooding | лимиты на путь, на сервис, на анонс, bounded queues | массовая радиопомеха всё ещё возможна |
| Poisoned route | ограниченная область доверия, независимая проверка метрик | злой relay всё ещё может blackhole |
| Перехват имени | проверка fingerprint out-of-band | человек может ошибиться |
| Слежка по стабильным beacon | ротируемые псевдонимы, минимальные анонсы | анализ трафика остаётся |
| Зависимость от большого хаба | несколько peers / маршрутов и DTN | при отсутствии всех путей связь невозможна |
## Правила реагирования
**Разрешённые локальные действия ICE:** DROP, THROTTLE, REQUIRE-AUTH, QUARANTINE LOCAL SESSION, REVOKE KEY, REPORT LOCAL LOG.
**Не предусмотрены:** встречный взлом, повреждение чужих устройств, перехват управления чужим маршрутизатором.
## Проверки безопасности
- Fuzz всего парсера и сериализатора.
- Verify under traffic load + malicious input.
- Verify authenticated header binding: не оставлять опасные неаутентифицированные поля.
- Replay/drop/reorder и несинхронные часы в тестовой среде.
- Процедура security disclosure и отдельная политика хранения секретов.
См. [ICE Guard](ice_engine.md), [privacy & crypto](crypto_privacy.md), [BPSec RFC 9172](../sources/part1.md#s05).