# Лабораторная 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/)