Files
mtusi2026lab7-fork/README.md
T

13 KiB
Raw Blame History

Лабораторная 7. Безопасность, mTLS и OpenBao

Защитить работающий мессенджер на границах доверия и показать защиту отрицательными проверками: чужой доступ, неверный сертификат, недостаточные права и отзыв credentials.

В репозитории реализован уровень «4». Перенесённый мессенджер работает через HTTPS, внутренняя связь nginx с API требует mTLS, а сервисы получают пароли PostgreSQL по ограниченным политикам OpenBao. RabbitMQ и Collector проверяют отдельные сертификаты сервисов.

Карта курса · Процесс fork/PR · OpenAPI · Семантика API · Проверки · Отчёт · Примеры JSON · Памятка преподавателю

Откуда начинаем

Перенесите минимум 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 и аудит.

Как начать и проверить

Нужны Python 3.12, Docker Compose и OpenSSL. Подробности запуска, проверок и остановки приведены в отчёте.

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
make init
make up
make check validate test test-security

Публичные проверки используют https://localhost:8443 и локальный публичный CA. Для другого адреса задайте BASE_URL, для другого доверенного CA — CA_FILE. make verify дополнительно создаёт отдельный тестовый стенд, проверяет внутренние политики, наблюдаемость, перезапуск, отказ реплики и ротацию worker. Сканирование зависимостей и локальных сборок запускается командой make scan-security. Матрица доверия · Проверки · OpenBao

Сценарий защиты

  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, укажите целевую оценку/трек. Не меняйте обязательный контракт и публичные tests ради зелёного результата. Сохраняйте возможности предыдущих лабораторных в пределах объявленных переходов.

Вопросы на защите

  • Какая часть mTLS проверяет шифрование, какая идентичность и где разрешение на действие?
  • Почему доверенный CA ещё не означает, что любой его клиент может быть LB?
  • Где хранится первый секрет для доступа к OpenBao и кто имеет право unseal?
  • Что происходит при истечении credentials, остановке OpenBao и рестарте API?

Первичные материалы