Files
mtusi2026lab2/openspec/changes/session-auth/tasks.md
T
ricoromaandClaude Opus 5.5 0cef33335d docs: add session-auth evidence and report
- passwords and tokens: Argon2id hashes, no secrets in db and logs
- session expiry and database outage with a valid token
- make test-persistence and make test_isolated on ae4154e
- migration drops lab 1 data without passwords
- REPORT.md: sessions, defense scenario, evidence rows

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 18:59:53 +03:00

10 KiB
Raw Blame History

Tasks

Как строить — design.md (дальше «решение N»), что должно получиться — дельты в specs/. Перед первым файлом слоя прочитать его правило: auth.md, migrations.md, infra.md, repo-layer.md, service-layer.md, dto.md, api-layer.md, api-contract.md, settings.md, student-tests.md. Evidence снимается с закоммиченного кода, коммит — только после подтверждения пользователя (bench.md, «Измеренное состояние — commit»).

1. Зависимость и настройки

  • 1.1 uv add argon2-cffi в основную группу. Проверка: uv lock --check проходит, uv run python -c "import argon2; print(argon2.profiles.RFC_9106_LOW_MEMORY)" печатает t=3, m=65536, p=4.
  • 1.2 Секция Auth в src/config/settings.py: session_ttl_seconds и kdf_concurrency (решение 6), оба в config_example.toml и рабочем config.toml; .env.example и compose не трогаются. Проверка: uv run python -c "from src.config import settings; print(settings.auth.session_ttl_seconds)" — 3600 без строки в config.toml, 600 при session_ttl_seconds = 600 в нём, 2 при AUTH__SESSION_TTL_SECONDS=2 в окружении поверх файла; AUTH__SESSION_TTL_SECONDS=abc и 0 — ошибка проверки настроек.

2. Схема

  • 2.1 Модель Session (src/infra/db/models/session.py), password_hash в User с CHECK (решение 1). Проверка: Base.metadata.sorted_tables — пять таблиц, у ограничений есть имена.
  • 2.2 Ревизия по решению 7: очистка лабы 1 с warning и числом пользователей, колонка, таблица; downgrade зеркалит upgrade. Проверка: на базе с данными лабы 1 make upgrade пишет число удалённых пользователей, повторный make upgrade ничего не пишет и не удаляет; alembic downgrade 16c279725564 и снова upgrade head проходят; alembic check — «No new upgrade operations detected».

3. Пароль, repo и сервисы

  • 3.1 src/infra/password.py (решение 3): профиль явно, CapacityLimiter, фиктивный хэш. Проверка: разовым скриптом верный пароль проходит, изменённый в последнем из 128 кириллических символов — нет; 20 одновременных хэшей при kdf_concurrency=4 идут не больше чем по 4.
  • 3.2 DTO (dto.md): UserFullDTO без хэша, отдельный DTO учётных данных для входа, SessionDTO, CurrentSessionDTO. Repo user: вставка с хэшем, учётные данные по username. Repo session: вставка, проверка токена одним SELECT с JOIN (решение 2), удаление по id. Проверка: make lint; EXPLAIN проверки токена идёт по уникальному индексу token_hash.
  • 3.3 UserService.register с паролем (хэш до БД), без identify; SessionService: login (две транзакции, решение 3), authenticate, revoke; исключения InvalidCredentials и Unauthenticated вместо Unidentified; логи по спеку service-logging. Проверка: grep -rn "Unidentified\|X-User-Id\| USER_ID_HEADER" src пусто, make lint чистый.

4. API

  • 4.1 dependencies.py (решения 4, 5): разбор Basic с ранним отсевом, get_current_session на HTTPBearer, get_current_user из неё; errors.py — WWW-Authenticate по типу исключения. Проверка: на make run_dev GET /api/v1/users/me без заголовка, с Basic и с неизвестным Bearer — 401 с Bearer realm="messenger".
  • 4.2 CreateUser с password (12–128, не только пробелы, StrictStr); роутер session.py: POST /auth/sessions 201 Session, DELETE /auth/sessions/current 204. Проверка: make test против make run_dev — PASS.
  • 4.3 Документация API: /openapi.json объявляет bearerAuth и basicAuth как контракт, без devUser (спек identification). Проверка: security у GET /api/v1/users/me, POST /api/v1/auth/sessions и POST /api/v1/users — как в сценарии «Схема в openapi.json»; в /docs вход и запрос через Authorize работают с паролем из ASCII.

