Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
4.8 KiB
Устройства, ключи и архивы — HTTP API
Все маршруты /api/e2ee требуют access token, роль User/Admin и активную сессию. type: 0 — PrivateChat, 1 — ChatGroup. Приватные ключи устройства, пароль и резервный код серверу не передаются. Модель доверия и жизненный цикл.
Маршруты
| Метод | Маршрут | Результат |
|---|---|---|
| PUT | /api/e2ee/device |
Регистрация/ротация ключа текущей сессии; { registered: true } |
| GET | /api/e2ee/devices |
Собственные устройства |
| PUT | /api/e2ee/devices/certificate |
Сертификация исторического устройства; { certified: true } |
| GET | /api/e2ee/conversations/{type}/{conversationId}/keys |
ConversationKeys для доступного чата |
| GET | /api/e2ee/conversations/{type}/{conversationId}/signers/{deviceSession}?identityKey=... |
Исторический подписант; 404, если не найден |
| GET | /api/e2ee/recovery |
RecoveryState: { vault: ... }, без архива vault: null |
| PUT | /api/e2ee/recovery |
Сохранение подписанного архива с ожидаемой ревизией |
| GET | /api/e2ee/identities/{userId}/changes |
Журнал явной смены корневого ключа |
Контракты
DeviceKey: userId, sessionId, identityKey, encryptionKey, signature, accountIdentityKey, accountSignature, generation, previousFingerprint. fingerprint вычисляется из публичных ключей. Идентификаторы обязаны совпасть с владельцем JWT и текущей сессией.
ConversationKeys: conversationId, recipientType, members (ID пользователей), devices (DeviceKey). Не путайте список участников с устройствами: у одного пользователя может быть несколько устройств. Лимит — 500 устройств на чат. Истёкшая, но не отозванная сертифицированная сессия может оставаться получателем офлайн-сообщений; для авторизации команд срок сессии всё равно проверяется.
SaveRecoveryVault: expectedRevision, identityKey, ciphertext, signature. RecoveryVault: userId, revision, identityKey, ciphertext, signature. Предел ciphertext архива — 4 000 000 символов, HTTP-запроса сохранения — 4 100 000 байт.
При конфликте ревизии перечитайте архив, расшифруйте и объедините ключи локально, затем подпишите следующую версию. Простая замена expectedRevision без объединения может потерять историю другого устройства.
Ошибки и повторы
400: неверный тип/контекст, ключи, подпись или данные архива.403: нет доступа к чату, чужая сессия/устройство или неподходящий ключ аккаунта.404: не найден исторический подписант.409: изменилось поколение/ревизия либо не у всех участников есть подходящие ключи.
Перед отправкой получите каталог устройств, зашифруйте сообщение всем получателям и подпишите. При E2EE_DEVICES_CHANGED перечитайте каталог и создайте согласованный конверт; не переходите на plaintext. Для личных и приватных чатов сервер требует E2EE; публичные группы допускают старый формат, хотя актуальный клиент шифрует и их.
Точный формат JOSE, подписи и кодирование заданы в E2eeProtocol.cs и E2eeRecoveryProtocol.cs. HTTP camelCase не означает, что можно переименовывать поля внутри подписанного JOSE-содержимого.