From 7887e03adee1f51e77a4ffaeb9941f1fa295a066 Mon Sep 17 00:00:00 2001 From: roman Date: Thu, 1 Oct 2026 19:16:18 +0300 Subject: [PATCH] fix: precompute dummy password hash at startup - lifespan computes the dummy Argon2id hash: first unknown-user login takes as long as a wrong password - evidence for session TTL from config.toml, default and environment - REPORT.md: manual /docs check, TTL configuration row - tasks.md: why checks ran on a separate dev database Co-Authored-By: Claude Opus 5.5 --- .claude/rules/auth.md | 2 ++ REPORT.md | 2 ++ evidence/auth/ttl-config.md | 36 +++++++++++++++++++++++++ openspec/changes/session-auth/design.md | 6 +++-- openspec/changes/session-auth/tasks.md | 8 ++++++ src/infra/password.py | 12 ++++++--- src/main.py | 4 +++ student-tests/spec_coverage.py | 3 ++- 8 files changed, 67 insertions(+), 6 deletions(-) create mode 100644 evidence/auth/ttl-config.md diff --git a/.claude/rules/auth.md b/.claude/rules/auth.md index 742fa940..9e674444 100644 --- a/.claude/rules/auth.md +++ b/.claude/rules/auth.md @@ -39,6 +39,8 @@ paths: - Неизвестный username и неверный пароль — одно исключение и одинаковый 401. Для неизвестного username пароль всё равно проверяется против фиктивного хэша, чтобы время ответа не выдавало, есть ли пользователь. + Фиктивный хэш считает lifespan при старте (`prepare_dummy_hash`): при + ленивом расчёте первый такой вход шёл бы вдвое дольше. ## Basic на входе diff --git a/REPORT.md b/REPORT.md index 1c8907fe..7c65997e 100644 --- a/REPORT.md +++ b/REPORT.md @@ -260,7 +260,9 @@ keyset-ом по индексу без сортировки всех чатов | Миграция к паролям на старой базе | `make run_docker` на volume с данными лабы 1, затем `docker compose run --rm migrate` | `warning` «Deleted lab 1 data without passwords: 225 users…», `password_hash` NOT NULL, таблица `sessions`; повтор — no-op | `evidence/migrations/drop-lab1-data.md` | | Составная операция создания чата атомарна | код `ChatService.create_chat`: один commit | автоматическая проверка отката — change `failure-checks` | TODO | | Basic только на `POST /auth/sessions`, остальное — Bearer; `X-User-Id` не даёт доступ | smoke и `test_identification.py`, `test_sessions.py` в `make test_isolated` | Basic на `/users/me` — 401 с вызовом Bearer; только `X-User-Id` — 401; Bearer alice с `X-User-Id` eve — alice; битый Basic — 401 с вызовом Basic | `evidence/tests/test-isolated.md` | +| Схемы `bearerAuth` и `basicAuth` в документации API | `test_security_schemes_in_openapi`; вручную в `/docs` | `/openapi.json` совпадает с контрактом, `devUser` нет; в `/docs` вход через Authorize (Basic, пароль из ASCII) и запрос с Bearer работают — проверено автором 2026-10-01 | `evidence/tests/test-isolated.md` | | Срок жизни сессии | сервис с `AUTH__SESSION_TTL_SECONDS=2` | 200 сразу, 401 через 2,1 с; запросы каждые 0,5 с срок не продлевают | `evidence/auth/expiry.md` | +| Срок сессии — настройка (`SESSION_TTL_SECONDS` контракта) | сервис с разными `config.toml` и окружением | без `[auth]` — 3600 с, `session_ttl_seconds = 600` — 600 с, окружение `AUTH__SESSION_TTL_SECONDS=2` поверх файла — 2 с; `abc` и `0` — запуск останавливается | `evidence/auth/ttl-config.md` | | Отзыв сессии | `DELETE /auth/sessions/current`: `test_logout`, `test_logout_twice`, `test_other_session_survives_logout` | 204 без тела, дальше этот токен — 401 везде; вторая сессия работает | `evidence/tests/test-isolated.md` | | Пароли — password KDF | `psql`, `pg_dump --data-only`, журнал API | `$argon2id$v=19$m=65536,t=3,p=4$…`, у одинаковых паролей разные хэши; пароля и токена нет ни в БД, ни в журнале; в `sessions` — SHA-256 токена | `evidence/auth/passwords-and-tokens.md` | | Secrets и volumes не в git | `.gitignore`, `make env_setup` | `.env`, `config.toml` игнорируются; пароль Postgres генерируется локально | `.gitignore` | diff --git a/evidence/auth/ttl-config.md b/evidence/auth/ttl-config.md new file mode 100644 index 00000000..f13abc4c --- /dev/null +++ b/evidence/auth/ttl-config.md @@ -0,0 +1,36 @@ +# Срок сессии: `config.toml`, значение по умолчанию, окружение, неверное значение + +| | | +|---|---| +| Спек | `service-configuration` «Срок жизни сессии»: сценарии «Срок из config.toml», «Срок по умолчанию», «Короткий срок из окружения», «Срок не число» | +| Change | `session-auth`, доработка по `/opsx:verify` | +| Дата | 2026-10-01 16:12 UTC | +| Commit | `0cef333` | +| Стенд | сервис в console на `127.0.0.1:18081` (`python -m src`), Postgres из compose | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Как снято | разовый stdlib-скрипт. Для каждого случая сервис запускается из временной копии `src/` со своим `config.toml` (из `config_example.toml` с заменённой секцией `[auth]`) и тем же `.env`; рабочий `config.toml` не трогается. Регистрация и вход, срок — `expires_at` минус момент отправки входа. Пароли синтетические и не печатаются | + +## Срок новой сессии + +| Случай | `expires_at` − момент входа | +|---|---| +| в `config.toml` нет секции `[auth]` | 3600,0 с | +| `[auth] session_ttl_seconds = 600` | 600,0 с | +| 600 в файле + `AUTH__SESSION_TTL_SECONDS=2` в окружении | 2,0 с | + +## Неверное значение + +| Окружение | Запуск | +|---|---| +| `AUTH__SESSION_TTL_SECONDS=abc` | код 1: `ValidationError` для `auth.session_ttl_seconds` — Input should be a valid integer, unable to parse string as an integer | +| `AUTH__SESSION_TTL_SECONDS=0` | код 1: `ValidationError` для `auth.session_ttl_seconds` — Input should be greater than 0 | + +## Вывод + +- Срок сессии — параметр `config.toml`, без него 3600 с. +- Окружение `AUTH__SESSION_TTL_SECONDS` перекрывает файл без его правки: + так проверяется истечение (`evidence/auth/expiry.md`). +- Нецелое и неположительное значение останавливают запуск ошибкой + проверки настроек. +- Контрактное имя `SESSION_TTL_SECONDS` сопоставлено с параметром в + `REPORT.md`. diff --git a/openspec/changes/session-auth/design.md b/openspec/changes/session-auth/design.md index 14424d89..aec0ac73 100644 --- a/openspec/changes/session-auth/design.md +++ b/openspec/changes/session-auth/design.md @@ -101,8 +101,10 @@ Bearer). Ошибка БД уходит в `get_db_session` и даёт 503, а 2,5 GiB памяти, ВМ Docker — 7 GiB. С лимитом пик — 256 MiB, остальные ждут в очереди. - Неизвестный username проверяется против фиктивного хэша, - посчитанного один раз при первом входе. Время ответа тогда то же, что - у неверного пароля (`auth.md`); замер — в evidence. + посчитанного один раз на процесс — в lifespan при старте. Время ответа + тогда то же, что у неверного пароля, с первого запроса (`auth.md`); + замер — в evidence. Ленивый расчёт при первом входе делал бы этот + вход вдвое дольше (нашёл `/opsx:verify`). - Регистрация хэширует пароль до обращения к БД. Вход читает хэш, затем `commit()` — сессия БД возвращает соединение в пул, — проверяет пароль и вставляет сессию новой транзакцией. Соединение пула не держится diff --git a/openspec/changes/session-auth/tasks.md b/openspec/changes/session-auth/tasks.md index e6dbd3f2..db185997 100644 --- a/openspec/changes/session-auth/tasks.md +++ b/openspec/changes/session-auth/tasks.md @@ -8,6 +8,14 @@ кода, коммит — только после подтверждения пользователя (`bench.md`, «Измеренное состояние — commit»). +Проверки «на `make run_dev`» в задачах 4.x и 5.x при реализации шли на +консольном сервисе (`python -m src`, тот же код и режим) против +отдельной базы `dev_session_auth` в том же Postgres. `make run_dev` и +`driver.py start` применяют миграции к рабочей базе. Ревизия +`42bc3b9be38f` удалила бы данные лабы 1 раньше, чем снято evidence +этого удаления с закоммиченного кода (задача 7.1). После снятия база +`dev_session_auth` удалена. + ## 1. Зависимость и настройки - [x] 1.1 `uv add argon2-cffi` в основную группу. Проверка: diff --git a/src/infra/password.py b/src/infra/password.py index b4c2f7bd..e128e4f6 100644 --- a/src/infra/password.py +++ b/src/infra/password.py @@ -20,7 +20,8 @@ _hasher = PasswordHasher.from_parameters(profiles.RFC_9106_LOW_MEMORY) # свой лимит, а не общий пул anyio на 40 потоков: 40 × 64 MiB = 2,5 GiB. # При отмене запроса место освобождается только после конца потока _limiter = anyio.CapacityLimiter(settings.auth.kdf_concurrency) -# хэш для неизвестного username: считается при первом входе +# хэш для неизвестного username: считает lifespan при старте +# (prepare_dummy_hash), иначе — первый такой вход _dummy_hash: str | None = None @@ -39,7 +40,7 @@ async def verify_password(*, password: str, password_hash: str | None) -> bool: if password_hash is None: await to_thread.run_sync( _matches, - await _get_dummy_hash(), + await prepare_dummy_hash(), password, limiter=_limiter, ) @@ -60,7 +61,12 @@ def _matches(password_hash: str, password: str) -> bool: return False -async def _get_dummy_hash() -> str: +async def prepare_dummy_hash() -> str: + """Фиктивный хэш для неизвестного username, один на процесс. + + Lifespan вызывает его при старте: иначе первый вход с неизвестным + username считал бы хэш и проверку — вдвое дольше неверного пароля. + """ global _dummy_hash if _dummy_hash is None: _dummy_hash = await hash_password(secrets.token_urlsafe(16)) diff --git a/src/main.py b/src/main.py index 518521c3..8e5fde34 100644 --- a/src/main.py +++ b/src/main.py @@ -10,6 +10,7 @@ from src.api.routers import health_router, v1_router from src.config import settings from src.infra.db.session import engine from src.infra.logger import AbstractLogger, get_logger +from src.infra.password import prepare_dummy_hash from src.schemas.enums import RunModeEnum logger: AbstractLogger = get_logger().bind(module="startup") @@ -22,6 +23,9 @@ async def lifespan(_: FastAPI) -> AsyncIterator[None]: # /health/ready отвечает 503 if not database.password.get_secret_value(): logger.warning("Database password is empty") + # ~30 мс CPU при старте: время ответа на вход с неизвестным username + # ровное с первого запроса + await prepare_dummy_hash() logger.info( "Started API", host=settings.app.host, diff --git a/student-tests/spec_coverage.py b/student-tests/spec_coverage.py index 93998b7e..547269d8 100644 --- a/student-tests/spec_coverage.py +++ b/student-tests/spec_coverage.py @@ -83,7 +83,8 @@ EXCLUDED: dict[Scenario, Exclusion] = { ("identification", "Кнопка Authorize в Swagger"): Exclusion( reason="это интерфейс /docs в браузере", check="схемы bearerAuth и basicAuth, из которых строится кнопка, " - "проверяет тест сценария «Схема в openapi.json»; кнопку — вручную", + "проверяет тест сценария «Схема в openapi.json»; кнопку — вручную " + "(REPORT.md, таблица доказательств)", ), ("sessions", "Токена нет в хранилище"): Exclusion( reason="нужен доступ к таблицам PostgreSQL, а тесты ходят по HTTP",