mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
a3401ceedf
Add proof-based password registration, login, enrollment, and change flows, with rate limiting and encrypted recovery-key envelopes. Support explicit E2EE identity resets while preserving historical signer verification, and document and test the new recovery workflows.
169 lines
18 KiB
Markdown
169 lines
18 KiB
Markdown
# E2EE: автоматическое доверие, ротация и перенос истории
|
|
|
|
## Поведение для пользователя
|
|
|
|
После входа актуальный клиент автоматически создаёт ключи, публикует только
|
|
публичные данные и регистрирует устройство. После добавления друга или вступления
|
|
в группу сообщения и файлы шифруются без диалогов сверки ключей или состава чата.
|
|
На новом физическом устройстве обычный вход восстанавливает историю по паролю,
|
|
если парольная копия ключа уже настроена. Для прежнего архива без такой копии
|
|
нужен код с доверенного устройства (Настройки → Перенос истории / резервный код)
|
|
либо сохранённый резервный код. После восстановления копия настраивается автоматически.
|
|
Подробные сценарии входа, смены/сброса пароля и команды запуска описаны в
|
|
[password-recovery.md](password-recovery.md). QR-сопряжения пока нет.
|
|
|
|
Это расширение существующего протокола JOSE, **не реализация Signal/MLS**.
|
|
Ротация ограничивает использование отдельного украденного ключа шифрования после
|
|
его замены. Она не устраняет компрометацию работающего устройства и не обеспечивает
|
|
forward secrecy или post-compromise security. Восстанавливаемый архив намеренно
|
|
сохраняет возможность расшифровки истории. Кража резервного кода вместе с доступом
|
|
к архиву раскрывает эту историю и ключ доверия аккаунта.
|
|
|
|
## Три вида ключей
|
|
|
|
- Ключ аккаунта: ECDSA P-256, единый для устройств. Подписывает сертификаты
|
|
устройств и архив; его публичный отпечаток доступен в настройках.
|
|
- Ключи сессии устройства: ECDSA P-256 для сообщений и RSA-3072 для получения
|
|
случайного ключа содержимого. Ключ подписи каждого устройства остаётся локальным
|
|
и не экспортируется в архив. Используется существующий идентификатор UserSession,
|
|
отдельного постоянного идентификатора физического устройства пока нет.
|
|
- Резервный код: случайные 256 бит в Base64URL. Шифрует архив JWE dir/A256GCM;
|
|
код не передаётся серверу и не выводится из пароля входа.
|
|
|
|
MAUI SecureStorage хранит приватные ключи устройств, резервный код, ключ аккаунта,
|
|
архив ключей расшифровки и отпечатки известных аккаунтов. Область хранения разделена
|
|
по адресу сервера и пользователю. Производный парольный ключ открывает отдельную
|
|
зашифрованную копию резервного кода. Потеря прежнего пароля, всех устройств и кода
|
|
делает старую историю невосстановимой; явный сброс позволяет начать с новыми ключами.
|
|
|
|
Сервер хранит публичные ключи, сертификаты, номера поколений и зашифрованный архив.
|
|
В архив входят приватный ключ аккаунта, прежние RSA-ключи расшифровки с публичными
|
|
ключами подписи для вычисления отпечатков и известные ключи аккаунтов собеседников.
|
|
Приватные ключи подписи устройств в архив не входят. Ключи/имена/MIME вложений
|
|
восстанавливаются из содержимого расшифрованных сообщений.
|
|
|
|
## Автоматическое доверие
|
|
|
|
Первый ключ аккаунта собеседника запоминается автоматически (TOFU). Сертификат
|
|
связывает UserId, SessionId, отпечаток устройства, поколение и предыдущий отпечаток
|
|
с этим ключом аккаунта. Новое устройство или ротация с тем же ключом аккаунта
|
|
не требуют ручной сверки. Подмена уже известного ключа аккаунта блокирует отправку
|
|
и отображение новых неподтверждённых данных. Явный сброс после потери доступа
|
|
публикует серверный журнал замены корневого ключа; клиент уведомляет собеседника
|
|
при первом использовании нового ключа. Журнал является частью доверия серверу.
|
|
|
|
**Первая встреча доверяет каталогу сервера.** Прозрачности ключей нет. Состав группы
|
|
и право вступления по-прежнему сообщает сервер; состав не подписывается участниками.
|
|
Злонамеренный сервер способен подставить ключ при первой встрече или добавить
|
|
своего участника в группу. Удаление прежних диалогов сверки изменяет модель доверия;
|
|
эта версия не даёт полной защиты от активного злонамеренного сервера.
|
|
Для такой гарантии нужен отдельный протокол аутентификации состава групп
|
|
и прозрачности аккаунтов; для FS/PCS — проверенная реализация ratchet/MLS.
|
|
Не следует позиционировать эту реализацию как эквивалент Signal.
|
|
|
|
## Ротация
|
|
|
|
Клиент проверяет возраст текущего RSA-ключа при использовании E2EE. Через семь суток
|
|
активности создаётся новый RSA-3072; ключ подписи устройства остаётся прежним.
|
|
У офлайн-устройства ротация происходит при следующем обращении к E2EE.
|
|
|
|
1. Новый ключ записывается в локальный журнал pending.
|
|
2. Старый и новый ключи включаются в зашифрованный архив, который сохраняется сервером.
|
|
3. Ключ аккаунта подписывает сертификат следующего поколения с предыдущим отпечатком.
|
|
4. Сервер проверяет владельца, сертификат, последовательность поколений и меняет
|
|
публичный RSA-ключ. Старый ключ исключается из будущих конвертов.
|
|
5. Клиент активирует сохранённый ключ и завершает журнал. При сбое повторяет тот же
|
|
ключ, а не генерирует ещё одно поколение.
|
|
|
|
Ключ содержимого AES-256-GCM новый у каждого сообщения; у каждого вложения также
|
|
свой случайный ключ и nonce. Новые личные сообщения и сообщения приватных групп
|
|
требуют E2EE на сервере. Клиент шифрует также публичные группы; сервер сохраняет
|
|
прежнюю совместимость с открытыми сообщениями публичных групп.
|
|
|
|
Отзыв сессии исключает её из новых получателей, но не отзывает уже прочитанное,
|
|
украденные секреты или ранее выгруженный архив. Резервный код и ключ аккаунта пока
|
|
не ротируются автоматически. После компрометации всего устройства недостаточно
|
|
обычной недельной ротации RSA; в настройках есть отдельный явный сброс ключей
|
|
аккаунта и кода с отзывом остальных сессий. Он не отменяет уже раскрытые данные.
|
|
|
|
## Архив и несколько устройств
|
|
|
|
Каждая версия архива подписана ключом аккаунта; подпись связывает UserId, Revision,
|
|
IdentityKey и шифротекст. Внутри JWE также проверяются владелец и версия. Алгоритмы
|
|
зафиксированы; сервер проверяет публичную подпись, не расшифровывая содержимое.
|
|
|
|
Обновление использует compare-and-swap по Revision. При конфликте клиент скачивает
|
|
актуальную версию, объединяет ключи и известные аккаунты, затем повторяет запись
|
|
(не более четырёх попыток). Обычный маршрут архива не меняет ключ аккаунта;
|
|
для этого требуется отдельный сброс со свежим доказательством пароля. Известная локально
|
|
версия запрещает откат архива; новое устройство без сохранённого номера версии
|
|
не способно доказать полноту истории при сокрытии последнего архива сервером.
|
|
Обычная синхронизация выполняется не чаще раза в минуту, а регистрация нового
|
|
ключа, ротация, запрос кода и отсутствие ключа истории вызывают немедленную синхронизацию.
|
|
|
|
Архив ограничен 4 000 000 символов JWE; имеются пределы 1500 ключей и 10 000
|
|
закреплённых аккаунтов. При исчерпании лимита запись/ротация останавливаются;
|
|
молчаливого удаления ключей истории нет. Сегментированный архив не реализован.
|
|
|
|
## HTTP API
|
|
|
|
Все маршруты требуют действующую авторизацию; пользователь определяется из JWT. HTTPS обязателен для защиты авторизации и первоначального обмена публичными ключами.
|
|
|
|
| Метод и маршрут | Назначение |
|
|
| --- | --- |
|
|
| PUT /api/e2ee/device | Регистрация/идемпотентный повтор/последовательная подписанная ротация текущей сессии |
|
|
| GET /api/e2ee/recovery | Архив только текущего аккаунта; { vault: null } до первой настройки |
|
|
| PUT /api/e2ee/recovery | ExpectedRevision, IdentityKey, Ciphertext, Signature; 409 при конфликте |
|
|
| GET /api/e2ee/devices | Публичные ключи всех собственных сессий, включая отозванные, для миграции истории |
|
|
| PUT /api/e2ee/devices/certificate | Добавление сертификата аккаунта к собственному историческому ключу; не меняет ключ и не возобновляет сессию |
|
|
| GET /api/e2ee/conversations/{type}/{id}/keys | Участники и неотозванные устройства чата, с проверкой доступа |
|
|
| GET /api/e2ee/conversations/{type}/{id}/signers/{session} | Сертификат исторического автора в доступном чате; проверяется наличие сообщения автора |
|
|
|
|
Нельзя зачислить новое устройство аккаунта с архивом без сертификата его ключа
|
|
аккаунта. Нельзя использовать сертификат для другого пользователя/сессии или
|
|
пропустить поколение. Изменение поколения использует EF concurrency token.
|
|
Истёкшие, но не отозванные сертифицированные сессии остаются получателями для офлайн-доставки. После настройки архива аккаунта его старые несертифицированные сессии исключаются из новых получателей до обновления этих устройств. Клиент не отправляет сообщения участникам без сертификата аккаунта.
|
|
|
|
## Обновление существующих установок
|
|
|
|
1. Применить миграции `20261024084524_E2eeRecoveryAndRotation` и
|
|
`20261024105815_PasswordBasedRecovery`, `20261024114709_PreserveResetSigners`
|
|
до обновления клиентов.
|
|
Сервер и клиенты должны обновляться согласованно. Старые клиенты не умеют
|
|
сертифицировать устройства аккаунта с настроенным восстановлением.
|
|
2. Открыть обновлённый клиент на устройстве, где ещё есть прежние ключи. Они входят
|
|
в архив до публикации нового ключа; сохранить предложенный резервный код.
|
|
3. Выполнить обновлённый вход на устройстве с ключами для создания парольной копии.
|
|
На остальных устройствах войти по паролю; пока копии нет, нужен прежний код. Каждое
|
|
старое устройство с уникальными, ещё не выгруженными ключами должно обновиться
|
|
хотя бы один раз: отсутствующие приватные ключи сервер восстановить не может.
|
|
4. Перед использованием с реальными данными проверить новый вход, восстановление,
|
|
файлы, редактирование, группу, отзыв устройства и бан на физических устройствах.
|
|
|
|
Для проверки подписей старых v1-сообщений клиент сертифицирует только те исторические
|
|
ключи, приватные ключи расшифровки которых уже есть в его локальном/восстановленном
|
|
архиве. Произвольные предложенные сервером старые устройства не сертифицируются.
|
|
Сертификат исторического ключа не отменяет его отзыв. Получатель связывает старую
|
|
подпись сообщения с сертификатом того же публичного ключа подписи и той же сессии.
|
|
|
|
Открытая история остаётся помеченной `[Без E2EE]` и не становится секретной задним
|
|
числом. Локальный SQLite-кэш всё ещё содержит расшифрованный текст. Метаданные,
|
|
участники, время и размеры видны серверу; аватары, реакции и профиль не включены
|
|
в зашифрованное содержимое сообщения. При неподходящем коде, подмене архива,
|
|
недостающем ключе или ошибке хранения отката на открытый текст нет.
|
|
|
|
## Проверка и источники
|
|
|
|
Сервер: `dotnet test Govor.Server.slnx`.
|
|
Мобильные алгоритмы/сервисы: `dotnet test Govor.Mobile.Tests/Govor.Mobile.Tests.csproj`.
|
|
Android: `dotnet build Govor.Mobile/Govor.Mobile.csproj -f net10.0-android -p:TargetFrameworks=net10.0-android`.
|
|
Windows CNG требует обычного пользовательского профиля для импорта приватных ключей.
|
|
Серверные и мобильные копии E2eeProtocol/E2eeRecoveryProtocol должны совпадать
|
|
за исключением namespace; тесты проверяют сообщения, сертификаты, архив, права
|
|
доступа, конфликт версий, сбой ротации и восстановление на чистом хранилище.
|
|
|
|
Перед публичным релизом необходим независимый аудит прикладного протокола и
|
|
интеграции. Спецификации для следующего этапа:
|
|
[Signal Sesame](https://signal.org/docs/specifications/sesame/),
|
|
[MLS RFC 9420](https://www.rfc-editor.org/rfc/rfc9420.html).
|