Files
mtusi2026lab7/REPORT.md
T

17 KiB
Raw Blame History

ЛР7 — Парамонов Глеб, БВТ2301

Целевая оценка 5, трек 1: компрометация worker. Ветка solution/bvt2301-paramonov. Перенесена собственная реализация ЛР6: две API, PostgreSQL, profile cache, приватный S3, transactional outbox, Valkey Streams, worker с versioned image pipeline, reconciler, OTel/Grafana. Новый внешний API — HTTPS. README задания, business contract и public tests не ослаблены; заполнен предусмотренный заданием contracts/trust-matrix.md.

Код, исследование и оформление подготовлены с помощью OpenAI Codex. Результаты в evidence/ получены на реальном локальном стенде, а не сгенерированы как пример. Это учебная реализация в заявленной модели угроз, не production seal.

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

Нужны Git, Docker Engine/Compose v2, Python 3.12+ и сеть для официальных images/ PyPI. Проверено на Windows10, Docker Desktop4.39 / Engine28 / Compose2.33, WSL2 4CPU/3GiB RAM/4GiB swap, i5-11400H/8GiB host RAM. Версии образов закреплены digest в compose.yaml/Dockerfile; зависимости — точными версиями в requirements. Предыдущие стенды остановить: административный Grafana port3000 общий.

python -m venv .venv
# Windows: вместо .venv/bin/python используйте .venv/Scripts/python.exe
.venv/bin/python -m pip install -r requirements-dev.txt -r requirements-test.txt
.venv/bin/python -X utf8 scripts/up.py
.venv/bin/python -X utf8 scripts/verify_public.py

up.py — явная операторская команда. Она создаёт локальные секреты, строит image, согласованно останавливает старые процессы без удаления volumes, запускает Bao и хранилища, выполняет init/unseal, migrations/GRANT, policy/KV provisioning, создаёт private bucket, запускает остальное и ждёт verified HTTPS readiness. Повтор сохраняет пароли/CA/data и проверяет hashes применённых migrations. Leaf certificates с остатком <2h обновляются оператором. Это cold-start workflow, бесшовный rollout не заявляется. На этой машине dependencies для работы выполнялись также из соседнего существующего venv; для проверяющего полностью достаточно собственного venv этого репозитория.

После запуска: API https://localhost:8443, Grafana https://localhost:3000 (login admin, пароль только в локальном secrets/grafana-password), Bao API https://localhost:8200 (обязательный operator client cert). Не отключайте проверку CA: для Python/public tests --ca-file secrets/trust/ca.crt. Для браузера сначала установите публичный учебный CA вручную, если нужен UI. HTTP на этих портах не является fallback.

Эквивалентные операции по шагам приведены в scripts/up.py. Обычный restart API не требует unseal. После перезапуска Bao:

.venv/bin/python scripts/bao_operator.py unseal

Root token и 3 unseal shares (threshold2) находятся только в secrets/operator/bao-init.json; CA key — рядом в ca.key. Их не передают в PR/чат, не монтируют в runtime и не печатают. Windows bootstrap убирает inherited ACL и оставляет owner/SYSTEM/Administrators; POSIX secrets0700/files0600. Все доли на одном защищённом компьютере — ограничение учебного bootstrap, не production secret custody. Резервные копии этих файлов должен хранить оператор отдельно от data volume; потеря shares делает sealed data недоступными.

Остановка с сохранением данных: docker compose down. Осознанное удаление всех учебных данных только этого проекта: docker compose down --volumes. После такого сброса следует создать новый clone/workdir и новые secrets; старый bao-init не соответствует новому пустому raft volume. Команда удаления не используется тестами. Restart hook делает stop/start в dependency order, потому что приложение и его TLS sidecar разделяют network namespace.

Архитектура и эксплуатация

Клиент → TLS LB → mTLS API1/API2 → mTLS DB/S3/cache/Collector. Worker и dispatcher используют отдельные broker identities. Collector экспортирует через mTLS в Loki/Tempo; Prometheus читает защищённые scrape endpoints; Grafana читает data sources через собственные mTLS tunnels. Полная матрица.

