Files
mtusi2026lab2/openspec/changes/session-auth/specs/users/spec.md
T
ricoromaandClaude Opus 5.5 ae4154eaf5 feat: add password login and bearer sessions
- 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>
2026-10-01 18:50:42 +03:00

75 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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** тело ответа равно телу ответа на его регистрацию