5. Собственные тесты

  • 5.1 api_client.py (решение 8): токен в Actor, register с паролем и входом, login, unregistered() со случайным токеном, хелпер тела регистрации; тела регистрации в test_users.py, test_race.py, test_rubric.py — через него. Проверка: make student_test против make run_dev — тесты поведения лабы 1 проходят без правки ожиданий.
  • 5.2 test_identification.py по дельте identification, test_sessions.py по sessions, тесты сценариев users («Нет пароля», «Граница длины пароля», «Пароль из пробелов», «Длинный пароль в UTF-8 целиком»), health («Неизвестный токен») и рубрики student-tests («Неверный пароль в рубрике», «Logout в рубрике»). Проверка: против make run_dev все проходят. Тесты отказов (401) проверены на ложную зелень: временная поломка в SessionService.authenticate (принять любой токен) роняет их, после отката правки они снова зелёные.
  • 5.3 /opsx:sync и в том же шаге spec_coverage.py: sessions — в список отслеживаемых capability; исключения для сценариев, которые не проверить на обычном стенде: «Истёкший токен», «Срок не продлевается», «Прежний токен после рестарта», «БД остановлена при запросе с токеном», «Токена нет в хранилище» (sessions), «Хэш в БД» (users) — со ссылкой на evidence и failure-checks; текст исключения «Прежний пользователь после рестарта» — про токен; «Кнопка Authorize в Swagger» — про bearerAuth и basicAuth вместо devUser. Спеки service-configuration, container-run и db-migrations проверяются evidence, в сверку не входят. Purpose основного спека identification переписать руками: в нём «с лабы 2 её заменяет Bearer». Проверка: make student_test — все тесты прошли, в том числе test_coverage.py; openspec validate --specs без ошибок.

6. Инструменты и документы

  • 6.1 Скилл run-mtusi-messenger: driver.py регистрирует с паролем, входит и ходит с Bearer, req --token вместо --user; SKILL.md без X-User-Id и известных падений. Проверка: python3 .claude/skills/run-mtusi-messenger/driver.py all — FAILED: none, smoke PASS, student — все прошли.
  • 6.2 auth.md — выбранные решения (сессии в PostgreSQL, отзыв удалением, лимит KDF, HTTPBase для basicAuth); AGENTS.md — «Переходное состояние» без пунктов про X-User-Id, devUser, identification/users и закрытых сценариев session-auth, карта кода (session.py во всех слоях, infra/password.py). Проверка: grep -rn "X-User-Id" AGENTS.md .claude — только история лабы 1 и правило, что он игнорируется.
  • 6.3 Финальная проверка кода: make lint, make check, openspec validate session-auth --strict, make test_isolated — код 0. Затем показать изменения, предложить сообщение и после подтверждения пользователя закоммитить.

7. Evidence и отчёт

  • 7.1 Evidence по таблице решения 9 с закоммиченного кода. Проверка: в каждом файле дата, commit, стенд; паролей, токенов и Authorization в файлах нет; drop-lab1-data.md снят на рабочей базе до её очистки.
  • 7.2 REPORT.md: Argon2id и его параметры, сессии и их хранение, SESSION_TTL_SECONDS и SESSION_STORE=postgres в таблице соответствия, сценарий защиты (миграции → вход → сообщение → make test-persistence → logout), строки доказательств уровня «3» и logout/неверного пароля уровня «4» со ссылками на evidence, предупреждение об очистке данных лабы 1, удаление закрытых TODO. Проверка: у каждой строки таблицы доказательств есть команда, наблюдение и файл.
  • 7.3 make lint, make check, openspec validate session-auth --strict, graphify update .; показать изменения и после подтверждения пользователя закоммитить evidence и отчёт.