В backend namespace native listener только loopback. Прокси использует Python stdlib/OpenSSL, проверяет CA, hostname и SAN allowlist; TLS>=1.2, CRL, максимум 64 активные/96 ожидающие задачи, 16KiB buffers, 60s connection lifetime. TLS context cache <=1s, поэтому срок прекращения существующей связи <=61s. TLS session tickets на server proxy выключены. Прокси не логирует payload. Native TLS применяется у LB, Bao и Grafana. CA private key в services отсутствует.

Secret supervisor использует native mTLS cert auth OpenBao, а не постоянный секрет «для получения секретов». Политика разрешает read только собственного KV path. Token TTL/maxTTL120s, re-auth20s; после чтения token revoke-self. Пароли БД/S3/Valkey — static KV, их реальная валидность заканчивается ротацией backend. Локальный budget120s ограничивает продолжение работы child при sealed/unavailable Bao, но не обезвреживает скопированный злоумышленником пароль. Смена KV перезапускает child и закрывает старые pooled connections. Crash child также обрабатывается supervisor без смены network namespace.

PostgreSQL — источник истины для пользователей, sessions, идемпотентности, attachments/jobs/outbox. Native host authentication на loopback — SCRAM, не trust. Только операторский Unix socket использует доверенный local role; этот socket другим контейнерам не расшарен. Worker не читает users/sessions/ messages и не может DDL/role administration. API имеет business-table grants; worker/dispatcher — jobs/attachments/outbox/audit, reconciler — attachments. Dispatcher не получает S3 credentials. Valkey ACL ограничивает команды и key; S3 policy — bucket prefixes. Отдельные credentials каждой роли лежат в Bao.

Argon2id: 32MiB, t2, p1, случайный salt. При успешном входе старые параметры rehash с compare-and-swap. Session token — 256 случайных бит, в PostgreSQL только SHA-256; expiry1h/logout проверяются по БД. KDF concurrency2/API, общий limiter12 login attempts/10s и8 registration/10s. 429 содержит Retry-After10. Это глобальный учебный бюджет, не распределённая антибот-система по пользователям.

Runtime non-privileged, capabilities dropped, no-new-privileges, read_only root filesystem, RAM/CPU/pids limits, writable named volumes/tmpfs только где нужны. Worker1CPU/768MiB, render subprocess имеет отдельный timeout/лимиты. Init jobs кратковременно root с CHOWN/FOWNER/DAC_OVERRIDE для отдельных secret volumes; в runtime этих capabilities нет. Stateful write paths: PG/Seaweed/Valkey data, Bao raft+audit, Grafana/Prometheus/Loki/Tempo data. Наружу только loopback 8443/8200/3000. .env.example — исходный перечень ролей, фактические параметры создаются bootstrap.py: .env только DB bootstrap, service env приходит из Bao, S3 admin имеет отдельный .env.storage-admin лишь в operator profile.

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

.venv/bin/python scripts/verify_public.py
.venv/bin/python scripts/verify_security.py
# Ниже отдельные сценарии для воспроизведения/диагностики, уже включённые в suite:
.venv/bin/python scripts/test_identities.py
.venv/bin/python scripts/bao_operator.py publish-crl
docker compose run --rm security-check
# В Windows вывод перенаправлять в UTF-8, пример: > evidence/tls-matrix.json
docker compose run --rm security-check python /checks/bao_policy.py
.venv/bin/python checks/security_api.py
.venv/bin/python checks/compromised_worker.py
.venv/bin/python checks/sealed_bao.py
.venv/bin/python checks/telemetry_security.py
.venv/bin/python checks/hardening.py
docker compose exec -T worker python - < checks/worker_rights.py
docker compose run --rm --no-deps -v "$PWD/checks:/checks:ro" api1 python -m unittest discover -s /checks -p test_render.py
.venv/bin/python scripts/scan_images.py

Последний run api1 использует только unittest renderer, service secret supervisor не запускается (command переопределён). PowerShell stdin: Get-Content checks/worker_rights.py -Raw | docker compose exec -T worker python -. Перед повтором быстрых suites дайте limiter10s; не отключайте его ради PASS.

