Files
mtusi2026lab7/contracts/trust-matrix.md
T
2026-11-11 13:53:51 +03:00

12 KiB
Raw Blame History

Матрица доверия — lab7

Это обязательная матрица покрытия. Для каждой строки укажите реальный порт, endpoint, CA, service identity, проверку SAN/ACL, срок жизни credentials и команду положительного/отрицательного теста. TLS шифрует и подтверждает сервер; mTLS также проверяет клиента. При доверенном CA всё равно нужно ограничивать разрешённую identity. Plaintext hop допустим только внутри закрытого локального transport/proxy boundary, без опубликованного обхода; границу и rationale нужно доказать.

Связь Минимум на 3 Дополнительно на 4 Доказательство / конфиг
Клиент → ingress/LB TLS, CA + hostname, Bearer Проверка expiry/revocation сессии и общего login rate limit localhost:8443, Lab7 CA, DNS localhost / IP 127.0.0.1; Basic только login, Bearer 3600 с; logout/2 с expiry/глобальные 24 входа за 10 с. make test-security, student-tests/http_security.py, scripts/test_expiry.sh.
LB → API (все реплики) mTLS + allowlist LB identity Ротация leaf без обхода проверки api:8444 на обеих репликах, Lab7 CA + SAN api при проверке LB; API принимает SAN lb и только активный serial 7-дневного leaf. docker compose run --rm -T audit, python3 student-tests/lifecycle.py leaf.
API/worker → PostgreSQL TLS verify-full + раздельные ограниченные DB roles Ротация credentials; mTLS — допустимое усиление db:5432, Lab7 CA, SAN db, verify-full + SCRAM; роли lab_api, lab_worker, lab_dispatcher, lab_reconciler и отдельный owner миграций. Рабочий пароль до ротации, допуск процесса ограничен lease 30 с. Audit проверяет TLS/имя/доступ к users; lifecycle.py db проверяет старый и новый пароль.
API/worker → S3 TLS + разные scoped credentials/prefix rights Проверка denied prefix и ротация s3:9000, Lab7 CA, SAN s3, AWS SigV4, приватный messenger-attachments. API пишет staging и читает originals/variants; worker читает staging и публикует результат; reconciler чистит staging. Пароли до ротации, процесс ограничен lease OpenBao. Audit проверяет чужие префиксы, list и unsigned GET известного объекта. lifecycle.py s3 проверяет старый и новый SigV4 credential.
API/worker → broker TLS + разные producer/consumer identities и ACL mTLS + ограничение допустимых SAN/ролей broker:6380 → 127.0.0.1:6379 только в netns broker/streams. TLS Lab7 CA, SAN broker, точные CN dispatcher/worker (leaf 7 дней) + разные Redis ACL и ключ attachments.jobs. Dispatcher публикует от имени API через durable outbox; сам API не получает broker secret. Audit использует действующий пароль с отсутствующим, чужим и запрещённым cert; проверяет ACL команд и ключей.
API/worker → Collector TLS; сеть/аутентификация запрещает произвольный ingest mTLS с раздельными identities collector:4318 → 127.0.0.1:14318. TLS Lab7 CA, SAN collector, точные CN api/worker/dispatcher/reconciler; leaf 7 дней, POST только на три OTLP endpoint. Audit проверяет каждую роль и три варианта отказа.
Collector → telemetry backends TLS + scoped backend credentials или mTLS Ротация и проверка least privilege Collector CN collector-export и active fingerprint → loki:3100/otlp/v1/logs, tempo:4318/v1/traces, Lab7 CA, SAN цели и 7-дневные leaf. Только POST ingest, роли Grafana/API отклоняются. Prometheus pull → collector:8888/8889 только CN scraper и GET /metrics. Audit и telemetry_audit.py проверяют права и реальные сигналы, lifecycle.py collector — ротацию exporter leaf.
Grafana → data sources TLS с проверкой сервера, ограниченная identity Отрицательные проверки доступа Grafana CN grafana (leaf 7 дней) → prometheus:9090, loki:3100, tempo:3200, Lab7 CA и SAN сервера; только query маршруты. Audit проверяет отказ app и запрет ingest Grafana; telemetry_audit.py проверяет фактический datasource proxy.
API/worker/agent → OpenBao TLS + сервисный auth + scoped policy Renewal/expiry/revocation openbao:8200, Lab7 CA, SAN openbao, отдельная сеть vault; клиентские cert 7 дней, роли закреплены за leaf + SAN, KV путь messenger/data/<role>. Token TTL 30 с, максимум 300 с с повторным cert-login. Audit проверяет чужой cert/path, policy write; lifecycle.py bao проверяет renew, revoke и seal.
Оператор → OpenBao/Grafana/S3 admin TLS + authentication, доступ локальный/через защищённый канал Разделение operator/application roles OpenBao localhost:8207, Lab7 CA/SAN localhost, operator cert 7 дней и token 5 мин; Grafana localhost:3007, Lab7 CA/SAN localhost, локальный admin пароль до ротации; MinIO admin только из одноразового bootstrap-контейнера по s3:9000 с CA/SAN и SigV4. Audit доказывает отказ app, telemetry_audit.py — Grafana без login 401. Root OpenBao отзывается после init.
API → Redis/Valkey, если используется TLS + ACL/пароль с минимальными правами Ротация; mTLS по возможности N/A для профилей и сессий. Источник истины PostgreSQL; Redis Streams существует только как broker с отдельным ACL выше.
Replication/кластерные каналы, если добавлены TLS/mTLS либо подтверждённый шифрованный transport Проверка заявленной модели отказа N/A для межузловой репликации. PostgreSQL, Redis, S3 и OpenBao Raft по одному экземпляру. OpenBao cluster listener ограничен 127.0.0.1:8201; API-реплики не общаются напрямую.

