Files
mtusi2026lab7/README.md
T

113 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.
Это **skeleton**, а не готовый сервер. Здесь есть задание, контракт и публичные проверки. Реализацию приложения, Dockerfile и требуемую инфраструктуру пишет студент. Язык и framework свободные; UI не обязателен.
[Карта курса](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)
## Откуда начинаем
Перенесите минимум lab6. Бизнес-API сохраняется, внешний endpoint теперь HTTPS. Новые секреты и ключи создаются для стенда, не поставляются в skeleton.
**Архитектура:** Клиент — TLS → LB — mTLS → API; API/worker — TLS (+ клиентские cert где требуется матрицей) → зависимости; OpenBao выдаёт scoped credentials. Grafana/OTel остаются внутри доверенной сети.
## Что сделать
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
# Работает прямо в skeleton, Python 3.9+; приложение не запускается:
make check
# После реализации запустите свой сервер/стенд по REPORT.md.
# По умолчанию тест использует https://localhost:8443.
make test
```
`.env.example`, `compose.example.yaml` и `contracts/infrastructure.json` описывают настройки и роли компонентов. **compose.example.yaml — список ролей с пустым services, не запускаемый стенд.** Реализуйте свой `compose.yaml`/`stack.yaml`, закрепите версии образов, заполните локальный `.env` и опишите bootstrap/миграции. Все зависимости поднимаются из этого репозитория; ссылка «у меня БД уже установлена» не заменяет воспроизводимость.
```sh
# Compose-вариант после реализации:
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
# Дождитесь /health/ready; затем make test.
# Для Swarm укажите эквивалентные build/push/deploy-команды в REPORT.md.
```
Для HTTPS передайте публичный CA: `make test CA_FILE=/absolute/path/to/ca.crt`. CA certificate можно распространять; private keys создаются локально. `make test-security` проверяет только внешний TLS trust; внутренние отрицательные тесты реализуйте по [trust matrix](contracts/trust-matrix.md).
Примеры запросов доступны в `examples/requests.http`, примеры JSON — в `contracts/examples.json`. Для полной проверки схемы (по желанию локально; CI делает её автоматически):
```sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make validate PYTHON=.venv/bin/python
```
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/)