mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
53 lines
3.2 KiB
Markdown
53 lines
3.2 KiB
Markdown
---
|
||
description: >-
|
||
Controller for handling user authentication operations, including registration
|
||
and login, with session management and invite-based registration.
|
||
---
|
||
|
||
# Регистрация и вход
|
||
|
||
Оба метода доступны анонимно, Content-Type: application/json.
|
||
|
||
## POST /api/auth/register
|
||
|
||
```json
|
||
{
|
||
"name": "Артём",
|
||
"password": "example-password",
|
||
"inviteLink": "<код приглашения>",
|
||
"deviceInfo": "Android test device"
|
||
}
|
||
```
|
||
|
||
Имя: 4–44 символа, только кириллица и цифры, первый символ — буква. Модерация запрещает зарезервированные имена, совпадения/подстроки из конфигурации и пять одинаковых символов подряд. Пароль: минимум 8 символов. DeviceInfo необязателен в запросе, но в БД ограничен 256 символами.
|
||
|
||
Код создаётся как Guid.ToString("N"): 32 символа без дефисов. Поиск кода — по строковому равенству. InviteLink — код, а не URL.
|
||
|
||
Проверяется существование приглашения, срок и число участников. Проверка IsActive отсутствует, лимит участников не защищён от конкурентной регистрации.
|
||
|
||
Успех 200:
|
||
|
||
```json
|
||
{"refreshToken":"<token>","accessToken":"<token>"}
|
||
```
|
||
|
||
Конфликт имени — 409; ошибки валидации — 400; отсутствующее приглашение — 404. Тело сервисных ошибок — ProblemDetails с errorCode. Регистрация и открытие сессии — отдельные сохранения: ошибка открытия сессии не откатывает созданного пользователя.
|
||
|
||
## 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).
|