forked from mtusi2026/mtusi2026lab7
61 lines
5.1 KiB
Markdown
61 lines
5.1 KiB
Markdown
# Лабораторная 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).
|