Files
mtusi2026lab7/REPORT.md
T
HellsTomatoandCopilot 2ef0299e34
Skeleton contracts / contracts (pull_request) Canceled after 0s
Complete lab7 grade 4 implementation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-06 15:35:53 +03:00

8.9 KiB
Raw Blame History

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

  • Автор, группа: не указаны в исходных материалах
  • Целевая оценка: 4. Трек на 5 не выполнялся.
  • Commit: итоговый коммит после завершения интеграции OpenBao и mTLS
  • Основа: перенесены бизнес-API, worker, outbox, attachment pipeline и telemetry-контур из lab6; для lab7 добавлены Argon2id, HTTPS/mTLS, PKI bootstrap, RabbitMQ/OTel identities, OpenBao и hardening Compose. ИИ использован как помощник при подготовке конфигурации и текста.

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

Нужны Docker Compose, JDK 21, Python 3.9+, OpenSSL. Secrets не входят в Git.

cp .env.example .env
python3 scripts/init_secrets.py
sh scripts/init_pki.sh
docker compose --env-file .env build
docker compose --env-file .env up -d

Операторская процедура OpenBao (после первого docker compose up -d):

# Выполнить внутри контейнера openbao через docker compose exec:
export BAO_ADDR=https://openbao:8200 BAO_CACERT=/run/secrets/openbao.crt

# 1. Инициализация (один раз при первом запуске)
bao operator init -key-shares=5 -key-threshold=3
# Сохранить unseal keys и root token ЛОКАЛЬНО (не в Git!)

# 2. Unseal после каждого рестарта контейнера (минимум 3 ключа)
bao operator unseal [key1]
bao operator unseal [key2]
bao operator unseal [key3]

# 3. Bootstrap (один раз после первого init и unseal)
export BAO_TOKEN=[root-token]
# Запустить scripts/bootstrap_openbao.sh из хоста или выполнить вручную:
# - bao secrets enable kv-v2
# - bao policy write [policies]
# - bao auth enable approle
# - bao write auth/approle/role/[roles]
# - bao kv put [secrets]
# - сгенерировать role_id и secret_id в secrets/

# 4. Запуск сервисов с OpenBao
export BAO_ENABLED=true
docker compose up -d api-1 api-2 worker

Тестирование:

py -3 tests/smoke.py --base-url https://localhost:8443 --ca-file secrets/pki/ca.crt
sh scripts/security-tests.sh

OpenBao использует file storage volume (персистентный), не dev mode. Root token и unseal keys хранятся оператором отдельно, не в .env или образе. AppRole credentials (role_id/secret_id) монтируются как Docker secrets с TTL 10 минут. Обычная остановка: docker compose down; намеренное удаление учебных данных: docker compose down -v (сбросит OpenBao data volume).

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

Сохранены две API-реплики, PostgreSQL, Redis, SeaweedFS/S3, RabbitMQ, worker и весь наблюдательный контур lab6. Внешний единственный порт — nginx 8443 с сертификатом localhost. nginx устанавливает новое mTLS-соединение к API. Сервер требует client cert, а фильтр приложения принимает только DNS SAN lb; доверенный leaf api-otel не является LB. Раздельные identities предусмотрены для broker (api-broker, worker-broker) и OTel (api-otel, worker-otel); конфигурации и отрицательные пробы привязаны к contracts/trust-matrix.md.

Новые пароли хранятся как Argon2id PHC strings: 19 MiB, two iterations, parallelism 1. Это минимум задания; выбран после локального измерения, чтобы ограничить login DoS вместе с общим Redis rate limit 10/min/user. Успешный login вызывает upgradeEncoding, поэтому старый/ослабленный Argon2 hash заменяется без смены пароля. Session key — SHA-256 от непрозрачного token, не raw token. API/worker работают с least-privilege credentials; containers use no-new-privileges, dropped capabilities and read-only/tmpfs where compatible.

