Files
mtusi2026lab7/tests/README.md
T
2026-11-04 19:22:35 +03:00

71 lines
9.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Проверки lab7
HTTP проверки выполняются против запущенного Compose стенда; они не создают его автоматически. Клиенты Python используют стандартную библиотеку; сервер и unit tests требуют runtime зависимостей из `requirements.txt`. Полная OpenAPI-валидация отдельно: `make validate` после установки `requirements-dev.txt` в venv.
```sh
make check
make test BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
make test-security BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
make test-primitives
make test-internal-mtls
make test-login-limit BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
make test-openbao-acl PYTHON=.venv/bin/python
make test-worker-isolation
make test-worker-rotation PYTHON=.venv/bin/python ROOT_TOKEN_FILE=/secure/path/openbao-root-token
make test-leaf-rotation PYTHON=.venv/bin/python
make test-telemetry-redaction PYTHON=.venv/bin/python BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
make test-argon-budget
.venv/bin/pip-audit -r requirements.txt
```
`smoke.py` выполняет **один сквозной сценарий**, автоматически выбирая профиль из `lab.json`: health → три пользователя → вход с lab2 → чат → сообщения → пагинация → ошибки доступа → идемпотентность с lab3 → файл с lab4 → thumbnail с lab5 → logout. Он проверяет JSON по используемому подмножеству схемы, коды/headers, Unicode, SHA-256 оригинала и фактические JPEG-размеры thumbnail. Это публичный минимум, не полный fuzz/security/load suite.
Каждый запуск создаёт уникальных синтетических пользователей, чат и сообщения. Данные автоматически не удаляются: в API курса нет delete. Для чистого повтора используйте отдельный тестовый стенд/volume и осознанный сброс своего окружения. Session tokens хранятся только в памяти процесса и не печатаются/не сохраняются.
## Проверка сохранности, lab2+
`scripts/restart.sh` перезапускает API и используемые stores, сохраняя volumes и тестовые данные.
```sh
make test-persistence ACTION_SCRIPT=scripts/restart.sh
```
Тест создаёт данные и сессию, запускает указанный файл без shell interpolation, ожидает готовности и проверяет те же данные **с прежним токеном**. В lab4+ также проверяется исходный файл. Hook может работать до 90 секунд, готовность затем ожидается до 90 секунд. TTL сессии для этого теста — минимум 300 секунд. Успех не доказывает, что hook действительно перезапустил БД: приложите команды/состояния контейнеров до и после.
## Проверка отказа, lab3+
`scripts/stop-one.sh` сопоставляет `TARGET_INSTANCE_ID` с hostname API container и останавливает только его. Скрипт оставляет реплику остановленной; восстановление выполняйте отдельно.
```sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
```
Перед отказом тест наблюдает ≥2 API-реплики; 15 секунд отправляет сообщения параллельно выполнению hook, повторяет неопределённый POST с тем же ключом, проверяет восстановление записи за ≤10 секунд, отсутствие остановленной реплики в последних ответах, сохранность подтверждённых сообщений и отсутствие дублей. Ошибки переходного периода учитываются. Затем восстановите реплику и повторите для другой. Скрипт — проверка одного отказа API, не гарантия HA БД/LB/host. Вывод hook скрыт, чтобы не утекли секреты; отлаживайте его отдельно с безопасным выводом.
## Нагрузка
```sh
python3 tests/load.py --duration 30 --concurrency 4 --output evidence/load.json
```
Это простой **closed-loop** генератор POST сообщений; он ограничен производительностью клиента и страдает coordinated omission. Он выдаёт successful RPS, ошибки и p50/p95/p99 **только успешных запросов**. Во время нагрузки нет прозрачных retry; timeout мог скрыть совершённую запись, поэтому это throughput HTTP-подтверждений, не точный счётчик COMMIT. Изменение размера истории входит в профиль. Для серьёзного исследования используйте k6/Locust/wrk либо свой обоснованный генератор, а не выводите максимальную пропускную способность из одного запуска этого скрипта. Для нагрузки pipeline изображений нужен отдельный сценарий студента.
## HTTPS, lab7
```sh
make test BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt
make test-security BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt
```
Все скрипты принимают `--ca-file`/`CA_FILE` и проверяют серверный сертификат и hostname. `--insecure` отсутствует. TLS-тест сначала проверяет рабочее доверенное соединение, затем намеренно пустой trust store и именно ошибку проверки сертификата; network timeout не засчитывается как правильный отказ. `make test-internal-mtls` проверяет внутренний API listener из контейнера API: без клиентского сертификата, с недоверенной CA и с недопустимой URI SAN соединение отвергается, а LB identity проходит. `make test-login-limit` проверяет ответ 429 и Retry-After после серии неуспешных входов. Клиентский сертификат внешнему REST-клиенту не требуется: mTLS находится на связи LB→API.
`make test-openbao-acl` проверяет все сервисные AppRole: каждая identity читает собственный KV path и получает 403 на paths остальных identities; также проверяется ограниченный TTL токена. `make test-argon-budget` измеряет Argon2id verify latency, burst capacity и число одновременно занятых hash slots внутри API container с его CPU/RAM limits. Эти результаты характеризуют password hashing guard, а не end-to-end capacity стенда. `pip-audit -r requirements.txt` сканирует закреплённые Python runtime-зависимости по advisory database.
`make test-worker-isolation` запускается внутри worker container: проверяет ограниченную PostgreSQL-роль, запрет чтения/перечисления защищённых S3 buckets, разрешённые staging/originals/variants операции и запрет публикации worker в RabbitMQ. Временные probe objects удаляются после теста.
`make test-worker-rotation ROOT_TOKEN_FILE=...` требует запущенный и распечатанный OpenBao и локальный путь к operator root-token file вне Git. Скрипт создаёт attachment при остановленном worker, выпускает новый SecretID, отзывает прежний, доказывает отказ старого credential, пересоздаёт только worker и проверяет `queued → ready`, checksum original и message link. Root token и SecretID не печатаются. Запуск создаёт синтетические записи и заменяет локальный worker SecretID.
`make test-leaf-rotation` выпускает и устанавливает новый LB client leaf с прежней URI SAN, пересоздаёт API и HAProxy без build, проверяет отказ старого сертификата, приём нового и неизменность Docker image IDs. `make test-telemetry-redaction` генерирует синтетические credentials и сообщение, затем сканирует API log entries в Loki и трассы Tempo на отсутствие этих значений.
Smoke и security-проверки рассчитаны на localhost Compose стенд, не на production. Нагрузочный benchmark, persistence hook и failover API выполняются отдельными командами выше; их машинные результаты записываются в `evidence/`.