- 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>
145 lines
10 KiB
Markdown
145 lines
10 KiB
Markdown
# 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 и отчёт.
|