Критерий Сценарий / evidence
Неизменённый business contract/OpenAPI, HTTPS smoke verify_public → check_contract.txt, validate_openapi.txt, smoke.txt, security.txt
Сохранность всех данных/сессии/файла после restart persistence.txt + restart-processes.json, реальные StartedAt всех сервисов
Отказ обеих настоящих API-реплик failover-*.txt и *-process.json, target из X-Instance-Id, distinct container IDs
Вся внутренняя TLS матрица и отрицательные identities tls-matrix.json: все allow edges и no-cert/foreign CA/wrong SAN/expired/revoked/plaintext
Scoped cert auth/TTL/policy allow-deny bao-policy.json
Пароли/session hashes/rehash/shared DoS budget/ACL security-api.json
Реальный доступ с credentials worker worker-rights.json
Отзыв identity, ротация cert+DB password, сохранность задач compromised-worker.json
Sealed Bao и bounded expiry/recovery sealed-bao.json
Метрики, сквозной upload trace, correlated logs без canaries telemetry-security.json
Runtime isolation/permissions/mounts/ports hardening.json
Dependencies и образы dependency-audit.json, image-audit.json, security/SCAN_TRIAGE.md

Модель угроз связывает 11 конкретных сценариев с этими проверками: security/THREAT_MODEL.md. Публичный smoke не используется как доказательство всех security claims.

Исследование: компрометация worker

Гипотеза: раздельная identity + least privilege ограничивают последствия захвата worker обработкой вложений, а отзыв cert и связанного пароля останавливает новый доступ; transactional outbox сохраняет принятые задания до восстановления.

Методика checks/compromised_worker.py: синтетические пользователи/чат; сравнение operator session-read с denied worker session-read; revoke serial в proxy CRL и Bao cert-auth CRL; завершение старых worker DB sessions; 3 загрузки при отозванном worker; проверка queued; ALTER ROLE PASSWORD; новый24h leaf; secret-init; проверка старого пароля на новом TLS соединении; обновление KV; ожидание ready всех3, проверка distinct jobs и SHA-256. Образ worker до/после должен совпадать.

Первый завершённый запуск 04.11.2026: 3/3 задачи восстановлены без дублей, SHA-256 сохранены, образ не менялся, полный эксперимент39.16s. Это время включает fault injection/provision и ожидание20s re-auth, не pure service recovery latency. В ходе разработки тест нашёл loopback trust в PostgreSQL; после исправления на SCRAM старый пароль действительно отклонён. Финальные повторные результаты смотрите в JSON evidence (они заменяют предыдущий запуск).

Отдельный sealed-Bao эксперимент04.11: обе API child прекратили слушать через 106.58s от seal (остаток последнего120s budget), recovery23.44s после unseal. Измерение Argon2 в API container: hash+verify median0.209s, maxRSS53168KiB; 20 конкурентных login завершились за2.031s, 12×401 и8×429, две instance identities. Основная KDF memory bound двух API: 4×32MiB=128MiB плюс overhead процесса. Эти числа — один контрольный запуск, не гарантия p99/capacity/устойчивости к DDoS.

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

Single host и single DB/S3/broker/Bao/LB: отказ хоста или этих зависимостей не переживается без перерыва. Есть отказ отдельной API-реплики, но не полноценная HA всех компонентов. Cert/CRL renewal операторский; безопасный CA rollover под нагрузкой не заявляется (выбран трек1). Учебная PKI и все shares на одном хосте. Worker сохраняет возможность повредить разрешённые prefixes/jobs; least privilege ограничивает ущерб, не делает скомпрометированный процесс безопасным. Audit Bao остаётся в operator volume, rotation/retention нужны для длительной эксплуатации. Сканирование не является доказательством отсутствия уязвимостей; применимость и оставшиеся findings разобраны отдельно. Более строгий deployment потребует динамических DB leases, isolated worker VM/seccomp, сетевых политик и отдельной защиты operator workstation.

Первичные источники: OpenBao cert auth, declarative audit, Python ssl, OWASP Password Storage, Pillow13 release, Trivy.