From c4ffc8dcf3b5a6dd40df652a83e2702d27894f2c Mon Sep 17 00:00:00 2001 From: denis Date: Fri, 23 Oct 2026 22:32:15 +0300 Subject: [PATCH] fix comments --- REPORT.md | 17 ++- evidence/03-student-tests.txt | 14 +- evidence/12-clean-clone.txt | 213 +++++++++++++++++++++++++++++++ src/messenger/errorhandlers.py | 33 ++++- src/messenger/models.py | 28 +++- student-tests/README.md | 6 +- student-tests/test_auth.py | 13 ++ student-tests/test_validation.py | 18 +++ 8 files changed, 327 insertions(+), 15 deletions(-) diff --git a/REPORT.md b/REPORT.md index 2b53486c..fba3861a 100644 --- a/REPORT.md +++ b/REPORT.md @@ -52,9 +52,10 @@ make student-test BASE_URL=http://127.0.0.1:8080 PYTHON="python3 -X utf8" ``` Инструкция проверена целиком на копии репозитория без игнорируемых Git файлов: -сборка `--no-cache` 1 м 35 с, `up -d` 19 с, готовность через 1 с, `make check` и -`make validate` — PASS, `make test` — PASS, `make test-persistence` — PASS, -`make student-test` — 79 тестов OK за 28.5 с. Транскрипт — `evidence/12-clean-clone.txt`. +сборка `--no-cache` 1 м 35 с в первом прогоне и 2 м 49 с в повторном, `up -d` 8–19 с, +готовность через 1 с, `make check` и `make validate` — PASS, `make test` — PASS, +`make test-persistence` — PASS, `make student-test` — 82 теста OK за 30.9 с. +Транскрипт — `evidence/12-clean-clone.txt` (первый прогон и повторный на итоговом дереве). Три оговорки для Windows, все проверены на практике: @@ -205,6 +206,14 @@ Basic-креденшелами получил бы приглашение пов Неверный пароль и несуществующий пользователь отвечают одинаково, и время ответа выравнивается проверочным хешем, чтобы отказ не выдавал существование имени. +Валидация на границе отвергает две категории строк, которые не должны доходить до +базы: пароль из одних пробельных символов (это пустое значение обязательного поля, +а не секрет) и U+0000 в сохраняемых строках — PostgreSQL `text` его не хранит. +Обе дают 400 `invalid_request`. 503 `unavailable` закреплён только за отказами +соединения и пула (`OperationalError`, `InterfaceError`, `DisconnectionError`, +таймаут пула, ошибки Valkey): `DataError` — ошибка данных клиента — в это семейство +не входит, поэтому сбой значения не маскируется под аварию зависимости. + ### Таймауты и поведение при отказе зависимостей | Параметр | Значение | Зачем именно столько | @@ -319,7 +328,7 @@ Docker 28.0.1 (WSL2), контейнеры ограничены 2 CPU и 512 М | Автоматическая проверка неверного пароля | `test_auth` | одинаковый 401 для неверного пароля и неизвестного пользователя | `evidence/03-student-tests.txt` | | Автоматическая проверка недоступности Redis/БД | `ALLOW_OUTAGE=1 … -p test_dependency_outage.py` | все маршруты: 503 `unavailable` за 1.0–1.5 с, ни одного 401 и ни одного 200; `/health/live` остаётся 200 | `evidence/05-valkey-outage.txt`, `evidence/06-postgres-outage.txt` | | Приложение не принимает запрос анонимного пользователя как доверенный | те же прогоны | при недоступной зависимости доступа нет ни у кого: 503, а не «пустим как анонима» | `evidence/05-valkey-outage.txt`, `evidence/06-postgres-outage.txt` | -| PR собирается из чистого clone | копия без игнорируемых файлов → `up -d --build` → `make check`/`validate`/`test`/`test-persistence`/`student-test` | сборка с нуля 1 м 35 с, миграции на пустом томе, все проверки PASS, 79 тестов OK | `evidence/12-clean-clone.txt` | +| PR собирается из чистого clone | копия без игнорируемых файлов → `up -d --build` → `make check`/`validate`/`test`/`test-persistence`/`student-test` | сборка с нуля 1 м 35 с и 2 м 49 с в двух прогонах, миграции на пустом томе, все проверки PASS, 82 теста OK | `evidence/12-clean-clone.txt` | ## Эксперименты и отказы diff --git a/evidence/03-student-tests.txt b/evidence/03-student-tests.txt index 03e33289..8b0b640c 100644 --- a/evidence/03-student-tests.txt +++ b/evidence/03-student-tests.txt @@ -1,5 +1,5 @@ == 03: собственные проверки (student-tests) == -date: 2026-10-11T19:32:33Z (UTC) +date: 2026-10-23T19:19:36Z (UTC) host: Windows 10 Pro 19045, Git Bash (MSYS), python3 3.11.9; стенд поднят docker compose Что показывает: проверки поверх публичного контракта — пароли и границы их длины, @@ -52,6 +52,10 @@ test_password_length_bounds (test_auth.Registration.test_password_length_bounds) 11 и 129 кодовых точек отклоняются; 12 и 128 принимаются. ... ok test_password_may_contain_a_colon (test_auth.Registration.test_password_may_contain_a_colon) Basic разделяет только по первому двоеточию, остальное принадлежит паролю. ... ok +test_surrounding_spaces_are_part_of_the_password (test_auth.Registration.test_surrounding_spaces_are_part_of_the_password) +Пароль не обрезается: пробелы по краям значат то же, что и любые другие символы. ... ok +test_whitespace_only_password_is_refused (test_auth.Registration.test_whitespace_only_password_is_refused) +Двенадцать пробелов — пустое значение обязательного поля, а не пароль. ... ok test_a_valid_chat_is_created_whole (test_chat_atomicity.ChatCreation.test_a_valid_chat_is_created_whole) ... ok test_creator_must_be_a_member (test_chat_atomicity.ChatCreation.test_creator_must_be_a_member) ... ok test_duplicate_members_are_refused (test_chat_atomicity.ChatCreation.test_duplicate_members_are_refused) ... ok @@ -62,7 +66,7 @@ test_liveness_stays_green_throughout (test_dependency_outage.DependencyOutage.te Отказ зависимости не должен выглядеть для супервизора смертью процесса. ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры' test_postgres_outage (test_dependency_outage.DependencyOutage.test_postgres_outage) ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры' test_valkey_outage (test_dependency_outage.DependencyOutage.test_valkey_outage) ... skipped 'задайте ALLOW_OUTAGE=1 для запуска: этот модуль останавливает контейнеры' - api пересоздан с SESSION_TTL_SECONDS=3, готов через 3.72s + api пересоздан с SESSION_TTL_SECONDS=3, готов через 3.73s test_a_token_issued_before_the_change_still_works (test_expiry.ShortLivedSessions.test_a_token_issued_before_the_change_still_works) Пересоздание API не выдаёт новые сессии и не продлевает старые. ... у токена, выданного до переключения, осталось 3596s из исходных 3600s ok @@ -73,7 +77,7 @@ test_expiry_does_not_need_a_cleanup_job (test_expiry.ShortLivedSessions.test_exp ok test_the_short_ttl_is_the_one_in_force (test_expiry.ShortLivedSessions.test_the_short_ttl_is_the_one_in_force) ... expires_at через 3.00s, ключ в Valkey живёт 3s: сроком владеет хранилище, а не процесс ok - api пересоздан с SESSION_TTL_SECONDS=3600, готов через 3.80s + api пересоздан с SESSION_TTL_SECONDS=3600, готов через 3.78s test_error_envelope_carries_a_request_id (test_health.Probes.test_error_envelope_carries_a_request_id) ... ok test_every_probe_gets_its_own_request_id (test_health.Probes.test_every_probe_gets_its_own_request_id) ... ok test_liveness (test_health.Probes.test_liveness) ... ok @@ -114,6 +118,8 @@ test_broken_json_is_refused_without_echoing_it (test_validation.RequestBodies.te test_display_name_and_title_limits (test_validation.RequestBodies.test_display_name_and_title_limits) ... ok test_message_text_limits (test_validation.RequestBodies.test_message_text_limits) ... ok test_missing_required_fields (test_validation.RequestBodies.test_missing_required_fields) ... ok +test_nul_is_refused_before_it_reaches_the_store (test_validation.RequestBodies.test_nul_is_refused_before_it_reaches_the_store) +U+0000 не хранится в `text`: это 400, а не ложная недоступность базы. ... ok test_sender_id_cannot_be_injected (test_validation.RequestBodies.test_sender_id_cannot_be_injected) ... ok test_the_password_never_appears_in_an_error (test_validation.RequestBodies.test_the_password_never_appears_in_an_error) ... ok test_unknown_json_field_is_refused (test_validation.RequestBodies.test_unknown_json_field_is_refused) ... ok @@ -122,6 +128,6 @@ test_unknown_route (test_validation.Routing.test_unknown_route) ... ok test_wrong_method (test_validation.Routing.test_wrong_method) ... ok ---------------------------------------------------------------------- -Ran 79 tests in 29.377s +Ran 82 tests in 30.188s OK (skipped=3) diff --git a/evidence/12-clean-clone.txt b/evidence/12-clean-clone.txt index 026f4abe..8dc111df 100644 --- a/evidence/12-clean-clone.txt +++ b/evidence/12-clean-clone.txt @@ -564,3 +564,216 @@ $ cd /c/Users/denis/Desktop/HighLoad/mtusi2026lab2 && docker compose start # основной стенд: готов через 2 с Копия после прогона удалена: C:/Users/denis/AppData/Local/Temp/lab2-clean-clone + +== 12б: повторный прогон из чистого clone после исправления валидации == +date: 2026-10-23T19:25:46Z (UTC) +host: Windows 10 Pro 19045, x64, Git Bash; Docker 28.0.1 (Docker Desktop, WSL2) + +Зачем: после транскрипта выше добавлены три регрессионных теста — пароль только из +пробельных символов и U+0000 в сохраняемых строках дают 400 invalid_request, — а +503 unavailable сужен до отказов соединения и пула. Ниже тот же сценарий целиком +на итоговом дереве: снова копия без игнорируемых Git файлов, сборка без кэша, +пустой том и все проверки. Инфраструктура и последовательность команд не менялись. + +$ docker compose stop # в основном репозитории: освобождаем порт 8080 и имя проекта + Container mtusi2026lab2-api-1 Stopping + Container mtusi2026lab2-api-1 Stopped + Container mtusi2026lab2-migrate-1 Stopping + Container mtusi2026lab2-valkey-1 Stopping + Container mtusi2026lab2-migrate-1 Stopped + Container mtusi2026lab2-postgres-1 Stopping + Container mtusi2026lab2-postgres-1 Stopped + Container mtusi2026lab2-valkey-1 Stopped + +$ mkdir -p /c/Users/denis/AppData/Local/Temp/lab2-clean-clone && tar -c --exclude=.git --exclude=.venv --exclude=secrets \ + --exclude=.env --exclude=__pycache__ --exclude="*.pyc" . | tar -x -C /c/Users/denis/AppData/Local/Temp/lab2-clean-clone +скопировано: 98 файлов + +$ cd /c/Users/denis/AppData/Local/Temp/lab2-clean-clone +$ cp .env.example .env && sh scripts/bootstrap-secrets.sh +create secrets/postgres_password +create secrets/cursor_secret +create secrets/cache_url +create secrets/database_url +done: /c/Users/denis/AppData/Local/Temp/lab2-clean-clone/secrets +next: docker compose up -d --build + +$ docker compose --env-file .env config --quiet # валидность до сборки +config: OK + +$ time docker compose --env-file .env build --no-cache +#27 [api] resolving provenance for metadata file +#27 DONE 0.0s + api Built + migrate Built + +real 2m49.033s +user 0m0.030s +sys 0m0.076s + +$ time docker compose --env-file .env up -d +$ time docker compose --env-file .env up -d + Network lab2-clean-clone_backend Creating + Network lab2-clean-clone_backend Created + Volume "lab2-clean-clone_pgdata" Creating + Volume "lab2-clean-clone_pgdata" Created + Volume "lab2-clean-clone_valkeydata" Creating + Volume "lab2-clean-clone_valkeydata" Created + Container lab2-clean-clone-postgres-1 Creating + Container lab2-clean-clone-valkey-1 Creating + Container lab2-clean-clone-postgres-1 Created + Container lab2-clean-clone-migrate-1 Creating + Container lab2-clean-clone-valkey-1 Created + Container lab2-clean-clone-migrate-1 Created + Container lab2-clean-clone-api-1 Creating + Container lab2-clean-clone-api-1 Created + Container lab2-clean-clone-postgres-1 Starting + Container lab2-clean-clone-valkey-1 Starting + Container lab2-clean-clone-valkey-1 Started + Container lab2-clean-clone-postgres-1 Started + Container lab2-clean-clone-postgres-1 Waiting + Container lab2-clean-clone-postgres-1 Healthy + Container lab2-clean-clone-migrate-1 Starting + Container lab2-clean-clone-migrate-1 Started + Container lab2-clean-clone-valkey-1 Waiting + Container lab2-clean-clone-migrate-1 Waiting + Container lab2-clean-clone-postgres-1 Waiting + Container lab2-clean-clone-valkey-1 Healthy + Container lab2-clean-clone-postgres-1 Healthy + Container lab2-clean-clone-migrate-1 Exited + Container lab2-clean-clone-api-1 Starting + Container lab2-clean-clone-api-1 Started + +real 0m7.912s +user 0m0.000s +sys 0m0.106s + +Ожидание готовности: опрос GET /health/ready раз в секунду +готов через 1 с +$ curl -s http://127.0.0.1:8080/health/ready +{"status":"ok"} + +$ docker compose --env-file .env ps --all +lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 8 seconds ago Up 1 second (health: starting) 127.0.0.1:8080->8080/tcp +lab2-clean-clone-migrate-1 mtusi-messenger-lab2:2.0.0 "alembic upgrade head" migrate 8 seconds ago Exited (0) 1 second ago +lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres 9 seconds ago Up 8 seconds (healthy) 5432/tcp +lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey 9 seconds ago Up 8 seconds (healthy) 6379/tcp + +$ python3 -m venv .venv && .venv/Scripts/python.exe -m pip install --quiet -r requirements-dev.txt +sys 0m0.015s +Python 3.11.9 + +$ make check +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. + +$ make validate PYTHON=.venv/Scripts/python.exe +.venv/Scripts/python.exe scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. + +$ make test BASE_URL=http://127.0.0.1:8080 +python3 tests/smoke.py --base-url "http://127.0.0.1:8080" +PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. + +$ make test-persistence ACTION_SCRIPT=scripts/restart.cmd BASE_URL=http://127.0.0.1:8080 +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.cmd" --base-url "http://127.0.0.1:8080" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. + +$ sh scripts/restart.sh # тот же хук из POSIX-оболочки +lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 59 seconds ago Up Less than a second (health: starting) 127.0.0.1:8080->8080/tcp +lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres About a minute ago Up Less than a second (health: starting) 5432/tcp +lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey About a minute ago Up Less than a second (health: starting) 6379/tcp +running services: api postgres valkey +restart complete + +$ time make student-test BASE_URL=http://127.0.0.1:8080 PYTHON="python3 -X utf8" + +---------------------------------------------------------------------- +Ran 82 tests in 30.852s + +OK (skipped=3) + +real 0m31.300s +user 0m0.015s +sys 0m0.000s + +Полный построчный вывод этих же 82 тестов — в доказательстве 03 (тот же запуск +на итоговом дереве; здесь только итог, чтобы не дублировать 130 строк). + +$ docker compose --env-file .env stop # безопасная остановка: тома остаются + Container lab2-clean-clone-valkey-1 Stopping + Container lab2-clean-clone-migrate-1 Stopping + Container lab2-clean-clone-migrate-1 Stopped + Container lab2-clean-clone-postgres-1 Stopping + Container lab2-clean-clone-postgres-1 Stopped + Container lab2-clean-clone-valkey-1 Stopped + +$ docker volume ls --filter name=lab2-clean-clone --format "{{.Name}}" +lab2-clean-clone_pgdata +lab2-clean-clone_valkeydata + +$ docker compose --env-file .env start # данные на месте, стенд снова жив +$ docker compose --env-file .env start + Container lab2-clean-clone-valkey-1 Starting + Container lab2-clean-clone-postgres-1 Starting + Container lab2-clean-clone-valkey-1 Started + Container lab2-clean-clone-postgres-1 Started + Container lab2-clean-clone-postgres-1 Waiting + Container lab2-clean-clone-postgres-1 Healthy + Container lab2-clean-clone-migrate-1 Starting + Container lab2-clean-clone-migrate-1 Started + Container lab2-clean-clone-migrate-1 Waiting + Container lab2-clean-clone-postgres-1 Waiting + Container lab2-clean-clone-valkey-1 Waiting + Container lab2-clean-clone-valkey-1 Healthy + Container lab2-clean-clone-postgres-1 Healthy + Container lab2-clean-clone-migrate-1 Exited + Container lab2-clean-clone-api-1 Starting + Container lab2-clean-clone-api-1 Started + +$ docker compose --env-file .env ps --all +NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS +lab2-clean-clone-api-1 mtusi-messenger-lab2:2.0.0 "python -m messenger" api 27 seconds ago Up Less than a second (health: starting) 127.0.0.1:8080->8080/tcp +lab2-clean-clone-migrate-1 mtusi-messenger-lab2:2.0.0 "alembic upgrade head" migrate About a minute ago Exited (0) Less than a second ago +lab2-clean-clone-postgres-1 postgres:16.15-bookworm@sha256:0ea6700a3b4f0ae6ce746519073558aed4d88a79d8d07622a9a644946c7319c4 "docker-entrypoint.s…" postgres About a minute ago Up 7 seconds (healthy) 5432/tcp +lab2-clean-clone-valkey-1 valkey/valkey:8.0.11-trixie@sha256:4436c94fc34ce4af0354b9379d433a1f258998fb955f995c89822f98c14a8cab "tini -- docker-entr…" valkey About a minute ago Up 7 seconds (healthy) 6379/tcp + +$ docker compose --env-file .env down # удаляет контейнеры, но не тома +$ docker compose --env-file .env down + Container lab2-clean-clone-api-1 Stopping + Container lab2-clean-clone-api-1 Stopped + Container lab2-clean-clone-api-1 Removing + Container lab2-clean-clone-api-1 Removed + Container lab2-clean-clone-valkey-1 Stopping + Container lab2-clean-clone-migrate-1 Stopping + Container lab2-clean-clone-migrate-1 Stopped + Container lab2-clean-clone-migrate-1 Removing + Container lab2-clean-clone-migrate-1 Removed + Container lab2-clean-clone-postgres-1 Stopping + Container lab2-clean-clone-valkey-1 Stopped + Container lab2-clean-clone-valkey-1 Removing + Container lab2-clean-clone-postgres-1 Stopped + Container lab2-clean-clone-postgres-1 Removing + Container lab2-clean-clone-valkey-1 Removed + Container lab2-clean-clone-postgres-1 Removed + Network lab2-clean-clone_backend Removing + Network lab2-clean-clone_backend Removed + +$ docker compose --env-file .env down -v # намеренное удаление учебных данных +$ docker compose --env-file .env down -v + Volume lab2-clean-clone_valkeydata Removing + Volume lab2-clean-clone_pgdata Removing + Volume lab2-clean-clone_valkeydata Removed + Volume lab2-clean-clone_pgdata Removed + +$ docker volume ls --filter name=lab2-clean-clone --format "{{.Name}}" +(пусто) + +$ cd /c/Users/denis/Desktop/HighLoad/mtusi2026lab2 && docker compose start # возвращаем основной стенд +$ docker compose ps --format "{{.Service}} {{.State}} {{.Health}}" +api running healthy +postgres running healthy +valkey running healthy +$ curl -s http://127.0.0.1:8080/health/ready +{"status":"ok"} diff --git a/src/messenger/errorhandlers.py b/src/messenger/errorhandlers.py index 4a8c6826..2e0048a7 100644 --- a/src/messenger/errorhandlers.py +++ b/src/messenger/errorhandlers.py @@ -9,7 +9,8 @@ from fastapi import FastAPI, Request from fastapi.exceptions import RequestValidationError from fastapi.responses import JSONResponse from redis.exceptions import RedisError -from sqlalchemy.exc import SQLAlchemyError +from sqlalchemy.exc import DataError, DisconnectionError, InterfaceError, OperationalError +from sqlalchemy.exc import TimeoutError as PoolTimeoutError from starlette.exceptions import HTTPException as StarletteHTTPException from .context import REQUEST_ID, request_context @@ -24,8 +25,20 @@ FALLBACK_MESSAGES: Mapping[int, str] = { # Отказ критичной зависимости (PostgreSQL или Valkey): наружу 503 без деталей, # подробности остаются в логе. Для клиента «сессии недоступны» и «база недоступна» # выглядят одинаково — и это правильно, различать их он не должен. -DEPENDENCY_ERRORS = (SQLAlchemyError, RedisError, OSError) +# +# Здесь только отказы соединения и исчерпание пула. Более широкий SQLAlchemyError +# сюда не годится: он включает DataError, и тогда значение, которое PostgreSQL +# не может принять, выглядело бы как недоступность базы. +DEPENDENCY_ERRORS = ( + OperationalError, + InterfaceError, + DisconnectionError, + PoolTimeoutError, + RedisError, + OSError, +) DEPENDENCY_MESSAGE = "Сервис временно недоступен: критичная зависимость не отвечает" +DATA_ERROR_MESSAGE = "Значение поля не может быть сохранено" def request_id_of(request: Request) -> str: @@ -112,6 +125,22 @@ def register_error_handlers(app: FastAPI, logger: logging.Logger) -> None: ) return error_response(request, 503, UNAVAILABLE, DEPENDENCY_MESSAGE) + @app.exception_handler(DataError) + async def handle_data_error(request: Request, exc: DataError) -> JSONResponse: + """Данные клиента, которые СУБД не в состоянии сохранить, — это 400. + + На границе такие значения уже отсекаются; обработчик оставлен страховкой, + чтобы ошибка данных никогда не выдавалась за отказ зависимости. + """ + log( + logger, + logging.WARNING, + "invalid_stored_value", + request_id=request_id_of(request), + error=type(exc).__name__, + ) + return error_response(request, 400, INVALID_REQUEST, DATA_ERROR_MESSAGE) + for error_type in DEPENDENCY_ERRORS: app.add_exception_handler(error_type, handle_dependency_failure) diff --git a/src/messenger/models.py b/src/messenger/models.py index b8d56de9..c96972de 100644 --- a/src/messenger/models.py +++ b/src/messenger/models.py @@ -20,10 +20,23 @@ MAX_LIMIT = 100 DEFAULT_LIMIT = 50 -def _visible(value: str, *, field: str, maximum: int) -> str: - """Проверяет длину в code points и запрещает строки только из пробельных символов.""" +def _require_content(value: str, *, field: str) -> str: + """Обязательная строка не может быть пустой или состоять из пробельных символов.""" if not value.strip(): raise ValueError(f"{field} must not be empty or contain only whitespace") + return value + + +def _visible(value: str, *, field: str, maximum: int) -> str: + """Проверяет строку, которую предстоит сохранить в PostgreSQL. + + U+0000 отвергается на границе: тип `text` его не хранит, и без этой проверки + ошибка данных клиента дошла бы до обработчика ошибок базы, где выглядела бы + отказом зависимости. + """ + _require_content(value, field=field) + if "\u0000" in value: + raise ValueError(f"{field} must not contain U+0000") if len(value) > maximum: raise ValueError(f"{field} must be at most {maximum} Unicode code points") return value @@ -71,6 +84,17 @@ class CreateUser(BaseModel): def _check_display_name(cls, value: str) -> str: return _visible(value, field="display_name", maximum=MAX_DISPLAY_NAME) + @field_validator("password") + @classmethod + def _check_password(cls, value: str) -> str: + """Пароль из одних пробелов — пустое значение, а не секрет. + + Пробелы внутри и по краям допустимы и не обрезаются: при входе пароль + сверяется целиком. U+0000 здесь не проверяется: в PostgreSQL попадает + только хэш, а не сам пароль. + """ + return _require_content(value, field="password") + class Session(BaseModel): """Выданная сессия: токен показывается клиенту один раз и в логи не попадает.""" diff --git a/student-tests/README.md b/student-tests/README.md index 90107942..772014dc 100644 --- a/student-tests/README.md +++ b/student-tests/README.md @@ -35,7 +35,7 @@ python3 -u -X utf8 student-tests/valkey_crash.py | --- | --- | --- | | `harness.py` | Обвязка: клиент публичного `tests/client.py`, регистрация и вход, `psql` и `valkey-cli` внутри контейнеров, ожидание готовности. Не тест. | — | | `run_all.py` | Запуск всего каталога, включая `--pattern` для одного модуля. Включает построчный вывод. Не тест. | — | -| `test_auth.py` | Пароль обязателен и ограничен 12..128 символами; границы 11/12/128/129; кириллица и 128 эмодзи (доказательство, что KDF не режет по 72 байтам); `:` в пароле не ломает Basic; неверный пароль и неизвестный пользователь неразличимы; Basic на бизнес-маршруте → 401 **с Bearer**-челленджем; `X-User-Id` не даёт доступа. | 14 | +| `test_auth.py` | Пароль обязателен и ограничен 12..128 символами; границы 11/12/128/129; пароль из одних пробелов отклоняется, а пробелы по краям не обрезаются; кириллица и 128 эмодзи (доказательство, что KDF не режет по 72 байтам); `:` в пароле не ломает Basic; неверный пароль и неизвестный пользователь неразличимы; Basic на бизнес-маршруте → 401 **с Bearer**-челленджем; `X-User-Id` не даёт доступа. | 16 | | `test_sessions.py` | Форма ответа `Session`; у одного пользователя несколько независимых сессий; отзыв одной не трогает другую; logout → 204 без тела; повтор logout → 401; 16 входов подряд дают 16 разных токенов. | 10 | | `test_expiry.py` | Реальный срок жизни при `SESSION_TTL_SECONDS=3`: токен, выданный до смены TTL, продолжает работать после пересоздания контейнера; после истечения отвергается и на бизнес-маршруте, и на logout; ключ исчезает из Valkey сам; `expires_at` в ответе согласован с TTL ключа. Стенд возвращается к прежнему TTL. | 4 | | `test_dependency_outage.py` | Остановка Valkey и остановка PostgreSQL: бизнес-маршруты и `/health/ready` отвечают 503 `unavailable` быстрее 2 с, `/health/live` остаётся 200, анонимом никто не становится; после старта тот же токен снова работает, данные на месте. Только при `ALLOW_OUTAGE=1`. | 3 | @@ -43,14 +43,14 @@ python3 -u -X utf8 student-tests/valkey_crash.py | `test_chat_atomicity.py` | Создание чата — одна транзакция: неизвестный участник, дубликат в списке и отсутствие создателя дают 400, и чата после этого нет. | 6 | | `test_pagination.py` | Keyset-пагинация: каждая запись ровно один раз, порядок из контракта, `has_more`/`next_cursor`, лимиты 1 и 100, страница за концом истории, чужой курсор. | 9 | | `test_access.py` | Чужой чат и несуществующий чат отвечают одинаково (404, никогда 403); участник видит историю, посторонний — нет. | 9 | -| `test_validation.py` | Некорректные запросы: всегда конверт `{"error":{...}}`, никогда 422 или трейсбек; лишние поля запрещены; битый JSON; пустые строки и слишком длинные значения. | 15 | +| `test_validation.py` | Некорректные запросы: всегда конверт `{"error":{...}}`, никогда 422 или трейсбек; лишние поля запрещены; битый JSON; пустые строки и слишком длинные значения; U+0000 в сохраняемых строках → 400, а не 503. | 16 | | `test_health.py` | Что отвечают пробы здоровья, что им нужно для 200 и чего они не делают (live не зависит от зависимостей). | 6 | | `verify_stack.py` | Инфраструктура работающего стенда: uid 10001 и PID 1 не от root, порты PG и Valkey не публикуются, секреты файлами и без утечки в `compose config`, AOF и `everysec`, схема, индексы и CHECK-ограничения, идемпотентность миграций, отсутствие секретов в логах, лимиты и `restart`. Не unittest — печатает проверки и возвращает код. | 52 проверки | | `valkey_crash.py` | Падение, а не остановка: `kill -9` процессу valkey-server внутри контейнера (политика `restart` поднимает его сама, AOF возвращает сессию) и `docker compose kill` снаружи (контейнер не поднимается — нужен оператор). Заодно измеряет окно потери около секунды при `appendfsync everysec`. Управляет контейнерами, поэтому запускается явно. | 11 проверок | | `seed_messages.py` | Засев данных для экспериментов: ≥10 000 сообщений, пары с одинаковым `created_at` для проверки ничьей по `id`, чаты разной длины. | — | | `explain_queries.py` | Планы запросов: индекс на истории, отказ планировщика от него без индекса, цена `OFFSET` против keyset, индекс «моих чатов». Пишет PASS/FAIL по каждой проверке. | 20 проверок | -Всего 79 тестов unittest: 76 идут всегда, 3 (отказ зависимостей) — только с +Всего 82 теста unittest: 79 идут всегда, 3 (отказ зависимостей) — только с `ALLOW_OUTAGE=1`. ## Покрытие критериев уровня 4 diff --git a/student-tests/test_auth.py b/student-tests/test_auth.py index 05594c4a..a753f856 100644 --- a/student-tests/test_auth.py +++ b/student-tests/test_auth.py @@ -52,6 +52,19 @@ class Registration(unittest.TestCase): session = harness.login(self.api, payload["username"], secret) self.assertEqual(session["user"]["username"], payload["username"]) + def test_whitespace_only_password_is_refused(self): + """Двенадцать пробелов — пустое значение обязательного поля, а не пароль.""" + response = self.api.call("POST", "/api/v1/users", [400], body=self.body(" " * 12, "blank")) + self.assertEqual(response["json"]["error"]["code"], "invalid_request") + + def test_surrounding_spaces_are_part_of_the_password(self): + """Пароль не обрезается: пробелы по краям значат то же, что и любые другие символы.""" + secret = " " + "a" * 10 + " " + payload = self.body(secret, "spaced") + self.api.call("POST", "/api/v1/users", 201, body=payload) + self.assertEqual(harness.login(self.api, payload["username"], secret)["token_type"], + "Bearer") + def test_password_is_checked_to_the_last_byte(self): """Пароль длиннее 72 байт не усекается KDF. diff --git a/student-tests/test_validation.py b/student-tests/test_validation.py index 4dc3f7ae..eeb4d907 100644 --- a/student-tests/test_validation.py +++ b/student-tests/test_validation.py @@ -69,6 +69,24 @@ class RequestBodies(unittest.TestCase): with self.subTest(path=path, length=len(str(body))): self.assert_invalid(self.api.call("POST", path, [400], actor=self.alice, body=body)) + def test_nul_is_refused_before_it_reaches_the_store(self): + """U+0000 не хранится в `text`: это 400, а не ложная недоступность базы.""" + nul = "x\u0000y" + self.assert_invalid(self.api.call( + "POST", "/api/v1/users", [400], + body={"username": harness.unique("nul"), "display_name": nul, + "password": harness.fresh_password()}, + )) + self.assert_invalid(self.api.call( + "POST", "/api/v1/chats", [400], actor=self.alice, + body={"title": nul, "member_ids": [self.alice["id"]]}, + )) + chat = harness.chat(self.api, self.alice, [], title="NUL в сообщении") + self.assert_invalid(self.api.call( + "POST", "/api/v1/chats/" + chat["id"] + "/messages", [400], + actor=self.alice, body={"text": nul}, + )) + def test_message_text_limits(self): chat = harness.chat(self.api, self.alice, [], title="Лимиты текста") for text in ("x" * 4001, " ", ""):