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.
6.2 KiB
Регистрация и вход
Content-Type: application/json. Регистрация и методы входа анонимные, но ограничены политикой password-auth. Смена пароля, миграция и восстановление описаны в отдельном руководстве.
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:
{"refreshToken":"<refresh>","accessToken":"<access>"}
Открытие сессии выполняется после регистрации. Если оно не удалось, аккаунт уже мог быть создан: сначала попробуйте вход, не повторяйте регистрацию бесконечно. Конфликт имени — 409, отсутствующее приглашение — 404, ошибка валидации/недоступное приглашение — 400. Ошибки сервиса используют ProblemDetails.
Контракт 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 нужно вычислить):
{
"name": "Артём",
"srpSalt": "<salt из PasswordProtocol.Create>",
"srpIdentity": "<identity из PasswordProtocol.Create>",
"srpVerifier": "<verifier из PasswordProtocol.Create>",
"inviteLink": "<код приглашения>",
"deviceInfo": "Android test device"
}
Вход SRP
POST /api/auth/password/challengeначинает обмен и возвращает серверные параметры/challenge.- Клиент вычисляет доказательство и отправляет
POST /api/auth/password/login. - Ответ содержит токены и серверное доказательство. Клиент проверяет доказательство до принятия результата.
Challenge действует две минуты и расходуется один раз. Неверное/истёкшее доказательство — 401, некорректные протокольные данные — 400, конфликт состояния — 409, превышение лимита — 429. Для повторной попытки начните новый обмен.
Точные DTO, правила кодирования и криптографические операции заданы в PasswordProtocol.cs и PasswordAccountService.cs. Их следует переносить согласованно с клиентом, не реализовывать обмен по одному схематическому JSON-примеру.
POST /api/auth/login — совместимость
{"name":"Артём","password":"example-password","deviceInfo":"Android test device"}
Для bcrypt-аккаунта успех — та же пара токенов. Неизвестное имя — 404, неверный пароль — 400, SRP-аккаунт — 401 Auth.PasswordProofRequired. Различающиеся ответы старого входа позволяют определить существование имени; не переносите это поведение в пользовательские тексты ошибок.