12 KiB
Матрица доверия — 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 каналы: они тоже не должны создавать обход.
Обязательные отрицательные проверки
- HTTPS с правильным CA/hostname проходит; с пустым/чужим CA и неправильным hostname — ошибка верификации, не «сервер недоступен».
- LB→API: без client cert, с cert чужого CA, с запрещённой identity от доверенного CA — отказ; с разрешённой LB identity — успех.
- На 4 повторите набор для broker и Collector; ограничение на network policy не заменяет проверку identity.
- Пользователь вне чата не читает metadata/content и не прикрепляет чужой файл; поддельный X-User-Id не меняет Bearer identity.
- OpenBao app policy читает только свой secret/path; запись policy и чтение чужого path запрещены. Worker не получает admin credentials API/БД/S3.
- На 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-портам.