Files
mtusi2026lab7/REPORT.md
T
Wladislava1 54dcf70ea6
Skeleton contracts / contracts (pull_request) Canceled after 0s
Lab7: HTTPS, mTLS, OpenBao, трек 2 PKI на оценку 5
2026-11-17 00:25:48 +03:00

7.0 KiB
Raw Blame History

Отчёт — лабораторная 7

  • Автор, группа: Орлова Владислава, БПИ2301
  • Целевая оценка: 5. Трек 2, жизненный цикл PKI/secrets
  • Commit/PR: ещё не публиковала
  • Источники и помощь: задание и контракт lab7, рабочий стенд lab6, OWASP Password Storage, OpenBao AppRole/policies, документация HAProxy/RabbitMQ TLS. При написании кода и отчёта пользовалась помощью ИИ. Числа ниже сняты с моего запуска 16 ноября 2026

Запуск из чистого clone

Нужны Docker Engine и Python 3.9+. У меня Docker Engine 26.1.4 и Python на Windows. make нет — команды через python -X utf8. Для persistence/failover на Windows использую scripts/restart.cmd и scripts/stop-one.cmd (внутри вызывают Python-хуки).

python -X utf8 scripts/bootstrap.py
docker compose --env-file .env up -d postgres redis rabbitmq minio openbao prometheus loki tempo otel-collector otel-gateway grafana
python -X utf8 scripts/openbao_bootstrap.py
docker compose --env-file .env up -d --build --scale api=2 minio-init migrate api worker lb
python -X utf8 scripts/wait_ready.py
python -X utf8 tests/smoke.py --base-url https://localhost:8443 --ca-file "$PWD/certs/ca.crt"
python -X utf8 tests/security.py --base-url https://localhost:8443 --ca-file "$PWD/certs/ca.crt"
python -X utf8 tests/student_mtls.py
python -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url https://localhost:8443 --ca-file "$PWD/certs/ca.crt"
python -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url https://localhost:8443 --ca-file "$PWD/certs/ca.crt"

bootstrap.py создаёт secrets/, .env и PKI в certs/ (ключи в certs/private/). openbao_bootstrap.py делает init/unseal и пишет AppRole в secrets/bao_*; root/unseal — только в secrets/openbao/ у оператора, в git не входят.

Остановка без удаления данных: docker compose --env-file .env stop. Удаление учебных данных: docker compose --env-file .env down -v.

Имя проекта Compose — mtusi-lab7. Наружу: 127.0.0.1:8443 (HTTPS LB), 127.0.0.1:3000 Grafana, 127.0.0.1:9090 Prometheus, 127.0.0.1:8200 OpenBao для оператора.

Архитектура и решения

Из lab6 перенесён мессенджер: 2×API, HAProxy, Postgres, Redis, MinIO, RabbitMQ, worker, outbox, OTel→Prometheus/Loki/Tempo/Grafana.

Новое в lab7:

  • Публичный HTTPS на :8443 с локальным CA
  • Обязательный mTLS LB→API с allowlist identity lb
  • TLS к Postgres/Redis/MinIO/RabbitMQ/OpenBao; mTLS API/worker→broker и →otel-gateway
  • OpenBao non-dev (file storage) + AppRole + scoped policies
  • Argon2id 19MiB/t=2/p=1, rehash при входе, общий login rate limit в Redis. На моём стенде один hash_password занял ≈50 ms — этого хватает как учебный бюджет против дешёвого login DoS вместе с Redis limit 10/30s
  • Hardening: non-root, cap_drop, no-new-privileges, read_only+tmpfs у api/worker; triage образов в evidence/scan-triage.md

Матрица: contracts/trust-matrix.md. Угрозы: security/THREAT_MODEL.md.

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke HTTPS tests/smoke.py --base-url https://localhost:8443 --ca-file certs/ca.crt PASS: lab7 public API scenario вывод в консоли 16.11.2026
Внешний TLS trust tests/security.py PASS: trusted HTTPS; untrusted CA rejected то же
Persistence tests/resilience.py --mode persistence --action-script scripts/restart.cmd PASS: persistence preserved… то же
Failover API tests/resilience.py --mode failover --action-script scripts/stop-one.cmd PASS; first_recovery_seconds≈1.7; observed_instances_before=2 то же
Внутренний mTLS tests/student_mtls.py нет cert / чужая identity → отказ; lb → 200 tests/student_mtls.py
OpenBao AppRole scripts/openbao_bootstrap.py + startup bao.login_and_read API ready только после unseal и scoped secret src/bao.py, infra/openbao/
Argon2id + rate limit параметры в passwords.py; Redis login:fail:* ≈50 ms на hash; rehash; 429 Retry-After src/passwords.py, src/store.py
Image scan triage разбор применимости CVE, не только count зафиксированы классы/остаточный риск evidence/scan-triage.md
OpenBao allow/deny tests/student_openbao.py api path 200; worker path deny вывод теста
Трек 2 PKI lifecycle scripts/pki_renew.py --identity api --days 14 + recreate api leaf обновлён без rebuild base image; verify не отключается scripts/pki_renew.py, evidence/pki-track2.md

Эксперименты и отказы

Гипотеза трека 2: короткоживущий leaf можно ротировать без plaintext fallback и без отключения проверки сертификата; ошибки на время recreate ограничены, после загрузки нового leaf smoke снова зелёный.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Persistence restart stateful + api Сессия и данные живы PASS persistence без потери подтверждённых данных
Stop одной API-реплики Запись продолжает другая реплика PASS failover; recovery ≈1.7s реплика остаётся stopped до ручного up
Sealed/unavailable OpenBao API не ready fail-closed в lifespan до unseal оператором
Недоверенный CA снаружи Отказ TLS PASS security —

Ограничения и следующие шаги

Учебный стенд на одной машине, CA локальный. Auto-unseal нет — после рестарта OpenBao нужен оператор. Collector backends (Tempo/Loki) внутри доверенной сети без отдельного mTLS hop. Scan образов с разбором CVE можно расширить отдельным отчётом. Следующий шаг — автоматизировать reload leaf без полного recreate контейнера.