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 <noreply@anthropic.com>
This commit is contained in:
@@ -39,6 +39,8 @@ paths:
|
||||
- Неизвестный username и неверный пароль — одно исключение и одинаковый
|
||||
401. Для неизвестного username пароль всё равно проверяется против
|
||||
фиктивного хэша, чтобы время ответа не выдавало, есть ли пользователь.
|
||||
Фиктивный хэш считает lifespan при старте (`prepare_dummy_hash`): при
|
||||
ленивом расчёте первый такой вход шёл бы вдвое дольше.
|
||||
|
||||
## Basic на входе
|
||||
|
||||
|
||||
@@ -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` |
|
||||
|
||||
@@ -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`.
|
||||
@@ -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()` — сессия БД возвращает соединение в пул, — проверяет пароль
|
||||
и вставляет сессию новой транзакцией. Соединение пула не держится
|
||||
|
||||
@@ -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` в основную группу. Проверка:
|
||||
|
||||
@@ -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))
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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",
|
||||
|
||||
Reference in New Issue
Block a user