Files
mtusi2026lab7/README.md
T
2026-11-04 19:22:35 +03:00

119 lines
14 KiB
Markdown
Raw 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
Защитить работающий мессенджер на границах доверия и показать защиту отрицательными проверками: чужой доступ, неверный сертификат, недостаточные права и отзыв 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/)