Этап 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
This commit is contained in:
2026-08-23 06:22:52 +03:00
co-authored by Claude Opus 5
parent 0c878477d2
commit db45978b16
45 changed files with 1522 additions and 282 deletions
+19 -4
View File
@@ -7,13 +7,15 @@
export const MAX_ACK = 500;
// ApiError — ответ сервера с кодом из перечня docs/protocol.md.
// retryAfter — сколько секунд просит ждать 429; у остальных ответов null.
export class ApiError extends Error {
constructor(code, message, status, field) {
constructor(code, message, status, field, retryAfter = null) {
super(message || code);
this.name = "ApiError";
this.code = code;
this.status = status;
this.field = field;
this.retryAfter = retryAfter;
}
}
@@ -96,7 +98,19 @@ async function request(method, path, body, { quiet = false, device = null } = {}
if (code === "unauthenticated" && !quiet) {
expired();
}
throw new ApiError(code, data?.message, response.status, data?.field);
throw new ApiError(code, data?.message, response.status, data?.field, retryAfter(response));
}
// retryAfter — сколько сервер просит ждать: целые секунды, не меньше одной
// (docs/protocol.md, «Общие правила»). Заголовка нет или он не число —
// null: паузу выбирает клиент.
function retryAfter(response) {
const raw = response.headers.get("Retry-After");
if (raw === null) {
return null;
}
const seconds = Number(raw);
return Number.isInteger(seconds) && seconds > 0 ? seconds : null;
}
export function config() {
@@ -194,8 +208,9 @@ export function removeContact(nick) {
// --- комнаты -----------------------------------------------------------
// rooms — комнаты, где мы участники, каждая с нашим текущим завёрнутым
// ключом (docs/protocol.md, «Комнаты»).
// rooms — комнаты, где мы участники, каждая с нашими завёрнутыми ключами:
// сервер отдаёт все, которые ещё держит, от старого к новому (ADR-059,
// docs/protocol.md, «Комнаты»).
export function rooms() {
return request("GET", "/api/rooms");
}