- 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>
7.1 KiB
7.1 KiB
Proposal
Why
Переход API 1 → 2 (COURSE.md): регистрация требует password, вход
идёт по Basic, бизнес-запросы — по Bearer-сессии, а X-User-Id доступа
больше не даёт. Сейчас любой клиент выдаёт себя за другого заголовком.
Поэтому не проходят ни публичный smoke лабы 2, ни make test-persistence, ни зелёный make test_isolated — это обязательный
минимум «3» (README.md). Хранилище уже в PostgreSQL (postgres-storage),
теперь можно строить на нём сессии.
What Changes
- BREAKING (API):
POST /api/v1/usersтребуетpassword(12–128 code points, не только из пробелов). Пароль хэшируется Argon2id и никогда не возвращается. - Новый
POST /api/v1/auth/sessions: вход поAuthorization: Basic, без тела. Ответ — 201Session: непрозрачный токен (256 бит),token_type,expires_at,user. Неверный пароль, неизвестный пользователь и битый Basic дают одинаковый 401 сWWW-Authenticate: Basic realm="messenger", charset="UTF-8". - Новый
DELETE /api/v1/auth/sessions/current: отзыв текущей сессии, 204. Дальше этот токен получает 401. - BREAKING (API): защищённые эндпоинты принимают только
Authorization: Bearer <token>. Нет токена, он неизвестен, истёк или отозван, пришёл Basic — 401 сWWW-Authenticate: Bearer realm="messenger".X-User-Idигнорируется везде. - Сессии хранятся в PostgreSQL: SHA-256 токена, срок
expires_at, фиксированный при входе. Срок задаёт[auth] session_ttl_secondsвconfig.toml(по умолчанию 3600), разовая подмена — окружениемAUTH__SESSION_TTL_SECONDS; контрактное имяSESSION_TTL_SECONDSсопоставлено вREPORT.md. Действующие сессии переживают рестарт, рестарт срок не продлевает. Отзыв мгновенный: каждый запрос проверяет сессию в БД. - BREAKING (данные): миграция удаляет пользователей, чаты, участников и сообщения лабы 1 — у них нет пароля, войти они не смогут — и делает хэш пароля обязательным. Число удалённых пользователей пишется в журнал миграции. Данные стенда синтетические.
/openapi.jsonи/docsобъявляют схемыbearerAuthиbasicAuthиз контракта вместоdevUser.student-testsидентифицируются Bearer-токеном. Добавлены проверки входа, неверного пароля, logout, отказа Basic иX-User-Idна бизнес-ручках.- Становятся зелёными публичный smoke,
make test-persistence ACTION_SCRIPT=scripts/restart.shиmake test_isolated. Их выводы и ручная проверка истечения сессии при TTL 2 с сохраняются вevidence/.
Вне этого change: Redis/Valkey (membership-cache), автоматическая
проверка истечения на особом стенде с коротким TTL и проверки отказов
(failure-checks), перевод bench/ на Bearer (bench-postgres),
ограничение частоты входа (429), чистка истёкших сессий.
Capabilities
New Capabilities
sessions: вход по Basic, токен и его хранение, срок жизни, отзыв, сохранность сессий после рестарта.
Modified Capabilities
identification: Bearer вместоX-User-Idна защищённых эндпоинтах, 401 с вызовомBearer,X-User-Idигнорируется, схемыbearerAuthиbasicAuthв документации API.users: регистрация с паролем, хэш пароля через KDF,Userбез пароля, текущий пользователь по токену.health: health не требует аутентификации и игнорируетAuthorizationиX-User-Id.data-storage: сценарии сX-User-Idпереходят на токен, сессии тоже хранятся в PostgreSQL и переживают рестарт.container-run: рестарт hook-ом проверяется прежним токеном,make test-persistenceпроходит.service-configuration: срок сессии — параметрconfig.tomlс разовой подменой окружением, одинаково в консоли и docker.service-logging: в журнале нет паролей, токенов, их хэшей и заголовкаAuthorization;user_idберётся из сессии.student-tests: обязательные проверки лабы 2 — неверный пароль и logout.db-migrations: миграция, которая удаляет данные, обязана сообщать об этом в журнале.
Impact
- Код:
src/core/services/session.py,src/core/repos/session.py,src/api/routers/v1/session.py,src/api/schemas/session.py, модельsrc/infra/db/models/session.py, хэширование пароля вsrc/infra/; правкиuserво всех слоях,src/api/dependencies.py(Bearer вместоX-User-Id),src/api/errors.py(WWW-Authenticate),src/core/exceptions/,src/config/settings.py([auth]),src/utils/constants.py. - Миграция:
password_hashвusers, таблицаsessions, очистка данных лабы 1. - Зависимости:
argon2-cffi;uv.lock. - Конфигурация:
config_example.toml(секция[auth]);.env.exampleиdocker-compose.ymlне меняются. - Тесты:
student-tests/api_client.py(токен вActor, регистрация с паролем и входом), новыйtest_sessions.py, переписанныйtest_identification.py, тела регистрации вtest_users.py,test_race.py,test_rubric.py,spec_coverage.py. - Инструменты и документы: скилл
run-mtusi-messenger(вход и Bearer вdriver.py),AGENTS.md(«Переходное состояние»),.claude/rules/(auth.md— выбранные решения),REPORT.md(KDF, сессии, доказательства уровня «3»),evidence/.