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.
This commit is contained in:
Artemy
2026-10-24 22:19:08 +07:00
parent 55cc9538f7
commit a3401ceedf
29 changed files with 4322 additions and 36 deletions
+21 -14
View File
@@ -5,11 +5,12 @@
После входа актуальный клиент автоматически создаёт ключи, публикует только
публичные данные и регистрирует устройство. После добавления друга или вступления
в группу сообщения и файлы шифруются без диалогов сверки ключей или состава чата.
На новом физическом устройстве нужно один раз ввести код с доверенного устройства
(Настройки → Перенос истории / резервный код) либо сохранённый резервный код.
После этого клиент скачивает зашифрованный архив и расшифровывает прежние сообщения
и ключи вложений. Передача кода выполняется пользователем между своими устройствами;
отдельного протокола QR-сопряжения или удалённого одобрения устройства пока нет.
На новом физическом устройстве обычный вход восстанавливает историю по паролю,
если парольная копия ключа уже настроена. Для прежнего архива без такой копии
нужен код с доверенного устройства (Настройки → Перенос истории / резервный код)
либо сохранённый резервный код. После восстановления копия настраивается автоматически.
Подробные сценарии входа, смены/сброса пароля и команды запуска описаны в
[password-recovery.md](password-recovery.md). QR-сопряжения пока нет.
Это расширение существующего протокола JOSE, **не реализация Signal/MLS**.
Ротация ограничивает использование отдельного украденного ключа шифрования после
@@ -31,8 +32,9 @@ forward secrecy или post-compromise security. Восстанавливаем
MAUI SecureStorage хранит приватные ключи устройств, резервный код, ключ аккаунта,
архив ключей расшифровки и отпечатки известных аккаунтов. Область хранения разделена
по адресу сервера и пользователю. Пароль аккаунта сам по себе не восстанавливает
историю. При потере всех устройств и резервного кода восстановление невозможно.
по адресу сервера и пользователю. Производный парольный ключ открывает отдельную
зашифрованную копию резервного кода. Потеря прежнего пароля, всех устройств и кода
делает старую историю невосстановимой; явный сброс позволяет начать с новыми ключами.
Сервер хранит публичные ключи, сертификаты, номера поколений и зашифрованный архив.
В архив входят приватный ключ аккаунта, прежние RSA-ключи расшифровки с публичными
@@ -46,8 +48,9 @@ MAUI SecureStorage хранит приватные ключи устройств
связывает UserId, SessionId, отпечаток устройства, поколение и предыдущий отпечаток
с этим ключом аккаунта. Новое устройство или ротация с тем же ключом аккаунта
не требуют ручной сверки. Подмена уже известного ключа аккаунта блокирует отправку
и отображение новых неподтверждённых данных. Автоматического сброса доверия нет;
безопасный UX намеренной замены ключа аккаунта — отдельная будущая функция.
и отображение новых неподтверждённых данных. Явный сброс после потери доступа
публикует серверный журнал замены корневого ключа; клиент уведомляет собеседника
при первом использовании нового ключа. Журнал является частью доверия серверу.
**Первая встреча доверяет каталогу сервера.** Прозрачности ключей нет. Состав группы
и право вступления по-прежнему сообщает сервер; состав не подписывается участниками.
@@ -80,8 +83,8 @@ MAUI SecureStorage хранит приватные ключи устройств
Отзыв сессии исключает её из новых получателей, но не отзывает уже прочитанное,
украденные секреты или ранее выгруженный архив. Резервный код и ключ аккаунта пока
не ротируются автоматически. После компрометации всего устройства недостаточно
обычной недельной ротации RSA; это требует отдельной процедуры восстановления
доверия, отзыва сессий и замены секретов аккаунта.
обычной недельной ротации RSA; в настройках есть отдельный явный сброс ключей
аккаунта и кода с отзывом остальных сессий. Он не отменяет уже раскрытые данные.
## Архив и несколько устройств
@@ -91,7 +94,8 @@ IdentityKey и шифротекст. Внутри JWE также проверя
Обновление использует compare-and-swap по Revision. При конфликте клиент скачивает
актуальную версию, объединяет ключи и известные аккаунты, затем повторяет запись
(не более четырёх попыток). Ключ аккаунта на сервере неизменяем. Известная локально
(не более четырёх попыток). Обычный маршрут архива не меняет ключ аккаунта;
для этого требуется отдельный сброс со свежим доказательством пароля. Известная локально
версия запрещает откат архива; новое устройство без сохранённого номера версии
не способно доказать полноту истории при сокрытии последнего архива сервером.
Обычная синхронизация выполняется не чаще раза в минуту, а регистрация нового
@@ -122,12 +126,15 @@ IdentityKey и шифротекст. Внутри JWE также проверя
## Обновление существующих установок
1. Применить миграцию `20261024084524_E2eeRecoveryAndRotation` до обновления клиентов.
1. Применить миграции `20261024084524_E2eeRecoveryAndRotation` и
`20261024105815_PasswordBasedRecovery`, `20261024114709_PreserveResetSigners`
до обновления клиентов.
Сервер и клиенты должны обновляться согласованно. Старые клиенты не умеют
сертифицировать устройства аккаунта с настроенным восстановлением.
2. Открыть обновлённый клиент на устройстве, где ещё есть прежние ключи. Они входят
в архив до публикации нового ключа; сохранить предложенный резервный код.
3. На остальных устройствах ввести этот код и синхронизировать историю. Каждое
3. Выполнить обновлённый вход на устройстве с ключами для создания парольной копии.
На остальных устройствах войти по паролю; пока копии нет, нужен прежний код. Каждое
старое устройство с уникальными, ещё не выгруженными ключами должно обновиться
хотя бы один раз: отсутствующие приватные ключи сервер восстановить не может.
4. Перед использованием с реальными данными проверить новый вход, восстановление,