Проверять аутентификацию раньше валидации тела запроса
This commit is contained in:
@@ -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
@@ -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
@@ -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
@@ -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.
|
||||
|
||||
@@ -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
@@ -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)
|
||||
|
||||
@@ -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']})
|
||||
|
||||
Reference in New Issue
Block a user