Files
bare/docs/decisions/021-sessions-csrf-limits.md
mayatnikovandClaude Opus 5 db45978b16 Этап 6: закалка — лимиты ADR-021, аудит модели угроз, сверка документов
Лимиты: все четыре правила ADR-021 — регистрация 5/час на IP, вход 10/10 мин
на IP и ник, сообщения 30/мин, прочие изменяющие 60/мин; 429 с Retry-After;
X-Real-IP читается только с loopback, иначе адрес соединения — иначе заголовок
отменял бы лимит на IP; карты вёдер ограничены поколениями.

Аудит нашёл то, что пропустили пять раундов ревью:
ADR-056: nginx вёл access_log с IP и полными путями вопреки обещанию deploy.md.
Ники и социальный граф ложились в /var/log/nginx рядом с чистым журналом bare.
ADR-058: «выйти на других устройствах» не обрывал уже открытый SSE — отозванная
сессия продолжала получать сообщения.
ADR-059: промежуточный ключ комнаты был невосстановим. Участник, пропустивший
офлайн два rekey подряд, навсегда не расшифровал бы сообщения среднего ключа —
вопреки обещанию storage.md о повторной попытке после получения keyId.
ADR-063: ACK уходил по одному на конверт, а не пачкой. Получатель в оживлённой
комнате выедал общее ведро подтверждениями и упирался в 429 на всех изменяющих
запросах, включая выход из комнаты: 116 отказов за прогон стало нулём.
ADR-055, 057, 060, 061, 062: ключи вёдер и границы, +dirty у bare version,
403 unknown_device не хоронит сообщение, усечение имени в подсказке ввода,
kdf как оракул после повышения цели KDF.

Модель угроз пополнена тем, что действительно видит оператор: push-подписки
лежат в базе открытым текстом, и вместе с VAPID-ключом с той же машины это
произвольное уведомление на экране блокировки.

README приведён к v1.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ
2026-08-23 06:22:52 +03:00

4.2 KiB
Raw Permalink Blame History

ADR-021: Сессии, CSRF, Argon2id и лимиты

Уточнён ADR-055: пакеты правил, состав «остальных изменяющих», место лимита в порядке проверок, границы карт и доверие к X-Real-IP; ADR-058: смена пароля с logoutOthers закрывает потоки событий отозванных сессий, а не только удаляет их строки.

Контекст

ADR-005 задаёт «Argon2id, сессия в httpOnly cookie» без параметров. Cookie плюс fetch POST — классическая поверхность для CSRF. Лимиты и защита от перебора — открытый вопрос.

Решение

Argon2id. Вход — authKey (32 случайных байта с точки зрения сервера, ADR-015), поэтому параметры умеренные: memory 19 MiB, time 2, parallelism 1, соль 16 байт, выход 32 байта. Параметры записываются рядом с хешем; повышение — перехеш при очередном входе.

Сессия. Токен — 32 случайных байта; в базе хранится SHA-256(токен). Cookie bare_session: HttpOnly; Secure; SameSite=Strict; Path=/; срок 90 дней без продления. После регистрации устройства сессия привязывается к нему. POST /api/logout удаляет сессию; смена пароля по желанию завершает остальные; удаление устройства завершает его сессии.

CSRF. Два независимых барьера: SameSite=Strict и проверка заголовка Origin на всех запросах кроме GET/HEAD — он обязан равняться BARE_ORIGIN. Приложение живёт на одном origin, сторонних встраиваний нет.

Заголовки. Content-Security-Policy: default-src 'self'; img-src 'self' data:; frame-ancestors 'none'; base-uri 'none'; form-action 'self'. Никаких inline-скриптов и inline-стилей — CSP их запрещает, и это правило для клиентского кода. Referrer-Policy: no-referrer, X-Content-Type-Options: nosniff, HSTS на nginx.

Лимиты. Token bucket в памяти сервера:

  • регистрация — 5 в час на IP;
  • вход — 10 за 10 минут на пару IP+ник;
  • сообщения — 30 в минуту на пользователя, пакет 10;
  • остальные изменяющие запросы — 60 в минуту на пользователя. Превышение — 429 с Retry-After. IP берётся из X-Real-IP, только если соединение с 127.0.0.1 (nginx, ADR-022).

Размеры. Тело запроса — до 32 КиБ, текст сообщения — до 4000 символов, имя комнаты — до 64, ник — до 32. Имя комнаты вдобавок не бывает пустым, из одних пробелов, с управляющими символами и с переопределениями направления письма (U+202A…U+202E, U+2066…U+2069): с этапа 4 оно уходит в заголовок системного уведомления (ADR-045), а там перевод строки и разворот текста выдают чужое имя за сообщение системы.

Следствия

  • Сторонний сайт не может ни отправить сообщение, ни выйти из аккаунта от имени пользователя.
  • Лимиты живут в памяти: рестарт их обнуляет. Для маленького сервера это приемлемо.
  • 90-дневный вход без продления — раз в квартал пароль вводится заново на каждом устройстве.