Add signed, encrypted recovery archives with revision checks, account-certified device enrollment and key rotation, and historical signer lookup. Include the database migration, API endpoints, tests, and updated E2EE documentation.
18 KiB
E2EE: автоматическое доверие, ротация и перенос истории
Поведение для пользователя
После входа актуальный клиент автоматически создаёт ключи, публикует только публичные данные и регистрирует устройство. После добавления друга или вступления в группу сообщения и файлы шифруются без диалогов сверки ключей или состава чата. На новом физическом устройстве нужно один раз ввести код с доверенного устройства (Настройки → Перенос истории / резервный код) либо сохранённый резервный код. После этого клиент скачивает зашифрованный архив и расшифровывает прежние сообщения и ключи вложений. Передача кода выполняется пользователем между своими устройствами; отдельного протокола 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, отпечаток устройства, поколение и предыдущий отпечаток с этим ключом аккаунта. Новое устройство или ротация с тем же ключом аккаунта не требуют ручной сверки. Подмена уже известного ключа аккаунта блокирует отправку и отображение новых неподтверждённых данных. Автоматического сброса доверия нет; безопасный UX намеренной замены ключа аккаунта — отдельная будущая функция.
Первая встреча доверяет каталогу сервера. Прозрачности ключей нет. Состав группы и право вступления по-прежнему сообщает сервер; состав не подписывается участниками. Злонамеренный сервер способен подставить ключ при первой встрече или добавить своего участника в группу. Удаление прежних диалогов сверки изменяет модель доверия; эта версия не даёт полной защиты от активного злонамеренного сервера. Для такой гарантии нужен отдельный протокол аутентификации состава групп и прозрачности аккаунтов; для FS/PCS — проверенная реализация ratchet/MLS. Не следует позиционировать эту реализацию как эквивалент Signal.
Ротация
Клиент проверяет возраст текущего RSA-ключа при использовании E2EE. Через семь суток активности создаётся новый RSA-3072; ключ подписи устройства остаётся прежним. У офлайн-устройства ротация происходит при следующем обращении к E2EE.
- Новый ключ записывается в локальный журнал pending.
- Старый и новый ключи включаются в зашифрованный архив, который сохраняется сервером.
- Ключ аккаунта подписывает сертификат следующего поколения с предыдущим отпечатком.
- Сервер проверяет владельца, сертификат, последовательность поколений и меняет публичный RSA-ключ. Старый ключ исключается из будущих конвертов.
- Клиент активирует сохранённый ключ и завершает журнал. При сбое повторяет тот же ключ, а не генерирует ещё одно поколение.
Ключ содержимого 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. Истёкшие, но не отозванные сертифицированные сессии остаются получателями для офлайн-доставки. После настройки архива аккаунта его старые несертифицированные сессии исключаются из новых получателей до обновления этих устройств. Клиент не отправляет сообщения участникам без сертификата аккаунта.
Обновление существующих установок
- Применить миграцию
20261024084524_E2eeRecoveryAndRotationдо обновления клиентов. Сервер и клиенты должны обновляться согласованно. Старые клиенты не умеют сертифицировать устройства аккаунта с настроенным восстановлением. - Открыть обновлённый клиент на устройстве, где ещё есть прежние ключи. Они входят в архив до публикации нового ключа; сохранить предложенный резервный код.
- На остальных устройствах ввести этот код и синхронизировать историю. Каждое старое устройство с уникальными, ещё не выгруженными ключами должно обновиться хотя бы один раз: отсутствующие приватные ключи сервер восстановить не может.
- Перед использованием с реальными данными проверить новый вход, восстановление, файлы, редактирование, группу, отзыв устройства и бан на физических устройствах.
Для проверки подписей старых 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, MLS RFC 9420.