RabbitMQ принимает только AMQPS с обязательным клиентским сертификатом; EXTERNAL SASL маппит verified certificate CN на пользователей api-broker/worker-broker, поэтому пароль не может обойти identity binding. init_pki.sh создаёт PKCS#12 для identities. OTel Gateway принимает только OTLP over HTTPS с client certificate и allowlist SAN api-otel/worker-otel, после чего передаёт трафик во внутренний Collector. Публичный broker/Collector/OpenBao ports не публикуются.

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

Критерий Команда/сценарий Ожидаемый результат Файл
HTTPS smoke py -3 tests/smoke.py --base-url https://localhost:8443 --ca-file secrets/pki/ca.crt PASS: API, ACL, upload, logout через trusted TLS evidence/lab5_regression.txt и stdout: PASS: lab7 public API scenario
Недоверенный TLS py -3 tests/security.py --base-url https://localhost:8443 --ca-file secrets/pki/ca.crt PASS: trusted endpoint проходит; empty trust store получает certificate verification error stdout: PASS: trusted HTTPS works; untrusted CA rejected
LB→API mTLS sh scripts/security-tests.sh or direct Docker network tests no cert rejected; lb certificate accepted (200); wrong SAN rejected (403) evidence/mtls_negative_tests.txt and scripts/internal-mtls-tests.sh
broker + Collector mTLS TLS client certificate requirement and OTel/RabbitMQ identity enforcement RabbitMQ EXTERNAL maps CN to scoped broker user; OTel Gateway enforces SAN (api-otel/worker-otel), rejects wrong identity evidence/mtls_negative_tests.txt
Argon2, rehash, login budget 11 неверных Basic logins, затем правильный login с legacy hash 429 + Retry-After; successful login rehashes security test log
OpenBao least privilege AppRole login as api/worker role, attempt cross-path access API token denied worker path (403); Worker token denied API path (403); each reads own path successfully evidence/openbao_least_privilege.txt
OpenBao sealed fail-closed bao operator seal; restart worker with BAO_ENABLED=true Worker fails with IllegalStateException: OpenBao AppRole secret loading failed closed; HTTP 503 from sealed vault; after unseal services recover evidence/openbao_failclosed.txt
KV rotation without rebuild Update kv/messenger/api password to new value; restart api-1 API fetches v2 secret (password changed, connection attempt shows new value used); restore to v3; no image rebuild required evidence/openbao_rotation.txt
Certificate rotation Generate new leaf certificate with same SAN; restart service with new cert; verify old key rejected New certificate active (different serial); old private key cannot establish connection (key mismatch); no rebuild required evidence/certificate_rotation_procedure.txt
OpenBao bootstrap bao operator init, unseal, policies, AppRole, KV secrets 5 key shares (threshold 3); policies uploaded; AppRole credentials generated; KV v2 secrets populated for api/worker paths evidence/openbao_bootstrap.txt
image/dependency scan sh scripts/scan.sh (Trivy host binary or Docker fallback) plus manual review HIGH/CRITICAL findings are listed and triaged; container hardening applied evidence/dependency_analysis.txt

Отказы и ограничения

Воздействие Ожидание / контролируемый результат
Sealed OpenBao existing bounded credentials may finish; new secret fetch fails closed; operator unseals and service re-authenticates
Expired/revoked leaf new connection fails; reconnect with rotated allowed leaf restores service, without disabling verification
Stopped Collector/backend bounded Collector queue prevents unbounded memory; business API/worker stay available
Worker image bomb pixel, timeout and container CPU/RAM limits bound one job; retry/DLQ remains observable

Учебные ограничения уровня 4:

  • Single-host Compose (not production HA)
  • No CA rollover infrastructure
  • No HSM for key storage
  • No multi-node OpenBao cluster
  • Certificate revocation uses CA rollover/rotation; CRL/OCSP is not required for this local lab

Пятый уровень (compromise/lifecycle research) намеренно не реализован.