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