Files
Artemy a3401ceedf Add SRP password recovery and E2EE reset
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.
2026-10-24 22:19:08 +07:00

18 KiB

E2EE: автоматическое доверие, ротация и перенос истории

Поведение для пользователя

После входа актуальный клиент автоматически создаёт ключи, публикует только публичные данные и регистрирует устройство. После добавления друга или вступления в группу сообщения и файлы шифруются без диалогов сверки ключей или состава чата. На новом физическом устройстве обычный вход восстанавливает историю по паролю, если парольная копия ключа уже настроена. Для прежнего архива без такой копии нужен код с доверенного устройства (Настройки → Перенос истории / резервный код) либо сохранённый резервный код. После восстановления копия настраивается автоматически. Подробные сценарии входа, смены/сброса пароля и команды запуска описаны в 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, MLS RFC 9420.