Files
mtusi2026lab7/security/THREAT_MODEL.md
T
kaktuz20000 5a6fcff3ef
Skeleton contracts / contracts (pull_request) Canceled after 0s
выполение на 5
2026-11-04 19:22:35 +03:00

32 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Модель угроз — lab7
## Активы и акторы
Активы: пароли пользователей, hashes сессий, сообщения и вложения, database/object-store/broker credentials, service identities, CA private key, OpenBao root token и unseal shares, telemetry. Акторы: внешний клиент, пользователь — участник чата, посторонний пользователь, скомпрометированный application service и локальный оператор.
Внешний атакующий может отправлять HTTPS запросы к loopback-published ingress. Пользователь действует только от своего Bearer session. Скомпрометированная служба получает только AppRole credential и секретный KV path, смонтированные этой службе. Оператор управляет PKI и OpenBao init/unseal. Модель не включает компрометацию Docker host, операционной системы или operator workstation.
## Границы доверия
Внешняя граница — клиент → HAProxy по HTTPS. Внутренний API boundary — HAProxy → API по mTLS с проверкой CA chain и allowlisted URI SAN. OpenBao доступен по TLS и выдаёт статические secrets сервисным AppRole identities. Схема сетевых связей и протоколы приведены в [матрице доверия](../contracts/trust-matrix.md).
| Угроза и конкретный путь | Нарушаемый инвариант | Контроль | Отрицательный тест | Остаточное ограничение |
| --- | --- | --- | --- | --- |
| Клиент в сети пытается перехватить пароль при входе или Bearer token | Credentials передаются только аутентифицированному endpoint | HTTPS ingress, CA и hostname validation; открытый HTTP endpoint не опубликован | `make test-security` с корректным и пустым trust store | Внешний endpoint использует локальную учебную CA, которую клиент должен получить доверенным способом |
| Клиент с сертификатом, подписанным доверенной CA, но с URI SAN другой службы, обращается к API | Только LB identity может установить соединение к API listener | mTLS + точное сравнение `spiffe://mtusi2026lab7/load-balancer` | `make test-internal-mtls` с identity `other-service` | Срок leaf ограничен 397 днями; автоматическая ротация не настроена |
| Клиент без сертификата или с cert чужой CA пытается обойти ingress и обратиться к API listener | API не обслуживает неподтверждённое внутреннее соединение | `CERT_REQUIRED`, CA verification, API порт не опубликован на host | `make test-internal-mtls` без cert и с foreign CA; прямого host-порта нет | Проверка выполняется внутри контейнерной сети лабораторного Compose |
| Пользователь вне чата запрашивает историю, metadata или content чужой attachment | Только член чата получает доступ к сообщениям и вложениям | Bearer session, ownership/membership checks, одинаковый 404 для чужих ресурсов | `make test` black-box сценарий ACL | Контракт не включает администрирование/редактирование состава участников |
| При утечке PostgreSQL snapshot атакующий подбирает пароль | Пароль не хранится plaintext и имеет per-user salt | Argon2id `m=19456 KiB, t=2, p=1`; сессионные токены хранятся как SHA-256 hashes | `make test-primitives` | Параметры следует повторно измерить на целевом hardware |
| Password spray пытается обойти лимит через несколько API-реплик и usernames | Серия неуспешных входов должна давать ограниченный ответ | PostgreSQL хранит fixed-window counters по SHA-256(username) и trusted source IP; sixth per-user attempt или 61st per-IP attempt в окне возвращает 429/Retry-After | `make test-login-limit` проверяет per-user threshold | Порог per-IP равен 60 попыткам за минуту |
| Скомпрометированный API/worker запрашивает operator или чужие сервисные secrets | Application identity не получает root token/unseal shares и чужие KV paths | AppRole per service, KV v2 path-specific read policy, short TTL | `make test-openbao-acl` подтверждает собственный path и 403 для остальных сервисов | Поведение после истечения TTL не тестировалось; KV values статические |
| Скомпрометированный worker пытается читать аккаунты/originals, перечислять buckets или публиковать свои jobs | Worker не получает DB users, S3 List/read originals/variants или broker publish privileges | Отдельная PostgreSQL-роль; S3 read/write на staging bucket, write на originals/variants; AMQP read только process queue | `make test-worker-isolation` проверяет grants, `AccessDenied` и broker `403`; `make test-worker-rotation` отзывает прежний SecretID и восстанавливает queued attachment | Проверен один worker и один queued recovery scenario на локальном Compose стенде |
| Ошибка приложения/инструментации записывает token или тело сообщения в telemetry | Credentials и пользовательские данные не экспортируются как telemetry attributes | OTel instrumentation задаёт низкокардинальные route attributes; проверка кодом/конфигурацией | `make test` не является проверкой утечек telemetry; отдельный grep/inspection не приложен | Отдельный telemetry redaction test не запускался |
## Lifecycle и инциденты
Оператор создаёт локальную CA и leaf сертификаты с `scripts/bootstrap-pki.py`; сертификаты и ключи лежат в ignored `secrets/pki/`. Root token/unseal shares создаются оператором при init и не передаются bootstrap скрипту через CLI arguments или app containers; `bootstrap-openbao.py` читает root token из локального файла, пишет policies и создаёт AppRole credentials под `secrets/openbao/`. Скрипт не печатает значения.
Ingress/API/OpenBao leaf certificates выпускаются на 397 дней; CA — на 3650 дней. Автоматический renewal/CA rollover не реализован. OpenBao AppRole SecretIDs имеют TTL 24 часа, сервисные tokens — 15 минут (max 1 час); приложение аутентифицируется и получает KV values при запуске. Ротация SecretID требует operator provisioning и перезапуска соответствующей службы. OpenBao state сохраняется в named volume; после рестарта оператор unseal-ит сервис по необходимости.
Runtime TLS проверен для внутренних сервисных каналов и telemetry backends; AppRole access isolation, worker ACL и восстановление после SecretID rotation зафиксированы отдельными сценариями. Автоматический rollover leaf-сертификатов не включён; оператор управляет их сроком и заменой.