Проверять аутентификацию раньше валидации тела запроса
Skeleton contracts / contracts (pull_request) Canceled after 0s
Application / stack (pull_request) Canceled after 0s

This commit is contained in:
Pavel Grigorev
2026-10-30 16:50:30 +03:00
parent c8d078390c
commit cd81572950
7 changed files with 36 additions and 18 deletions
+2 -2
View File
@@ -67,7 +67,7 @@ migrate (one-shot) ──► postgres сеть backend: internal, по
**Транзакционные границы.** Регистрация — один INSERT, гонку решает UNIQUE (`unique_violation` → 409). Вход — удаление истёкших сессий пользователя и вставка новой в одной транзакции. **Создание чата** — `INSERT chats` и `INSERT chat_members … FROM unnest(...) WITH ORDINALITY` в одной явной транзакции; неизвестный участник вызывает `foreign_key_violation`, откатывается всё (→ 400). Сообщение — один `INSERT … SELECT … WHERE EXISTS(членство)`, проверка доступа и запись атомарны. Чтение истории — проверка членства и keyset-SELECT на одном соединении. Все запросы параметризованы.
**Сессии.** `POST /auth/sessions` принимает только `Authorization: Basic` без тела; username по regex, пароль 12–128 code points, разделение по первому `:`. Пароль сверяется Argon2id (`t=2, m=19 MiB, p=1`, параметры OWASP); для несуществующего пользователя вычисляется хеш-пустышка, ответ — одинаковый 401 с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`. Токен — `secrets.token_urlsafe(32)` (256 бит), в БД хранится только `sha256(token)` и абсолютный `expires_at = now() + SESSION_TTL_SECONDS` — рестарт не продлевает TTL. Все остальные endpoint требуют `Bearer`; нет/истёк/отозван/Basic → 401 с `WWW-Authenticate: Bearer realm="messenger"`; `X-User-Id` не читается. Logout удаляет строку сессии (204), повтор — 401.
**Сессии.** `POST /auth/sessions` принимает только `Authorization: Basic` без тела; username по regex, пароль 12–128 code points, разделение по первому `:`. Пароль сверяется Argon2id (`t=2, m=19 MiB, p=1`, параметры OWASP); для несуществующего пользователя вычисляется хеш-пустышка, ответ — одинаковый 401 с `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`. Токен — `secrets.token_urlsafe(32)` (256 бит), в БД хранится только `sha256(token)` и абсолютный `expires_at = now() + SESSION_TTL_SECONDS` — рестарт не продлевает TTL. Все остальные endpoint требуют `Bearer`; нет/истёк/отозван/Basic → 401 с `WWW-Authenticate: Bearer realm="messenger"`; `X-User-Id` не читается. Аутентификация проверяется раньше валидации тела: аноним с некорректным JSON на защищённом endpoint получает 401, а не 400. Logout удаляет строку сессии (204), повтор — 401.
**Роль Valkey (уровень 4): кэш сессий.** Ключ `session:<hex sha256>`, значение `{user, expires_at}`. Пишется при входе (write-through) и при промахе (cache-aside). TTL = `min(SESSION_CACHE_TTL_SECONDS=60, остаток сессии)`, при чтении `expires_at` проверяется повторно — кэш не может продлить сессию. Инвалидация: logout удаляет строку в PostgreSQL, затем `DEL` в Valkey. Известное окно: гонка «чтение сессии из БД ↔ logout» может вернуть отозванную запись в кэш не дольше 60 с. Flush/restart Valkey — только промахи; persistence не нужна (`--save "" --appendonly no`), `maxmemory 64mb`, `volatile-ttl`. Отказ Valkey: socket timeout 200 мс, после ошибки кэш 5 с не опрашивается (circuit breaker), запросы идут в PostgreSQL. В API `dns_opt timeout:1 attempts:1`: имя остановленного контейнера пропадает из DNS Docker, и без опции резолв занимал 8 с.
@@ -117,7 +117,7 @@ migrate (one-shot) ──► postgres сеть backend: internal, по
Стенд: Windows 10 Pro 19045, Docker Desktop (Engine 27.2.0, WSL2), VM Docker: 12 CPU, 1,9 GiB RAM; лимиты контейнерам не заданы; клиент на той же машине. PostgreSQL 17.11, `shared_buffers=128MB`, остальное по умолчанию, `track_io_timing=on`.
Нагрузка (`python tests/load.py --duration 30 --concurrency 4 --output evidence/load.json`, closed loop, POST в один чат, без прогрева): 9 296 успешных, 0 ошибок, **309 RPS**, p50 10,4 / p95 30,8 / p99 34,8 мс. После прогона: api 74 MiB, postgres 35 MiB, valkey 3,6 MiB. Генератор closed-loop (coordinated omission), клиент делит CPU с сервером — это не предел пропускной способности.
Нагрузка (`python tests/load.py --duration 30 --concurrency 4 --output evidence/load.json`, closed loop, POST в один новый чат — история растёт от 0 до ~9 300 сообщений; без прогрева): 9 296 успешных, 0 ошибок, **309 RPS**, p50 10,4 / p95 30,8 / p99 34,8 мс. После прогона: api 74 MiB, postgres 35 MiB, valkey 3,6 MiB. Генератор closed-loop (coordinated omission), клиент делит CPU с сервером — это не предел пропускной способности.
### Трек 2. План запроса истории и восстановление
+1 -1
View File
@@ -10,7 +10,7 @@
| --- | --- | --- |
| `smoke.txt` | `python tests/smoke.py --base-url http://127.0.0.1:8080` | публичный сценарий lab2 |
| `persistence.txt` | `python tests/resilience.py --mode persistence --action-script scripts/restart.cmd` | PASS + `docker compose ps` до/после, строки остановки/старта из логов, volumes |
| `student-tests.txt` | `python -m unittest discover -s student-tests -v` | 36 собственных тестов: API, аутентификация, гонки, rollback, миграции |
| `student-tests.txt` | `python -m unittest discover -s student-tests -v` | 37 собственных тестов: API, аутентификация, гонки, rollback, миграции |
| `expiry.txt` | `python student-tests/expiry_check.py --ttl 2` | истечение сессии и TTL ключа в Valkey |
| `failure.txt` | `python student-tests/failure_check.py` | отказ Valkey и PostgreSQL |
| `sigterm.txt` | `python student-tests/sigterm_check.py` | остановка API по SIGTERM |
+12 -12
View File
@@ -1,24 +1,24 @@
# python student-tests/failure_check.py
# date: 2026-10-29T09:20:57Z; host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
# date: 2026-10-30T13:48:15Z; host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
1. Valkey остановлен: кэш обходится, всё работает через PostgreSQL
первый запрос: обнаружение отказа кэша -> 200 за 1.01 с OK
GET /users/me действующим токеном -> 200 за 0.00 с OK
POST сообщение -> 201 за 0.01 с OK
неизвестный токен -> 401 за 0.00 с OK
без Authorization -> 401 за 0.01 с OK
GET /users/me действующим токеном -> 200 за 0.02 с OK
POST сообщение -> 201 за 0.02 с OK
неизвестный токен -> 401 за 0.01 с OK
без Authorization -> 401 за 0.00 с OK
/health/ready (Valkey некритичен) -> 200 за 0.00 с OK
регистрация и вход без кэша -> 200 за 0.06 с OK
регистрация и вход без кэша -> 200 за 0.05 с OK
logout без кэша -> 204 за 0.01 с OK
отозванный токен -> 401 за 0.00 с OK
2. PostgreSQL остановлен: ограниченная ошибка 503, анонимный запрос не проходит
GET история -> 503 за 2.01 с OK
POST сообщение -> 503 за 2.00 с OK
POST сообщение -> 503 за 2.02 с OK
неизвестный токен (не 200!) -> 503 за 2.00 с OK
без Authorization -> 401 за 0.03 с OK
вход по Basic верным паролем -> 503 за 2.01 с OK
/health/live -> 200 за 0.00 с OK
/health/ready -> 503 за 1.03 с OK
3. PostgreSQL запущен: готовность через 15.1 с после остановки
без Authorization -> 401 за 0.00 с OK
вход по Basic верным паролем -> 503 за 2.00 с OK
/health/live -> 200 за 0.02 с OK
/health/ready -> 503 за 1.00 с OK
3. PostgreSQL запущен: готовность через 15.3 с после остановки
прежний токен -> 200; история: ['до отказа', 'без кэша']
PASS: отказы Valkey и PostgreSQL обработаны
+1 -1
View File
@@ -1,4 +1,4 @@
# python tests/smoke.py --base-url http://127.0.0.1:8080
# date: 2026-10-29T09:19:39Z; base commit: 65003b6 (working tree, solution uncommitted); host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
# date: 2026-10-30T13:48:39Z; host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
+4 -2
View File
@@ -1,5 +1,5 @@
# python -m unittest discover -s student-tests -v
# date: 2026-10-29T09:20:03Z; host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
# date: 2026-10-30T13:48:04Z; host: Windows 10, Docker Desktop 27.2.0, 12 CPU / 1.9 GiB for Docker VM
test_duplicate_username (test_api.DuplicateUsernameTest.test_duplicate_username)
Повторная регистрация того же username -> 409 conflict ... ok
@@ -37,6 +37,8 @@ test_invalid_cursor_and_limit (test_api.PaginationTest.test_invalid_cursor_and_l
Мусорный cursor и limit вне 1..100 -> 400 ... ok
test_walk_several_pages (test_api.PaginationTest.test_walk_several_pages)
7 сообщений по 3: три страницы, без потерь, повторов и перестановок ... ok
test_authentication_before_validation (test_auth.BearerTest.test_authentication_before_validation)
Аноним с битым JSON на защищённом endpoint получает 401, а не 400; с сессией — 400 ... ok
test_only_bearer_is_accepted (test_auth.BearerTest.test_only_bearer_is_accepted)
Нет заголовка, Basic, X-User-Id, мусорный токен -> 401 Bearer ... ok
test_scheme_is_case_insensitive (test_auth.BearerTest.test_scheme_is_case_insensitive)
@@ -75,7 +77,7 @@ test_secrets_are_not_stored_in_plaintext (test_db.DatabaseTest.test_secrets_are_
В users лежит argon2id-хеш, в sessions — sha256 токена, не сам токен ... ok
----------------------------------------------------------------------
Ran 36 tests in 11.556s
Ran 37 tests in 11.022s
OK
+10
View File
@@ -7,6 +7,7 @@ import uuid
from fastapi import Depends, FastAPI, Header, Query, Request, Response
from fastapi.exceptions import RequestValidationError
import psycopg
from starlette.concurrency import run_in_threadpool
from starlette.exceptions import HTTPException as StarletteHTTPException
import auth
@@ -21,6 +22,8 @@ log = logging.getLogger('messenger')
Limit = Annotated[int, Query(ge=1, le=100)]
Cursor = Annotated[Optional[str], Query(min_length=1)]
PUBLIC = {('POST', '/api/v1/users'), ('POST', '/api/v1/auth/sessions')}
state = {'ready': False}
@@ -67,6 +70,13 @@ async def handle_http_error(request: Request, exc: StarletteHTTPException):
@app.exception_handler(RequestValidationError)
async def handle_validation_error(request: Request, exc: RequestValidationError):
if request.url.path.startswith('/api/v1/') and (request.method, request.url.path) not in PUBLIC:
try:
await run_in_threadpool(auth.authenticate, request.headers.get('authorization'))
except ApiError as error:
return error_response(request, error.status, error.message, error.headers)
except (psycopg.OperationalError, psycopg.InterfaceError):
return error_response(request, 503, 'Хранилище временно недоступно')
errors = exc.errors()
where = '.'.join(str(part) for part in errors[0]['loc']) if errors else 'request'
return error_response(request, 400, 'Некорректный запрос: ' + where)
+6
View File
@@ -99,6 +99,12 @@ class BearerTest(unittest.TestCase):
self.assertBearerChallenge({'Authorization': 'Bearer ' + uuid.uuid4().hex})
self.assertBearerChallenge({'Authorization': 'Bearer'})
def test_authentication_before_validation(self):
"""Аноним с битым JSON на защищённом endpoint получает 401, а не 400; с сессией — 400"""
self.assertEqual(call('POST', '/api/v1/chats', raw=b'{bad')[0], 401)
self.assertEqual(call('POST', '/api/v1/chats', raw=b'{bad', token=self.alice['token'])[0], 400)
self.assertEqual(call('POST', '/api/v1/users', raw=b'{bad')[0], 400)
def test_scheme_is_case_insensitive(self):
"""Схема аутентификации нечувствительна к регистру (RFC 9110)"""
status, _, me = call('GET', '/api/v1/users/me', headers={'Authorization': 'bearer ' + self.alice['token']})