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. Перед использованием с реальными данными проверить новый вход, восстановление,
+147
View File
@@ -0,0 +1,147 @@
# Вход по паролю и восстановление E2EE
## Пользовательские сценарии
Регистрация остаётся на экране регистрации и использует единственный
`POST /api/auth/register` в `AuthController`. Отдельного контроллера регистрации нет.
Новый клиент передаёт SRP salt/identity/verifier вместо открытого пароля.
Существующие проверки имени, приглашения и обязательного канала сохранены.
После настройки парольной копии ключа обычный вход на новом устройстве восстанавливает
зашифрованный архив истории автоматически. Пароль не хранится и не передаётся серверу
новым методом входа. Локально в SecureStorage сохраняется производный ключ архива.
Резервный код остаётся дополнительным способом переноса и восстановления.
В настройках доступны:
- **Сменить пароль с сохранением истории**: подтверждение прежнего пароля, новый
пароль с повтором, перешифрование копии кода; ключ аккаунта и история сохраняются.
Другие сессии и их push-токены отзываются.
- **Начать общение с новыми ключами**: подтверждение потери истории и текущего пароля;
создаются новый ключ аккаунта, код и ключи устройства, другие сессии отзываются.
Собеседник получает уведомление при первой обработке нового ключа. Сверять ключи
вручную не нужно. Необъявленная подмена закреплённого ключа по-прежнему блокируется.
Если забыт пароль, администратор может сбросить доступ к аккаунту, но этим не
расшифровывает старую историю. После входа с выданным паролем пользователь задаёт
новый пароль и восстанавливает прежний архив резервным кодом/с доверенного устройства.
Без прежнего пароля, кода и доступного устройства старую историю восстановить нельзя;
можно явно начать общение с новыми ключами. Уже полученная собеседниками история
современных сертифицированных сообщений у них сохраняется.
## Переход со старого входа
Старый bcrypt-аккаунт один раз требует выбрать **другой** пароль. Только в этой
явной процедуре старый пароль проверяется прежним серверным методом; новый пароль
в сеть не отправляется. Сервер проверяет различие паролей, а не только UI.
Если на сервере уже был архив без парольной копии, для первого восстановления
всё ещё нужен прежний код либо устройство с ключами. Неизвестные секреты сервер
не может создать задним числом. Старая refresh-сессия без нового входа также не
имеет производного парольного ключа.
Клиент запоминает успешный SRP-вход для адреса сервера и имени. Если сервер позже
предлагает старый вход, автоматической отправки пароля не происходит. На экране
появляется действие «Продолжить после сброса пароля» только после такой ошибки.
Обычная ссылка «Зарегистрируйтесь!» остаётся на месте. Первый вход с чистого
устройства всё ещё доверяет настоящему серверу и HTTPS, включая предложение миграции.
## Протокол и хранение
Используется SRP-6a из `srp` 1.0.7 / srp.net, группа 4096 бит и SHA-512.
Это не OPAQUE и не независимо проверенная реализация всего прикладного протокола.
PBKDF2-SHA256 (600 000 итераций, случайная соль 32 байта) и отдельные контексты
HKDF-SHA256 дают секрет аутентификации и ключ парольной копии. Они не совпадают;
восстановление не использует общий сеансовый SRP-ключ.
Случайный резервный код шифрует основной архив. Парольный ключ шифрует копию кода
в JWE dir/A256GCM. Подпись ключа аккаунта связывает её с владельцем, текущими SRP
параметрами и версией учётных данных. Изменение пароля атомарно меняет verifier
и эту копию. Сброс забытого пароля очищает парольную копию, сохраняя основной архив.
В БД нет открытого пароля, кода или приватного ключа аккаунта. Однако кража БД
позволяет подбирать слабые пароли офлайн; восстановление по паролю зависит от
его стойкости. Получив пароль и архив, атакующий получает доступ к истории.
Challenge и подтверждения действий одноразовые, действуют две минуты; подтверждения
смены пароля/сброса связаны с пользователем, сессией и назначением. Изменение версии
учётных данных инвалидирует начатые доказательства. На клиенте журналы смены пароля
и сброса ключей позволяют проверить серверный результат после потери ответа до
замены локальных секретов. Старый пароль при нормальном входе не отправляется.
Замена ключа аккаунта публикуется в журнале `E2eeIdentityChanges` с последовательным
epoch. Журнал доступен самому аккаунту и собеседникам с доступом к переписке;
участник группы может проверить автора сохранённых сообщений после его выхода.
Сервер авторизует сброс по свежему доказательству пароля, а не по подписи утраченного
ключа. Это явная часть доверия серверу, не криптографическое доказательство
непрерывности старого ключа. Исторические сертифицированные сообщения до сброса
принимаются без отката текущего закреплённого ключа.
Публичный сертификат прежнего ключа текущей сессии сохраняется отдельно в журнале
сброса: он нужен для проверки v1-сообщений, в которых ещё нет сертификата внутри.
Запрос исторического автора принимает `identityKey` и проверяет доступ к чату;
архивный сертификат не становится получателем новых сообщений и не возобновляет сессию.
Хранилище challenge пока находится в памяти процесса (лимит 1024). Для нескольких
экземпляров нужны маршрутизация всего обмена на один экземпляр либо распределённое
одноразовое хранилище. Лимит регистрации, входа и доказательств действий —
30 запросов/минуту на RemoteIpAddress; фоновое чтение парольной копии в него не входит.
За reverse proxy необходимо настроить доверенные forwarded headers и подходящие
лимиты. HTTPS обязателен. Криптографический аудит и нагрузочная проверка нужны
перед публичным выпуском. Ограничения FS/PCS и доверия группам из [e2ee.md](e2ee.md)
сохраняются; парольное восстановление их не устраняет.
## API
Все маршруты находятся в `AuthController`. Регистрация и challenge/login анонимные;
остальные требуют access token и определяют владельца из JWT.
| Метод | Маршрут | Назначение |
| --- | --- | --- |
| POST | /api/auth/register | Единая регистрация: SRP либо совместимый старый формат |
| POST | /api/auth/password/challenge | Начать вход |
| POST | /api/auth/password/login | Проверить доказательство; токены и серверное доказательство |
| GET | /api/auth/password | Собственные параметры и зашифрованная копия кода |
| PUT | /api/auth/password/enrollment | Однократное обновление старого входа |
| PUT | /api/auth/password/recovery | Создать подписанную парольную копию кода |
| POST | /api/auth/password/{change\|reset}/challenge | Начать подтверждение действия |
| POST | /api/auth/password/{change\|reset}/authorize | Получить одноразовое разрешение |
| POST | /api/auth/password/change | Атомарная смена пароля с сохранением архива |
| POST | /api/auth/password/reset-encryption | Явный сброс ключей, новый архив и запись журнала |
| GET | /api/e2ee/identities/{userId}/changes | История смены ключа доступного собеседника |
## Локальная проверка
Из корня серверного репозитория, с запущенной отдельной локальной PostgreSQL
и созданной БД `govor_dev` (подставьте собственные реквизиты):
```powershell
$env:ASPNETCORE_ENVIRONMENT = 'Development'
$env:ConnectionStrings__GovorDbContext = 'Host=127.0.0.1;Port=5432;Database=govor_dev;Username=postgres;Password=YOUR_LOCAL_PASSWORD'
$env:Firebase__Enabled = 'false'
dotnet restore Govor.API/Govor.API.csproj
dotnet run --project Govor.API/Govor.API.csproj --no-launch-profile -- --migrate-only
dotnet run --project Govor.API/Govor.API.csproj --launch-profile http
```
Первый `run` применяет все миграции и завершается; второй запускает API на
`http://localhost:7155`. HTTP предназначен для локальной проверки. Для проверки
на устройстве настройте доступный устройству адрес и HTTPS.
Новые миграции — `20261024105815_PasswordBasedRecovery` и
`20261024114709_PreserveResetSigners`, после `20261024084524_E2eeRecoveryAndRotation`.
Пользовательская БД агентом не обновлялась.
Проверить регистрацию, повторный вход с чистым SecureStorage без ввода кода,
смену пароля и вход новым паролем, восстановление кодом после административного
сброса, явный сброс ключей и уведомление на втором аккаунте. Отдельно проверить
потерю ответа при смене пароля/сбросе и повторный запуск клиента.
```powershell
dotnet test Govor.Server.slnx
# Из корня мобильного репозитория:
dotnet test Govor.Mobile.Tests/Govor.Mobile.Tests.csproj
dotnet build Govor.Mobile/Govor.Mobile.csproj -f net10.0-android -p:TargetFrameworks=net10.0-android
```
Общие `PasswordProtocol` и `E2eeRecoveryProtocol` в двух репозиториях должны
совпадать за исключением namespace. Источники SRP:
[srp.net](https://github.com/secure-remote-password/srp.net),
[пакет srp](https://www.nuget.org/packages/srp/1.0.7).