Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
8.9 KiB
Отчёт — лабораторная 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) намеренно не реализован.