17 KiB
ЛР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.