Files
2026-11-20 15:30:33 +03:00

61 lines
5.1 KiB
Markdown
Raw Permalink 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.
# Лабораторная 7 — безопасность, mTLS и OpenBao
**Каменский Андрей, БПИ2301. Целевая оценка: 4.**
Работающий мессенджер из lab6: две FastAPI-реплики, HAProxy, PostgreSQL, Redis sessions, Redis Streams, outbox dispatcher, image worker, private MinIO, reconciler и OpenTelemetry/Grafana. Добавлены HTTPS, взаимная проверка service identities, scoped credentials через persistent non-dev OpenBao, ротация/отзыв, общий rate limit и rehash.
## Быстрый запуск
Нужны Docker Desktop с Compose, Python 3.11+ и OpenSSL CLI 3+. Адреса стенда привязаны к localhost. Bootstrap собирает приложение; существующий закреплённый MinIO image используется, а если его нет — Compose соберёт его из pinned source commit (Go-сборка занимает время).
```sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
cp .env.example .env
python3 scripts/lab7.py bootstrap
make check validate lint PYTHON=.venv/bin/python
make test test-security
python3 tests/lab7_security.py
```
Compose-проект этого репозитория: `mtusi2026lab77`; его volumes отделены от предыдущего стенда. Если порт 8443 занят старым стендом, перед bootstrap остановите тот стенд через его `docker compose down` без удаления volumes.
API: **https://localhost:8443**. Публичный CA: `.local/trust/ca.crt`. Проверка сертификата обязательна, `--insecure` не используется.
Grafana: https://localhost:13000, пользователь admin. Пароль оператор читает локально в `.local/operator/grafana.env`; его нельзя вставлять в отчёт/логи. Dashboard `messenger-lab6` сохранён из предыдущей работы. Grafana требует входа и имеет read-only mTLS identities к datasource. OpenBao operator endpoint https://localhost:18200 требует operator certificate; скрипты используют его автоматически.
`.local` создаётся с mode 0700 и не включается в Git/образы/архив сдачи. Не копировать её при переносе проекта: новый стенд должен создавать новые ключи и секреты. Root/unseal material находится только у оператора и не монтируется в runtime приложения и сервер OpenBao.
## Проверки
```sh
python3 tests/lab7_s3_rotation.py # S3 credentials: новый доступ и отзыв старого
python3 tests/lab7_lifecycle.py # реальные смены доступа, sealed/unseal; около 2 минут
python3 scripts/argon-budget.py # измерение двух параметров Argon2 в API container
python3 tests/lab7_audit.py # контейнеры, telemetry, публичные файлы
make test-persistence ACTION_SCRIPT=scripts/restart.sh
python3 scripts/test-failovers.py # public test и адресный отказ обеих реплик
python3 scripts/scan.py # сканирование всех разных runtime images, без Docker socket
```
Публичные `tests/` и контракты задания сохранены. Собственные проверки — дополнительные `lab7_*.py`; матрица доверия заполнена по заданию. Evidence содержит только безопасные summaries/scan reports.
## Эксплуатация
```sh
# Остановить без удаления данных:
docker compose down
# После запуска запечатанного OpenBao:
docker compose up -d openbao
python3 scripts/lab7.py unseal
# Повторный bootstrap также сохраняет существующие данные и KV:
python3 scripts/lab7.py bootstrap
# Смена рабочего секрета и сертификата без пересборки:
python3 scripts/lab7.py rotate-secret
python3 scripts/lab7.py rotate-cert --role worker
```
Leaf-сертификаты действуют 2 дня, CRL 7 дней. Это учебные короткие сроки: перед истечением нужно выполнить документированное обновление identities, автоматический CA rollover на 5 не заявлен. Если стенд долго не использовался и leaf уже истекли, см. восстановление в RUNBOOK.md.
Подробности: [отчёт](REPORT.md), [матрица](contracts/trust-matrix.md), [модель угроз](security/THREAT_MODEL.md), [эксплуатация](RUNBOOK.md), [разбор сканирования](SCAN_TRIAGE.md), [исходное задание](LAB7_TASK.md).