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

145 lines
10 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.
# 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. Зависимость и настройки
- [x] 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.
- [x] 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. Схема
- [x] 2.1 Модель `Session` (`src/infra/db/models/session.py`),
`password_hash` в `User` с `CHECK` (решение 1). Проверка:
`Base.metadata.sorted_tables` — пять таблиц, у ограничений есть
имена.
- [x] 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 и сервисы
- [x] 3.1 `src/infra/password.py` (решение 3): профиль явно,
`CapacityLimiter`, фиктивный хэш. Проверка: разовым скриптом верный
пароль проходит, изменённый в последнем из 128 кириллических символов
— нет; 20 одновременных хэшей при `kdf_concurrency=4` идут не больше
чем по 4.
- [x] 3.2 DTO (`dto.md`): `UserFullDTO` без хэша, отдельный DTO
учётных данных для входа, `SessionDTO`, `CurrentSessionDTO`. Repo
`user`: вставка с хэшем, учётные данные по username. Repo `session`:
вставка, проверка токена одним `SELECT` с `JOIN` (решение 2),
удаление по `id`. Проверка: `make lint`; `EXPLAIN` проверки токена
идёт по уникальному индексу `token_hash`.
- [x] 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
- [x] 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"`.
- [x] 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`.
- [x] 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. Собственные тесты
- [x] 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 проходят без правки
ожиданий.
- [x] 5.2 `test_identification.py` по дельте `identification`,
`test_sessions.py` по `sessions`, тесты сценариев `users` («Нет
пароля», «Граница длины пароля», «Пароль из пробелов», «Длинный
пароль в UTF-8 целиком»), `health` («Неизвестный токен») и рубрики
`student-tests` («Неверный пароль в рубрике», «Logout в рубрике»).
Проверка: против `make run_dev` все проходят. Тесты отказов (401)
проверены на ложную зелень: временная поломка в
`SessionService.authenticate` (принять любой токен) роняет их, после
отката правки они снова зелёные.
- [x] 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. Инструменты и документы
- [x] 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 — все прошли.
- [x] 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 и
правило, что он игнорируется.
- [x] 6.3 Финальная проверка кода: `make lint`, `make check`,
`openspec validate session-auth --strict`, `make test_isolated` —
код 0. Затем показать изменения, предложить сообщение и после
подтверждения пользователя закоммитить.
## 7. Evidence и отчёт
- [x] 7.1 Evidence по таблице решения 9 с закоммиченного кода. Проверка:
в каждом файле дата, commit, стенд; паролей, токенов и
`Authorization` в файлах нет; `drop-lab1-data.md` снят на рабочей
базе до её очистки.
- [x] 7.2 `REPORT.md`: Argon2id и его параметры, сессии и их хранение,
`SESSION_TTL_SECONDS` и `SESSION_STORE=postgres` в таблице
соответствия, сценарий защиты (миграции → вход → сообщение →
`make test-persistence` → logout), строки доказательств уровня «3» и
logout/неверного пароля уровня «4» со ссылками на evidence,
предупреждение об очистке данных лабы 1, удаление закрытых TODO.
Проверка: у каждой строки таблицы доказательств есть команда,
наблюдение и файл.
- [x] 7.3 `make lint`, `make check`, `openspec validate session-auth
--strict`, `graphify update .`; показать изменения и после
подтверждения пользователя закоммитить evidence и отчёт.