Нет выбранного компонента — отметьте N/A с причиной, а не оставляйте пустую строку. Внутренний публичный health listener, если нужен, минимален и изолирован; через него нельзя обращаться к бизнес-API без mTLS. Отдельно задокументируйте scrape/health/bootstrap каналы: они тоже не должны создавать обход.

Обязательные отрицательные проверки

  1. HTTPS с правильным CA/hostname проходит; с пустым/чужим CA и неправильным hostname — ошибка верификации, не «сервер недоступен».
  2. LB→API: без client cert, с cert чужого CA, с запрещённой identity от доверенного CA — отказ; с разрешённой LB identity — успех.
  3. На 4 повторите набор для broker и Collector; ограничение на network policy не заменяет проверку identity.
  4. Пользователь вне чата не читает metadata/content и не прикрепляет чужой файл; поддельный X-User-Id не меняет Bearer identity.
  5. OpenBao app policy читает только свой secret/path; запись policy и чтение чужого path запрещены. Worker не получает admin credentials API/БД/S3.
  6. На 4 отзовите secret/cert и дождитесь контролируемого эффекта с учётом действующих соединений, TLS resumption и cache/TTL. Покажите новое подключение, иначе тест отзыва может ничего не проверить.

Bootstrap и эксплуатация

В репозитории только открытые конфиги, policy templates и scripts. CA private key, leaf keys, root token, unseal shares и SecretID не коммитятся, не запекаются в образ и не печатаются в отчёте. Для локального стенда оператор создаёт их вне Git и передаёт через files/secrets с ограниченными правами. Опишите, кто имеет доступ к CA/unseal, что нужно после рестарта OpenBao и как восстановить работу.

OpenBao не использует dev-mode. Выберите persistent storage и auth метод (например AppRole с короткоживущим SecretID/response wrapping, cert auth или иная обоснованная identity). Не подменяйте root token постоянной переменной BAO_TOKEN в приложении. Рабочие tokens имеют policy, TTL и renewal/re-auth сценарий. Статические KV secrets на 3 допустимы при реальном чтении через сервисную identity; динамические DB credentials — хорошее расширение, но не обязательное название технологии.

Разрешённый компромисс учебного стенда: ручной operator init/unseal, если он безопасно документирован и не нужен при каждом обычном рестарте API. Автоматическое хранение всех unseal shares рядом с OpenBao без защиты не считается решённым bootstrap.

Служебные каналы

Пути к конфигурациям — Compose, LB, TLS gateways, OpenBao, DB ACL, S3 IAM. Из среды Docker напрямую достижимы только TLS-порты зависимостей. У каждого sidecar свой network namespace с конкретным backend. HTTP/gRPC и Redis за proxy привязаны к loopback этого namespace. Loki и Tempo используют loopback для внутрипроцессных RPC. Внешний LB проверяет readiness и liveness через тот же mTLS. PostgreSQL использует peer только на Unix socket контейнера для init/оператора. Публичные health API не дают доступа к данным. Отдельный Compose probe проверяет отсутствие сетевого доступа к plaintext-портам.