7.0 KiB
Отчёт — лабораторная 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 контейнера.