forked from mtusi2026/mtusi2026lab7
119 lines
14 KiB
Markdown
119 lines
14 KiB
Markdown
# Лабораторная 7. Безопасность, mTLS и OpenBao
|
||
|
||
Защитить работающий мессенджер на границах доверия и показать защиту отрицательными проверками: чужой доступ, неверный сертификат, недостаточные права и отзыв credentials.
|
||
|
||
Основа приложения и проверок перенесена из lab6. В этой работе сохранены REST API, PostgreSQL, S3-вложения, RabbitMQ worker и OpenTelemetry-стенд; внешний ingress работает по HTTPS, связь LB→API — по mTLS с проверкой URI SAN, пароли хешируются Argon2id, а рабочие secrets выдаются сервисам через OpenBao AppRole.
|
||
|
||
[Карта курса](COURSE.md) · [Процесс fork/PR](CONTRIBUTING.md) · [OpenAPI](contracts/openapi.json) · [Семантика API](contracts/README.md) · [Проверки](tests/README.md) · [Отчёт](REPORT.md) · [Примеры JSON](contracts/examples.json) · [Памятка преподавателю](MAINTAINERS.md)
|
||
|
||
## Состав стенда
|
||
|
||
**Архитектура:** клиент — TLS → HAProxy — mTLS → API; API, worker, publisher, migrator и reconciler получают секреты через отдельные AppRole policies. Основные сервисы и observability сохраняют архитектуру lab6.
|
||
|
||
## Что сделать
|
||
|
||
1. Составьте модель угроз и contracts/trust-matrix.md: активы, акторы, границы, протокол/идентичность каждой связи и проверяемые отказы.
|
||
2. Переведите password storage на Argon2id, настройте сессии/лимиты и проведите негативные тесты ACL/вложений.
|
||
3. Сделайте внешний TLS и обязательное внутреннее mTLS LB→API. Для остальных связей следуйте матрице: шифрование и отдельные identities; на 4 расширяется mTLS.
|
||
4. Добавьте OpenBao вне dev-mode: постоянное хранение, документированный init/unseal, политики и аутентификация сервисов с ограниченным TTL. Root token и unseal keys остаются у оператора.
|
||
5. Уберите избыточные privileges/ports, задайте лимиты, проверьте certificates/secrets lifecycle. Повторите smoke, перезапуск и отказ реплики через HTTPS без отключения проверки сертификата.
|
||
|
||
## Оценка «3»: работающий минимум
|
||
|
||
- Все предыдущие обязательные возможности работают через HTTPS с проверяемым CA и hostname/SAN. Argon2id хранит salt и параметры; базовая конфигурация не ниже 19 MiB, t=2, p=1, итоговые параметры обоснованы измерением на своём стенде.
|
||
- LB→каждая API-реплика использует обязательное mTLS: без client certificate, с чужим CA или неверной identity соединение отклоняется; прямого обхода публичным API-портом нет. Сервер проверяет не только цепочку CA, но и разрешённую identity (SAN/роль).
|
||
- Остальные сетевые связи с DB, S3, broker, Collector, telemetry backends и OpenBao шифруются TLS с проверкой сервера; где продукт не поддерживает native TLS, используется проверенный TLS proxy/sidecar и закрытый локальный hop. Раздельные учётные данные и минимальные права фиксируются в матрице.
|
||
- OpenBao — часть общего стенда, работает не в dev-mode с persistent storage. API/worker получают secrets через сервисную аутентификацию и scoped policy; приложение не использует root token, unseal keys или безграничный общий токен.
|
||
- Контейнеры без privileged/host network/Docker socket; app и worker — non-root, без лишних capabilities, с resource limits. Наружу доступны только нужный TLS ingress и локальные административные интерфейсы. Secret values/ключи не попадают в Git, образы или telemetry.
|
||
- Есть ограничение частоты входа с 429/Retry-After, ограничение размера запросов, тесты доступа постороннего, logout/expiry и проверка недоверенного TLS. Публичный smoke по HTTPS проходит; сертификаты создаются локально через документированный bootstrap.
|
||
|
||
## Оценка «4»: уровень стажёра/джуна
|
||
|
||
Весь уровень 3 **и все** пункты ниже:
|
||
|
||
- mTLS дополнительно защищает API/worker→broker и API/worker→OTel Collector, с разными service identities. Доказано, что чужой, но подписанный тем же CA сертификат не даёт лишние права. Для нестандартного broker допускается sidecar с эквивалентной проверкой.
|
||
- Пароли/сессионные token hashes и ошибки не раскрывают credentials; есть rehash старого password hash при успешном входе и измеренный бюджет защиты от дорогостоящего login DoS. Rate limit общий для реплик.
|
||
- Показаны ротация одного рабочего secret и одного leaf certificate без пересборки образов, отзыв старой identity и ограниченное поведение при expiry/sealed OpenBao. Описаны bootstrap trust и renewal, в приложение не встроен постоянный секрет «для получения секретов».
|
||
- Добавлены read_only/no-new-privileges/drop capabilities и отдельные tmpfs там, где это совместимо; исключения для stateful сервисов объяснены. Есть dependency/image scan с разбором применимости, а не только скриншот количества CVE.
|
||
- Модель угроз связывает минимум 6 конкретных угроз с контролями и воспроизводимыми отрицательными тестами. Upload-worker ограничен по CPU/RAM/времени; TLS-аудит проверяет всю заявленную матрицу, ACL и отсутствие утечек в telemetry.
|
||
|
||
## Оценка «5»: исследование и доказанный результат
|
||
|
||
Весь уровень 4 **и один законченный трек на выбор**. Приведите гипотезу, повторяемую методику, результаты и ограничения.
|
||
|
||
**Трек 1. Компрометация worker.** На изолированном стенде смоделируйте получение прав worker: покажите, какие bucket-prefix, queue и DB-операции доступны, а какие запрещены. Отзовите identity, ротируйте связанный secret, восстановите обработку и докажите сохранность задач. Сопоставьте последствия до/после least privilege.
|
||
|
||
**Трек 2. Жизненный цикл PKI/secrets.** Автоматизируйте выдачу короткоживущих cert/credentials, renewal и безопасный rollover CA/leaf. Проведите тест истечения/отзыва под нагрузкой, измерьте ошибки и восстановление; покажите отсутствие fallback на plaintext/проверку сертификата off. Обоснуйте хранение CA, bootstrap и аудит.
|
||
|
||
## Как начать и проверить
|
||
|
||
```sh
|
||
python3 -m venv .venv
|
||
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
|
||
cp .env.example .env
|
||
.venv/bin/python scripts/bootstrap-secrets.py
|
||
.venv/bin/python scripts/bootstrap-pki.py
|
||
make check
|
||
|
||
# Сначала хранилища и OpenBao:
|
||
docker compose --env-file .env up -d postgres rabbitmq s3-core s3 openbao
|
||
# Оператор инициализирует и unseal-ит OpenBao; root token/unseal shares
|
||
# сохраняются вне репозитория и передаются только скрипту bootstrap:
|
||
docker compose exec -it -e BAO_CACERT=/run/secrets/ca_crt openbao bao operator init
|
||
docker compose exec -it -e BAO_CACERT=/run/secrets/ca_crt openbao bao operator unseal
|
||
# Повторите unseal для требуемого порога shares.
|
||
python3 scripts/bootstrap-openbao.py --root-token-file /secure/path/openbao-root-token
|
||
|
||
docker compose --env-file .env config --quiet
|
||
docker compose --env-file .env up -d --build
|
||
make test PYTHON=.venv/bin/python BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
|
||
make test-security PYTHON=.venv/bin/python BASE_URL=https://localhost:8443 CA_FILE="$PWD/secrets/pki/ca.crt"
|
||
make test-worker-isolation
|
||
make test-worker-rotation PYTHON=.venv/bin/python ROOT_TOKEN_FILE=/secure/path/openbao-root-token
|
||
```
|
||
|
||
`.env.example` содержит открытые локальные настройки. PKI и локальные bootstrap secrets создаются в игнорируемом Git каталоге `secrets/`. `compose.example.yaml` — worksheet; запускаемый стенд находится в `compose.yaml`. Образы закреплены версиями, данные приложения и OpenBao хранятся в named volumes. Обычная остановка сохраняет учебные данные (`docker compose down`); намеренное удаление данных выполняется отдельно (`docker compose down -v`).
|
||
|
||
|
||
Примеры запросов доступны в `examples/requests.http`, примеры JSON — в `contracts/examples.json`. Для полной проверки схемы (по желанию локально; CI делает её автоматически):
|
||
|
||
```sh
|
||
make validate PYTHON=.venv/bin/python
|
||
make test-primitives PYTHON=.venv/bin/python
|
||
make test-openbao-acl PYTHON=.venv/bin/python
|
||
make test-argon-budget
|
||
.venv/bin/pip-audit -r requirements.txt
|
||
```
|
||
|
||
Smoke не выставляет оценку автоматически. Проверку сохранности/отказов запускайте явно по [tests/README.md](tests/README.md), остальные доказательства приведите в отчёте.
|
||
|
||
## Сценарий защиты
|
||
|
||
1. Развернуть стенд по инструкции оператора, локально создать secrets/CA; выполнить make test BASE_URL=https://localhost:8443 CA_FILE=<путь-к-CA>.
|
||
2. Запустить make test-security: внешний endpoint обязан отклонять недоверенный CA; затем авторизованный HTTPS smoke и тесты ACL/logout.
|
||
3. Скрипт студента доказывает внутреннее mTLS: нет сертификата / чужой CA / неверная identity при доверенном CA → отказ; правильная identity → успех. TLS proxy без проверки client identity не засчитывается.
|
||
4. Показать OpenBao policy allow/deny, отсутствие root credential в app, перезапуск с сохранением данных и последовательный отказ API-реплик.
|
||
5. Для 4: ротация/expiry и вся расширенная матрица; для 5: повторяемый сценарий компрометации или PKI lifecycle.
|
||
|
||
## Что должно быть в PR
|
||
|
||
Threat model, заполненная trust matrix, TLS/mTLS конфигурации, OpenBao policies и bootstrap/rotation scripts без secrets, scan triage и отрицательные тесты.
|
||
|
||
Заполните `REPORT.md` и [шаблон PR](.github/pull_request_template.md), укажите целевую оценку/трек. Не меняйте обязательный контракт и публичные tests ради зелёного результата. Сохраняйте возможности предыдущих лабораторных в пределах [объявленных переходов](COURSE.md).
|
||
|
||
## Вопросы на защите
|
||
|
||
- Какая часть mTLS проверяет шифрование, какая идентичность и где разрешение на действие?
|
||
- Почему доверенный CA ещё не означает, что любой его клиент может быть LB?
|
||
- Где хранится первый секрет для доступа к OpenBao и кто имеет право unseal?
|
||
- Что происходит при истечении credentials, остановке OpenBao и рестарте API?
|
||
|
||
## Первичные материалы
|
||
|
||
- [OWASP Password Storage](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html)
|
||
- [OWASP File Upload](https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html)
|
||
- [OpenBao AppRole](https://openbao.org/docs/auth/approle/)
|
||
- [OpenBao policies](https://openbao.org/docs/concepts/policies/)
|
||
- [OpenBao production hardening](https://openbao.org/docs/internals/security/)
|
||
- [Docker security](https://docs.docker.com/engine/security/)
|