diff --git a/REPORT.md b/REPORT.md index 22e4ac1b..4a8161b9 100644 --- a/REPORT.md +++ b/REPORT.md @@ -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:`, значение `{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. План запроса истории и восстановление diff --git a/evidence/README.md b/evidence/README.md index b9059baa..ef8b205c 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -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 | diff --git a/evidence/failure.txt b/evidence/failure.txt index a2077384..684924de 100644 --- a/evidence/failure.txt +++ b/evidence/failure.txt @@ -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 обработаны diff --git a/evidence/smoke.txt b/evidence/smoke.txt index 3dd84dc0..6600b557 100644 --- a/evidence/smoke.txt +++ b/evidence/smoke.txt @@ -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. diff --git a/evidence/student-tests.txt b/evidence/student-tests.txt index 4975ee26..355ffb89 100644 --- a/evidence/student-tests.txt +++ b/evidence/student-tests.txt @@ -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 diff --git a/src/app.py b/src/app.py index 0ceb7382..99b2618c 100644 --- a/src/app.py +++ b/src/app.py @@ -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) diff --git a/student-tests/test_auth.py b/student-tests/test_auth.py index 6d339b3c..3a56ee20 100644 --- a/student-tests/test_auth.py +++ b/student-tests/test_auth.py @@ -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']})