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

3.7 KiB

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 тело ответа равно телу ответа на его регистрацию