Проверка требований лабораторной 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 сохранены как исторический эксперимент отдельной сборки и не пересчитывались.