Files
mtusi2026lab2/evidence/levels-3-4

Проверка требований лабораторной 2: уровни «3» и «4»

Итог: 16 из 16 групп проверок PASS на исправленной сборке. Команды и исходные результаты сохранены; существующие публичные проверки выполнены без изменений. Это подтверждение перечисленных сценариев на указанном стенде, а не гарантия отсутствия любых ошибок.

Идентификация и изоляция

  • Период: 2026-11-06T10:43:16.282804Z — 2026-11-06T10:44:52.582387Z UTC.
  • Базовый commit: 711754bbcd6e47a7b83d7f5c922f5f37f6bc0764; проверялось рабочее дерево с незакоммиченными исправлениями.
  • Docker image ID: sha256:0effe11ab9f4d860b5b79d6096ff95325336c752c0d5ca335878ec89baf4f269.
  • SHA-256 исходников Go и миграций: 11bd17ca0b86a6db845ec7c2954c91fd8a870e1999ca45d708a546f0f863fb0e. Алгоритм: отсортированные пути всех service/**/*.go, затем миграций service/migrations/*.sql; для каждого относительный путь UTF-8, нулевой байт, содержимое файла.
  • Docker Engine 29.7.2; linux/aarch64 CPUs=14 memory_bytes=8320954368; отдельные CPU/RAM limits не задавались.
  • Проект: lab2-verify-20261106t104316z-ed3f45, порт хоста 18084; собственные PostgreSQL 17.11, Redis 8.2.11, два новых именованных volume и отдельная пара RSA-ключей.

Основной проект на порту 8080 не перезапускался, его данные не использовались и не удалялись. Доступ к тестовому проекту и повторяемая генерация данных описаны в скрипте. Пароли и ключи сохранены локально в игнорируемом secrets/levels-3-4/<run_id>/; значения и токены в evidence не экспортируются.

Воспроизведение

Требуются Docker Compose v2 с --wait, Python 3.9+, OpenSSL, Make; на Linux — setfacl. В корне проекта:

python3 scripts/verify_lab2.py --port 18084 --output evidence/levels-3-4-repeat

--output выше сохраняет новый прогон отдельно от этих результатов. Для первоначального сохранённого прогона использовались значения по умолчанию: python3 scripts/verify_lab2.py.

Сценарий создаёт уникальный Compose-проект, env-файл с случайными паролями и отдельные ключи. Исполняет make check, make test BASE_URL=http://127.0.0.1:18084 и make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://127.0.0.1:18084. Hook получает COMPOSE_PROJECT_NAME, COMPOSE_ENV_FILE и COMPOSE_OVERRIDE_FILE, поэтому пересоздаёт именно проверочный стенд. В конце возвращает конфигурацию с TTL 3600 и пулом 10, проверяет готовность, затем выполняет down без --volumes. При ошибке восстановление и остановка также выполняются через finally. Сохранённые volumes остаются для изучения; каждый следующий прогон получает новые.

Результаты по группам

Ключ в summary.json Проверка Результат Время группы, с
fresh_build_and_start Новые volumes, сборка и запуск с нуля PASS 35.497
public_check_and_smoke make check и публичный make test PASS 1.398
schema_kdf_and_session_randomness Схема, ограничения, Argon2id и случайность токена PASS 0.873
configuration_compatibility SESSION TTL: default, legacy, приоритет и ошибки конфигурации PASS 4.543
contract_validation_edges 14 отрицательных случаев валидации контракта PASS 0.396
repeat_migrations Повторные миграции без изменения данных PASS 0.877
full_persistence Полный рестарт API, PostgreSQL, Redis и прежняя сессия PASS 25.771
username_registration_race Гонка восьми регистраций одного username PASS 0.264
chat_creation_rollback Rollback после INSERT чата при ошибке FK участников PASS 0.317
history_20000_and_explain 20 001 сообщение, EXPLAIN и полный обход API PASS 10.792
session_expiry_seconds SESSION_TTL_SECONDS=2: 200 → 401 PASS 2.896
additional_authentication Подделанная подпись и неизвестный пользователь PASS 0.004
redis_cache_and_failure Кэш, 404 постороннему, отказ и восстановление Redis PASS 1.697
postgres_failure_and_recovery Отказ PostgreSQL, 503/401, readiness/liveness и восстановление PASS 0.552
pool_limit_and_sql_deadline Лимит пула и deadline заблокированного SQL PASS 3.628
tracked_secrets_and_contract_audit Отсутствие приватного состояния в tracked tree; неизменность задания/контракта/tests PASS 0.078

checks.txt содержит реальный stdout/stderr команд сборки и публичных проверок с exit codes. Вывод restart-hook подавляется самим публичным persistence-тестом; факт пересоздания сервисов подтверждается разными ID API/PostgreSQL/Redis до и после при совпадающих именах volumes в summary.json.

Уровень «3»

Схема содержит users, refresh_tokens, chats, chat_members, messages и versions. Версия миграций — 5, присутствуют PK, четыре FK и уникальность username: schema.txt. Повторный запуск API сохранил количества пользователей, чатов, участников, сообщений, сессий и версию миграций без изменений.

Публичный smoke проверил регистрацию, конфликт username, доступ участников, запрет постороннему, сообщение, пагинацию и ошибки, неверный пароль, отказ Basic на private endpoint, отказ одного X-User-Id, невозможность подменить Bearer-пользователя другим X-User-Id, logout и повторное использование отозванного токена. Все эти проверки завершились PASS.

Persistence пересоздал все три сервиса с прежними volumes. Подтверждённые данные и сессия публичного теста сохранились. Дополнительно прежняя собственная сессия клиента сценария прочитала прежнего пользователя, а другой участник прочитал ранее подтверждённое сообщение.

Проверка БД выявила профиль пароля Argon2id m=65536,t=3,p=4. Полный хэш и пароль не сохранялись. Новые JWT содержат nonce из 32 случайных байт crypto/rand; проверены размер декодированного поля и подпись. Это обоснование 256 бит случайных данных по источнику генерации, а не статистическая оценка энтропии выборки. Неизвестный username и токен с изменённой подписью получили 401.

Исправлен HTTP-статус ошибок валидации: неверный UUID возвращает контрактный 400 вместо прежнего 422. Дополнительные отрицательные сценарии включают cursor/limit, неизвестные поля, запрет sender_id, некорректные поля пользователя, malformed JSON и неподдерживаемый Content-Type.

Уровень «4»

Гонка 8 регистраций одного username дала ровно 1 × 201, 7 × 409 и одну строку БД. При создании чата с неизвестным участником INSERT чата выполнялся до FK-ошибки INSERT участников; ответ — 400, количества всех таблиц до/после равны. Частичный чат не сохранился.

В истории создано 20 000 синтетических сообщений дополнительно к одному ранее подтверждённому, итого 20 001. После ANALYZE первая страница и страница после позиции 10 000 имеют Limit → Index Scan, индекс idx_messages_chat_id_created_at_id, без Seq Scan таблицы messages:

Страница Записей плана Execution Time, мс Доказательства
Первая 101 0.04 Текст, JSON
Глубокая 101 0.082 Текст, JSON

Использован запрос репозитория с фильтром chat_id, tuple cursor (created_at,id), ORDER BY и LIMIT 101; OFFSET используется только для подготовки значения курсора наблюдателем, а не в исследуемом запросе API. Полный обход API страницами по 100 вернул все 20 001 ID в правильном порядке, без пропусков и дублей. Execution Time в таблице — время одного конкретного EXPLAIN, не универсальная оценка latency.

SESSION_TTL_SECONDS=2 имеет приоритет над legacy JWT_REFRESH_TOKEN_LIFETIME=24h: новая сессия дала 200 до истечения и 401 после expires_at. Проверены default 3600 секунд, legacy 86400 и приоритет 2 секунд даже при некорректном legacy значении. Пять некорректных конфигураций отвергнуты до запуска сервера: нулевой и нечисловой SESSION TTL, нулевой пул, connect timeout и query timeout.

Кэш дал один chat_db_lookup в последовательности miss → hit, посторонний получил 404. Подсчёт здесь выполнен по диагностике ветки кода, а не pg_stat_statements. Без Redis авторизованный GET вернул 200 за 62.898 мс, анонимный — 401. API также пересоздан при остановленном Redis и продолжил работать. После старта Redis удалён только тестовый ключ и подтверждено повторное заполнение кэша.

При остановке PostgreSQL после прогрева кэша действующая сессия получила 503 unavailable за 2.511 мс, анонимный запрос и неверный Bearer — 401. Readiness вернул 503 за 10.516 мс, liveness остался 200. После запуска БД прежняя сессия вновь прочитала чат.

При временном лимите пула 2 восемь параллельных запросов к заблокированной таблице наблюдали максимум ровно два соединения приложения. Все получили 503 через 2005.983–2008.694 мс. Затем блокировка освобождена, лимит возвращён к 10, доступ восстановлен. В startup.txt зафиксированы фактически применённые MaxConns=10, connect timeout=500ms и statement_timeout=2000ms. Общий контекст бизнес-запроса также ограничен двумя секундами; наблюдаемые дополнительные миллисекунды относятся к обработке и передаче ответа.

Файлы и ограничения

  • summary.json: статусы, численные результаты, исходная версия, образ, SHA-256, IDs контейнеров и имена сохранённых volumes.
  • http.csv: статусы, пути, времена и request IDs дополнительных HTTP-проверок; тела, пароли и Authorization отсутствуют. Встроенные запросы публичных проверок здесь не дублируются, их stdout находится в checks.txt.
  • checks.txt, startup.txt, schema.txt и четыре файла EXPLAIN — первичные текстовые результаты.

Все проверки — на одной API-реплике и синтетических данных. Исследованы корректные restarts и stop сервисов, а не потеря диска/питания, HA, backup/restore или сетевой blackhole. Политика кэша остаётся прежней: PostgreSQL — источник истины, TTL отсутствует, обязательный API не меняет членство; при добавлении изменения участников потребуется инвалидация. История Git полностью не сертифицировалась; автоматический аудит охватывает текущее отслеживаемое дерево и новые материалы. Старые результаты stampede сохранены как исторический эксперимент отдельной сборки и не пересчитывались.