Files
mtusi2026lab7/REPORT.md
T
Dmitrii Grishko eb6655c72f
Skeleton contracts / contracts (pull_request) Canceled after 0s
docs: update REPORT.md
2026-11-15 22:22:09 +03:00

12 KiB

Лабораторная 7

  • Автор — Гришко Дмитрий Михайлович, БВТ2303.
  • Целевая оценка — 4.
  • PR: .
  • Источники — задание курса, документация RabbitMQ и OpenBao. Библиотеки указаны в src/go.mod. Codex использовался при переносе, реализации и проверках.

Запуск из чистого клона

Нужны Linux, Git, Docker Compose, OpenSSL, Python 3.9+ и curl. Приложение собирается на Go 1.22.2. Версии образов указаны в Dockerfile и compose.yml.

git clone --branch solution/Grishko-BVT2303 --single-branch https://gitea.privcloud.tech/TAskMAster339/mtusi2026lab7-fork.git
cd mtusi2026lab7-fork
make app-provision
python3 scripts/bao_operator.py init
python3 scripts/bao_operator.py unseal
python3 scripts/configure_bao.py --operator-file secrets/bao-operator.json
make app-up
make test test-security CA_FILE=secrets/tls/lab7-ingress-ca.crt

app-provision создаёт .env и локальные ключи и пароли, поднимает зависимости, применяет миграции и настраивает права. init выполняют один раз для нового тома OpenBao. После перезапуска OpenBao достаточно повторить unseal и запустить приложение. Файл оператора хранится на хосте с правами 0600. make app-up ждёт ответа HTTPS на /health/ready.

make app-stop останавливает контейнеры с сохранением данных. Для намеренного удаления учебных томов используется docker compose down -v.

Архитектура и решения

Из ЛР 6 перенесены API мессенджера, обработка вложений и сбор телеметрии. В ЛР 7 добавлены TLS между сервисами, отдельные сервисные роли и выдача учётных данных через OpenBao.

Вход в API. Клиент подключается к HAProxy на localhost:8443. Балансировщик проверяет имя в сертификате каждой реплики API и проверяет готовность реплик тоже по mTLS. Реплики принимают клиентский сертификат с URI SAN балансировщика. Порты реплик доступны внутри Docker. Доступ к сообщениям и вложениям API проверяет по Bearer-сессии и членству в чате. Обе реплики используют Redis для сессий и общего счётчика попыток входа по IP.

Обработка вложений. API сохраняет исходный файл в закрытом staging-префиксе S3. Метаданные вложения и запись о задании появляются в одной транзакции PostgreSQL. Диспетчер читает запись из БД и публикует задание в RabbitMQ. Воркер забирает файл из staging, сохраняет оригинал и производные изображения в S3 и фиксирует результат в PostgreSQL. Подтверждение RabbitMQ отправляется после записи результата или решения о повторе. После обрыва соединения неподтверждённое задание может поступить повторно. Воркер сверяет версию задания и его состояние в БД перед обработкой.

Идентичность и секреты. В RabbitMQ сертификаты диспетчера и воркера сопоставляются с разными учётными записями через SASL EXTERNAL. Диспетчер может публиковать, воркер может читать очередь. Collector принимает только зарегистрированные сертификаты API, диспетчера и воркера. При старте каждый прикладной процесс получает в OpenBao токен на чтение своего пути KV. Пароли зависимостей записываются в tmpfs и используются до перезапуска процесса или отзыва в самой зависимости. Сертификаты и операторские ключи создаются локально.

API_HTTPS_PORT, API_REPLICAS и SESSION_TTL_SECONDS задают внешний порт, число реплик и срок сессии. Адреса TLS-сервисов заданы в Compose. Файлы подключения приложений заполняются из OpenBao при запуске.

Матрица доверия · Модель угроз

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke по HTTPS make test test-security CA_FILE=secrets/tls/lab7-ingress-ca.crt API прошёл smoke. Соединение без доверия к CA отклонено. HTTPS
Argon2id Бенчмарк BenchmarkPasswordVerification при 0,5 CPU 64 МиБ, 3 прохода, p=2. В трёх сериях по три операции среднее время проверки составило 177–196 мс. Замер
mTLS HAProxy → API python3 scripts/check_ingress_mtls.py Обе реплики приняли сертификат HAProxy. Отказ без сертификата, с чужим CA и с чужим SAN. mTLS
TLS зависимостей python3 scripts/check_grade3_tls.py, ./scripts/check_dependency_roles.sh Хранилища, брокер и телеметрия приняли соединения с проверкой имени сервера и отклонили чужой CA. Проверены роли PostgreSQL, Redis и RabbitMQ. TLS и роли
Доступ к секретам python3 scripts/check_bao_roles.py Каждая роль прочитала свой путь KV. Попытки прочитать чужой путь или выполнить запись отклонены. OpenBao
Изоляция и бюджет воркера python3 scripts/check_grade3_runtime.py Проверены локальные публикации портов, read-only root, сброс capabilities и tmpfs. Для воркера заданы 1 CPU, 512 МиБ и 60 с на обработку по умолчанию. Изоляция
Вложения, сессии и лимит входа check_grade3_http.py, check_session_expiry.py, check_login_rate.py, smoke API отклонил чужое вложение, подмену пользователя, неверный MIME и превышение размера. Токен после выхода или истечения отклонён. На 13-й попытке входа получен 429. ACL, сессии, лимит
mTLS брокера и Collector python3 scripts/collect_grade4.py --only grade4-mtls Сертификат чужой роли от того же CA отклонён. RabbitMQ запретил публикацию воркером и чтение диспетчером. Телеметрия поступила. Роли и mTLS
Обновление хеша и нагрузка на вход python3 scripts/check_grade4_login.py Хеш обновился в PostgreSQL после успешного входа. Из 24 параллельных запросов 8 получили 201 и 16 получили 429. Медиана 548 мс, максимум 1156 мс. Вход под нагрузкой
Ротация и запечатывание OpenBao python3 scripts/check_grade4_lifecycle.py Пароль БД и сертификат OpenBao заменены без пересборки. Старые данные и токен после истечения отклонены. При seal запущенный API оставался готов. Ротация
Модель угроз и аудит python3 scripts/collect_grade4.py --only grade4-audit Повторены проверки TLS и ACL. Синтетический секрет не найден в связанном логе и трейсе, метриках и логах контейнеров. Аудит
Сканирование ./scripts/scan_grade4.sh Trivy проверил зависимости и образы. Для MinIO использован текущий собранный образ, поскольку прежний ID Docker не смог экспортировать. Сканирование, применимость находок

Эксперименты и отказы

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
Перезапуск PostgreSQL, Redis, S3, RabbitMQ и двух API Данные и сессия сохраняются Повторный запрос с прежним токеном прошёл. Время старта контейнеров изменилось. Подтверждённые данные сохранились. Результат
Остановка первой реплики API Вторая реплика продолжит принимать запросы В двух прогонах прошли 124 и 122 записи. Запись восстановилась за 1,454 и 1,580 с. Подтверждённые сообщения сохранились. Результат
Остановка второй реплики API Первая реплика обслужит бизнес-сценарий HTTPS smoke прошёл. Время восстановления отдельно не замерялось. Результат

Ограничения

Стенд работает на одном хосте. Эксперименты покрывают перезапуск хранилищ и остановку одной API-реплики. OpenBao разблокируется вручную. Истечение токена OpenBao прекращает чтение KV, а уже выданный статический пароль действует до смены в целевом сервисе.