выполение на 5
Skeleton contracts / contracts (pull_request) Canceled after 0s

This commit is contained in:
kaktuz20000
2026-11-04 19:22:35 +03:00
parent 20afc2c790
commit 5a6fcff3ef
90 changed files with 8848 additions and 130 deletions
+19 -7
View File
@@ -1,19 +1,31 @@
# Модель угроз — заполнить
# Модель угроз — lab7
## Активы и акторы
TODO: пользовательские credentials/сессии, сообщения/вложения, service identities, CA/secrets, telemetry. Акторы: участник чата, посторонний пользователь, внешний клиент, скомпрометированный сервис, оператор. Опишите доступ атакующего и границы учебного стенда.
Активы: пароли пользователей, 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.
## Границы доверия
TODO: схема и ссылка на заполненную contracts/trust-matrix.md; публичные/внутренние интерфейсы, процессы, секреты и их выдача.
Внешняя граница — клиент → HAProxy по HTTPS. Внутренний API boundary — HAProxy → API по mTLS с проверкой CA chain и allowlisted URI SAN. OpenBao доступен по TLS и выдаёт статические secrets сервисным AppRole identities. Схема сетевых связей и протоколы приведены в [матрице доверия](../contracts/trust-matrix.md).
| Угроза и конкретный путь | Нарушаемый инвариант | Контроль | Отрицательный тест | Остаточное ограничение |
| --- | --- | --- | --- | --- |
| TODO | TODO | TODO | TODO | TODO |
На 4 минимум 6 конкретных угроз. Не заменяйте сценарии словами «SQL injection», «безопасный Docker», «mTLS включён» без пути и проверки.
| Клиент в сети пытается перехватить пароль при входе или 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 и инциденты
TODO: bootstrap, expiry/renewal, revoke/rotation, компрометация identity, sealed OpenBao и восстановление. Указать владельца CA/unseal и способ защиты bootstrap credentials. Сопоставить scan findings с реальной применимостью и исправлением/остаточным риском.
Оператор создаёт локальную 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-сертификатов не включён; оператор управляет их сроком и заменой.