- 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>
10 KiB
10 KiB
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. Проверка: на базе с данными лабы 1make 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. Repouser: вставка с хэшем, учётные данные по username. Reposession: вставка, проверка токена одним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_devGET /api/v1/users/meбез заголовка, с Basic и с неизвестным Bearer — 401 сBearer realm="messenger". - 4.2
CreateUserсpassword(12–128, не только пробелы,StrictStr); роутерsession.py:POST /auth/sessions201Session,DELETE /auth/sessions/current204. Проверка: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, smokePASS, 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 и отчёт.