Add forwarding, friend controls, and benefits

Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
This commit is contained in:
Artemy
2026-10-31 18:29:40 +07:00
parent a3401ceedf
commit 632ac04b56
78 changed files with 5284 additions and 720 deletions
+15 -14
View File
@@ -2,25 +2,26 @@
## Последовательность
1. `POST /api/auth/register` либо `POST /api/auth/login` возвращает `{ refreshToken, accessToken }`.
2. HTTP-запросы передают `Authorization: Bearer <accessToken>`.
3. Для SignalR задайте AccessTokenProvider, который возвращает актуальный access token. Program.cs также принимает query `access_token` на путях /hubs.
4. `POST /api/auth/token/refresh` возвращает новую пару; клиент сохраняет новый refresh token.
5. Отзыв сессий выполняется методами /api/Session/close.
1. Новый клиент регистрирует SRP-параметры через `POST /api/auth/register`. Для входа использует `POST /api/auth/password/challenge`, затем `/password/login` с доказательством.
2. Проверяет серверное доказательство и сохраняет пару access/refresh. Точный формат — [регистрация и вход](authcontroller.md).
3. HTTP передаёт `Authorization: Bearer <accessToken>`. Для SignalR задаётся `AccessTokenProvider`; query `access_token` принимается только на путях `/hubs`.
4. [Refresh](refreshcontroller.md) последовательно заменяет оба токена. [Сессии](../sessioncontroller.md) позволяют отозвать отдельное устройство или все сеансы.
5. [Восстановление](../../password-recovery.md) открывает зашифрованный архив истории. Успешный вход и наличие ключей старой истории — разные состояния.
Access token содержит `userId`, `sid` и роль User/Admin. Подпись HS256 проверяется, срок проверяется, issuer и audience не проверяются. Токены возвращаются JSON; сервер не устанавливает HttpOnly-cookie.
## Токены и отзыв
## Ограничения реализации
Access JWT содержит `userId`, `sid`, `tokenType: access` и роль `User`/`Admin`. Подпись HS256 и срок проверяются; issuer/audience не проверяются. JSON-ответы не устанавливают HttpOnly-cookie. Значения по умолчанию: access 10 минут, refresh-сессия 30 дней.
Отзыв сессии блокирует refresh, но Program.cs не проверяет IsRevoked при каждом использовании access token. Уже открытые SignalR-соединения явно не разрываются. Немедленный logout на всех устройствах не гарантирован.
Bearer middleware проверяет по БД владельца `sid`, срок и отсутствие отзыва. Refresh JWT не принимается как access. SignalR-фильтр заново проверяет сессию при каждой команде и прерывает соединение при отказе. Отзыв не следует трактовать как гарантированное мгновенное физическое закрытие всех соединений: у разных хабов разная маршрутизация событий. ChatsHub направляет события активным сессиям.
Refresh JWT содержит userId и tokenType, но не случайный jti или sid. При выпуске одному пользователю в одну секунду возможны одинаковые токены, конфликтующие с уникальным RefreshTokenHash. Ротация не защищена атомарным compare-and-swap от параллельных запросов.
Refresh содержит случайный `jti`; замена хеша выполняется условным атомарным обновлением. Из двух конкурирующих запросов со старым refresh только один может заменить хеш. Это не долговременный журнал replay и не отзыв всей семьи токенов.
Не используйте refresh token как access token. В bearer-валидации нет явного требования tokenType=access; методы с одним Authorize требуют исправления разделения типов токенов.
## Старые аккаунты
На MAUI рекомендовано хранить refresh token в SecureStorage и выполнять обновление последовательно. Это рекомендация клиенту, а не свойство сервера.
`POST /api/auth/login` с открытым паролем оставлен для bcrypt-аккаунтов. После настройки SRP он возвращает `401 Auth.PasswordProofRequired`. Новый клиент не должен автоматически откатываться на старый вход; [процедура перехода](../../password-recovery.md) требует явной смены пароля.
---
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
## Ограничения и хранение
Источник: [Govor.Application/Authentication/JWT/JwtService.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Authentication/JWT/JwtService.cs).
Регистрация, старый login, SRP challenge/login и challenge/authorize действий имеют общий лимит `30 запросов/минуту` на `RemoteIpAddress`, без очереди; превышение — `429`. Challenge одноразовый и действует две минуты. Хранилище challenge находится в памяти процесса, поэтому несколько инстансов требуют отдельной схемы маршрутизации/общего хранилища.
На клиенте храните секреты в защищённом хранилище, сериализуйте refresh и сохраняйте новую пару до следующего запроса. Временная сеть/`5xx` не означает необходимость стирать ключи истории. На внешней сети обязателен HTTPS; [параметры proxy](../../configuration.md).
+39 -23
View File
@@ -1,45 +1,61 @@
# Регистрация и вход
Оба метода доступны анонимно, Content-Type: application/json.
`Content-Type: application/json`. Регистрация и методы входа анонимные, но ограничены политикой `password-auth`. Смена пароля, миграция и восстановление описаны в [отдельном руководстве](../../password-recovery.md).
## POST /api/auth/register
Для нового клиента передайте `name`, `inviteLink`, `deviceInfo` и **все три** поля `srpSalt`, `srpIdentity`, `srpVerifier`, без `password`. Параметры вычисляются клиентом по `PasswordProtocol`: SRP-6a, группа 4096 бит, SHA-512; сериализация должна точно соответствовать реализации. Не подставляйте произвольные Base64-строки вместо verifier.
Совместимый старый формат принимает `password` (минимум 8 символов) без SRP-полей. Смешанный или неполный SRP-запрос отклоняется. Новая интеграция должна реализовывать доказательство пароля, а не строиться на старом формате.
Имя: 4–44 символа, кириллица и цифры, начинается с буквы. Модерация проверяет зарезервированные имена, запрещённые совпадения/подстроки и пять одинаковых символов подряд. `deviceInfo` описывает устройство, в БД до 256 символов.
`inviteLink` — код приглашения, не URL. Генератор использует GUID в формате `N` (32 символа без дефисов). При регистрации проверяются активность, срок и лимит приглашения. Резервирование места, аккаунт, административная роль и членство в обязательном канале сохраняются транзакционно.
Успех `200`:
```json
{"refreshToken":"<refresh>","accessToken":"<access>"}
```
Открытие сессии выполняется после регистрации. Если оно не удалось, аккаунт уже мог быть создан: сначала попробуйте вход, не повторяйте регистрацию бесконечно. Конфликт имени — `409`, отсутствующее приглашение — `404`, ошибка валидации/недоступное приглашение — `400`. Ошибки сервиса используют [ProblemDetails](../../code-docs/hubresult-less-than-t-greater-than.md).
## Контракт SRP-обмена
| Шаг | JSON-поля запроса | Поля успешного ответа |
| --- | --- | --- |
| `password/challenge` | name, publicEphemeral, deviceInfo | challengeId, salt, identity, publicEphemeral, credentialVersion, legacy |
| `password/login` | challengeId, proof | refreshToken, accessToken, serverProof, credentialVersion |
publicEphemeral/proof создаёт SRP-библиотека с параметрами PasswordProtocol. salt/identity/verifier регистрации создаются PasswordProtocol.Create на стороне клиента; salt и identity — случайные значения в hex. `legacy=true` требует явного сценария перехода старого аккаунта, не автоматической отправки открытого пароля.
Пример формы новой регистрации (значения SRP нужно вычислить):
```json
{
"name": "Артём",
"password": "example-password",
"srpSalt": "<salt из PasswordProtocol.Create>",
"srpIdentity": "<identity из PasswordProtocol.Create>",
"srpVerifier": "<verifier из PasswordProtocol.Create>",
"inviteLink": "<код приглашения>",
"deviceInfo": "Android test device"
}
```
Имя: 4–44 символа, только кириллица и цифры, первый символ — буква. Модерация запрещает зарезервированные имена, совпадения/подстроки из конфигурации и пять одинаковых символов подряд. Пароль: минимум 8 символов. DeviceInfo необязателен в запросе, но в БД ограничен 256 символами.
## Вход SRP
Код создаётся как Guid.ToString("N"): 32 символа без дефисов. Поиск кода — по строковому равенству. InviteLink — код, а не URL.
1. `POST /api/auth/password/challenge` начинает обмен и возвращает серверные параметры/challenge.
2. Клиент вычисляет доказательство и отправляет `POST /api/auth/password/login`.
3. Ответ содержит токены и серверное доказательство. Клиент проверяет доказательство до принятия результата.
Проверяется существование приглашения, срок и число участников. Проверка IsActive отсутствует, лимит участников не защищён от конкурентной регистрации.
Challenge действует две минуты и расходуется один раз. Неверное/истёкшее доказательство — `401`, некорректные протокольные данные — `400`, конфликт состояния — `409`, превышение лимита — `429`. Для повторной попытки начните новый обмен.
Успех 200:
Точные DTO, правила кодирования и криптографические операции заданы в [PasswordProtocol.cs](https://github.com/stalcker2288969/Govor/blob/a3401ceedf30c2eb6167f7ef6e4ae820883d2de2/Govor.Application/Authentication/PasswordProtocol.cs) и [PasswordAccountService.cs](https://github.com/stalcker2288969/Govor/blob/a3401ceedf30c2eb6167f7ef6e4ae820883d2de2/Govor.Application/Authentication/PasswordAccountService.cs). Их следует переносить согласованно с клиентом, не реализовывать обмен по одному схематическому JSON-примеру.
```json
{"refreshToken":"<token>","accessToken":"<token>"}
```
Конфликт имени — 409; ошибки валидации — 400; отсутствующее приглашение — 404. Тело сервисных ошибок — ProblemDetails с errorCode. Регистрация и открытие сессии — отдельные сохранения: ошибка открытия сессии не откатывает созданного пользователя.
## POST /api/auth/login
## POST /api/auth/login — совместимость
```json
{"name":"Артём","password":"example-password","deviceInfo":"Android test device"}
```
Успех 200 с той же парой токенов. Пользователь не найден — 404 (UserNotRegisteredException); неверный пароль — 400 (InvalidOperationException). Это текущее поведение, а не рекомендуемая политика ошибок входа: разные ответы раскрывают существование аккаунта.
## Ограничения
Rate limiting и блокировка перебора в Program.cs не настроены. Для публичного запуска нужны единая ошибка входа, ограничение частоты и защита административных приглашений.
---
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/Authentication/AuthController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Authentication/AuthController.cs).
Для bcrypt-аккаунта успех — та же пара токенов. Неизвестное имя — `404`, неверный пароль — `400`, SRP-аккаунт — `401 Auth.PasswordProofRequired`. Различающиеся ответы старого входа позволяют определить существование имени; не переносите это поведение в пользовательские тексты ошибок.
@@ -8,29 +8,24 @@
{"refreshToken":"<последний сохранённый refresh token>"}
```
Сервис хеширует переданную строку и ищет UserSession по RefreshTokenHash. Проверяет IsRevoked и ExpiresAt, выпускает новую пару, заменяет хеш и продлевает ExpiresAt. CreatedAt также перезаписывается, поэтому после refresh это не исходная дата открытия сессии.
Сервис ищет сессию по хешу строки, проверяет отзыв и срок, создаёт новую пару и условно заменяет хеш только если старый ещё актуален. `ExpiresAt` продлевается, `CreatedAt` сохраняет исходную дату открытия сессии.
Успех 200:
Успех `200`:
```json
{"refreshToken":"<new token>","accessToken":"<new token>"}
{"refreshToken":"<new refresh>","accessToken":"<new access>"}
```
| Случай | Текущий ответ |
| Случай | Ответ |
| --- | --- |
| Пустая строка | 400, errorCode Auth.EmptyToken |
| Хеш не найден | 400, errorCode Auth.InvalidToken |
| Истекшая/отозванная сессия | 400, errorCode Auth.InvalidToken |
| Пустая строка | 400, `Auth.EmptyToken` |
| Неизвестный, истёкший или отозванный refresh | 400, `Auth.InvalidToken` |
| Сессия изменилась между чтением и условной заменой | 401, `Auth.InvalidToken` |
Не документируйте неверный refresh как гарантированный 401: текущий Error.Failure преобразуется в 400.
Повтор старого токена после успешной ротации не является штатным способом повторить запрос. Различие 400/401 зависит от момента обнаружения конфликта; не привязывайте восстановление клиента только к одному из статусов.
## Клиент
## Поведение клиента
Сохраните оба новых токена и сериализуйте refresh-запросы. Ошибка сети не должна автоматически удалять авторизацию пользователя. При подтверждённо недействительном refresh требуется повторный вход.
Выполняйте один refresh за раз для всех параллельных HTTP-запросов и хабов. Сохраняйте оба новых токена вместе. Если ответ потерялся после серверного сохранения, старая строка уже может быть недействительна и потребуется новый вход.
Ротация сейчас не имеет защиты от конкурентного использования и истории повторного применения. Детали — в разделе «Аутентификация».
---
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.Application/Users/UserSessions/UserSessionRefresher.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Users/UserSessions/UserSessionRefresher.cs).
Сетевой сбой или `5xx` не подтверждает недействительность токена. Повторный вход не должен удалять приватные ключи истории. [Пароль и восстановление](../../password-recovery.md).
+2 -32
View File
@@ -1,33 +1,3 @@
# Ключи сессий — экспериментальный API
# Старый API prekeys
RequireHttps и роль User/Admin обязательны.
| Метод | Маршрут | Назначение |
| ----- | --------------------------------- | ---------------------------------------- |
| POST | /api/session/keys | Привязать публичные ключи текущей сессии |
| GET | /api/session/users/{userId}/keys | Получить ключи друга |
| POST | /api/session/keys/rotate | Пополнить одноразовые ключи |
| GET | /api/session/keys/remaining | { remaining: число } |
| POST | /api/session/keys/{preKeyId}/used | Пометить собственный ключ использованным |
byte\[] в JSON передаются строкой base64. UploadKeysRequest содержит identityKey, signedPreKey, signedPreKeySignature и oneTimePreKeys (массив base64). За запрос допускается максимум 100 одноразовых ключей. Сервис запрещает повторную привязку ключей к сессии и проверяет владельца.
RotateOneTimePreKeysRequest содержит newOneTimePreKeys. В реализации ротация удаляет использованные записи и добавляет новые, не ограничивая общий размер набора.
## Неработающие и небезопасные части
\_oneTimePreKeysRotator не передан в конструктор SessionKeysController: rotate и used падают при обращении к null.
remaining считает все записи, включая IsUsed. Reader выдаёт все OneTimePreKeys и возвращает EF-сущности UserCryptoSession вместо PublicSessionKeysDto. Include(UserSession) может включить внутренние поля, а двусторонние навигации могут привести к циклу сериализации. SignedPreKey не включён явным Include.
Доступ к чужим ключам ограничен дружбой, но Forbid("текст") ошибочно используется как имя authentication scheme. Атомарной выдачи одного неиспользованного prekey потребителю нет: endpoint used относится к текущей сессии владельца.
## Статус E2EE
Это заготовка хранения ключей, не законченный криптографический протокол. Нет доказанной реализации обмена/проверки подписей, одноразового потребления, ratchet и поддержки шифрования на клиенте. Не используйте этот раздел как обещание сквозного шифрования.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/Authentication/SessionKeysController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Authentication/SessionKeysController.cs).
Актуальное описание: [совместимый API prekeys](../session-keys.md). Для нового клиента используйте [E2EE API](../e2ee.md).