mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
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:
+21
-14
@@ -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. Перед использованием с реальными данными проверить новый вход, восстановление,
|
||||
|
||||
@@ -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).
|
||||
Reference in New Issue
Block a user