Files
Govor/docs/endpoints/session-keys.md
T
Artemy 632ac04b56 Add forwarding, friend controls, and benefits
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.
2026-10-31 18:29:40 +07:00

2.0 KiB

Старый API prekeys

Эти маршруты сохранены для совместимости и отличаются от действующего API E2EE устройств. Они сами по себе не реализуют Signal Protocol, ratchet или архив истории.

Требуются HTTPS, access token и роль User/Admin.

Метод Маршрут Назначение
POST /api/session/keys Привязать ключи текущей сессии
GET /api/session/users/{userId}/keys Публичные ключи друга
POST /api/session/keys/rotate Пополнить одноразовые ключи
GET /api/session/keys/remaining { remaining }
POST /api/session/keys/{preKeyId}/used Пометить собственный ключ использованным

byte[] передаются в JSON как Base64. UploadKeysRequest: identityKey, signedPreKey, signedPreKeySignature, oneTimePreKeys. За upload или rotate допускается до 100 новых prekeys. Rotate получает newOneTimePreKeys.

Сервис проверяет владельца сессии; повторная привязка запрещена. Reader возвращает публичные DTO со signedPreKey и неиспользованными oneTimePreKeys, без внутренних данных UserSession. Конструктор rotator исправлен; прежняя ошибка null больше не описывает текущий сервер.

used относится к сессии владельца, а не к атомарной выдаче ключа произвольному собеседнику. Не стройте новый E2EE-клиент на предположении, что это законченный протокол одноразового обмена. За reverse proxy учитывайте RequireHttps и forwarded headers.