- Argon2id password hashes, KDF in a thread with its own limit - POST /auth/sessions with Basic, DELETE /auth/sessions/current - Bearer sessions in PostgreSQL, X-User-Id ignored - migration drops lab 1 data without passwords - student-tests on tokens, sessions spec and synced specs Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
75 lines
3.7 KiB
Markdown
75 lines
3.7 KiB
Markdown
# Spec Delta
|
||
|
||
## ADDED Requirements
|
||
|
||
### Requirement: Формат пароля
|
||
|
||
`password` SHALL содержать от 12 до 128 Unicode code points и MUST NOT
|
||
состоять только из пробельных символов. Допустимы любые символы
|
||
Unicode, в том числе `:`. Значение SHALL использоваться без изменений:
|
||
без обрезки, нормализации и усечения по байтам. Иначе сервис SHALL
|
||
отвечать 400 `invalid_request`.
|
||
|
||
#### Scenario: Нет пароля
|
||
|
||
- **WHEN** тело регистрации не содержит `password`
|
||
- **THEN** ответ 400
|
||
|
||
#### Scenario: Граница длины пароля
|
||
|
||
- **WHEN** `password` из 11 code points, затем из 12, из 128 и из 129
|
||
- **THEN** первый и последний запросы дают 400, остальные — 201
|
||
|
||
#### Scenario: Пароль из пробелов
|
||
|
||
- **WHEN** `password` из 12 пробелов
|
||
- **THEN** ответ 400
|
||
|
||
#### Scenario: Длинный пароль в UTF-8 целиком
|
||
|
||
- **WHEN** пользователь зарегистрировался с паролем из 128 кириллических
|
||
символов, затем входит с паролем, где изменён только последний символ
|
||
- **THEN** вход отклонён 401: пароль сравнивается целиком, а не по
|
||
первым байтам
|
||
|
||
### Requirement: Пароль хранится только хэшем
|
||
|
||
Сервис SHALL хранить пароль только как результат библиотечного password
|
||
KDF с солью. Пароль MUST NOT храниться в открытом виде или как быстрый
|
||
хэш (SHA-256 и подобные) и MUST NOT попадать в ответы API и журнал.
|
||
|
||
#### Scenario: Хэш в БД
|
||
|
||
- **WHEN** пользователь зарегистрирован с паролем P
|
||
- **THEN** в его строке в PostgreSQL нет P, а хранимое значение — строка
|
||
KDF с параметрами и солью; у двух пользователей с одинаковым паролем
|
||
хранимые значения разные
|
||
|
||
## MODIFIED Requirements
|
||
|
||
### Requirement: Регистрация пользователя
|
||
|
||
`POST /api/v1/users` SHALL быть публичным и принимать тело
|
||
`{"username": ..., "display_name": ..., "password": ...}`. При успехе
|
||
сервис SHALL отвечать 201 с объектом `User`: `id`, `username`,
|
||
`display_name`, `created_at`, без других полей: пароля и его хэша в
|
||
ответе нет. `id` и `created_at` назначает сервер.
|
||
|
||
#### Scenario: Успешная регистрация
|
||
|
||
- **WHEN** клиент отправляет `{"username": "alice", "display_name":
|
||
"Алиса", "password": ...}` с допустимым паролем
|
||
- **THEN** ответ 201, `username` и `display_name` совпадают с
|
||
отправленными, `id` — новый UUID, полей кроме четырёх полей `User` нет
|
||
|
||
### Requirement: Текущий пользователь
|
||
|
||
`GET /api/v1/users/me` SHALL возвращать 200 с объектом `User` владельца
|
||
сессии, чей токен передан (capability `identification`).
|
||
|
||
#### Scenario: Совпадает с регистрацией
|
||
|
||
- **WHEN** пользователь запрашивает `GET /api/v1/users/me` со своим
|
||
токеном
|
||
- **THEN** тело ответа равно телу ответа на его регистрацию
|