From eb6655c72ffe441981ac2cc033195201bc977898 Mon Sep 17 00:00:00 2001 From: Dmitrii Grishko Date: Sun, 15 Nov 2026 22:22:09 +0300 Subject: [PATCH] docs: update REPORT.md --- REPORT.md | 70 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 44 insertions(+), 26 deletions(-) diff --git a/REPORT.md b/REPORT.md index f80c439..2976797 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,50 +1,68 @@ -# Лабораторная 7. Безопасность, mTLS и OpenBao +# Лабораторная 7 - Автор — Гришко Дмитрий Михайлович, БВТ2303. - Целевая оценка — 4. -- Решение — ветка `solution/Grishko-BVT2303`. +- PR: . - Источники — задание курса, документация [RabbitMQ](https://www.rabbitmq.com/docs/ssl) и [OpenBao](https://openbao.org/docs/auth/cert/). Библиотеки указаны в `src/go.mod`. Codex использовался при переносе, реализации и проверках. -## Запуск +## Запуск из чистого клона -Нужны Linux, Docker Compose, OpenSSL, Python 3.9+ и curl. Go 1.22.2 и версии сервисов закреплены в [Dockerfile](src/Dockerfile) и [Compose](compose.yml). +Нужны Linux, Git, Docker Compose, OpenSSL, Python 3.9+ и curl. Приложение собирается на Go 1.22.2. Версии образов указаны в [Dockerfile](src/Dockerfile) и [compose.yml](compose.yml). ```sh +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 # после запуска запечатанного OpenBao +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` создаёт локальные credentials и сертификаты, запускает зависимости и применяет миграции и ACL. Операторский файл хранится на хосте с правами 0600. Внешний endpoint использует отдельный CA. Compose задаёт TLS endpoints и получает runtime-секреты из OpenBao. Основные параметры стенда, включая порт и TTL сессии, читаются из `.env`. +`app-provision` создаёт `.env` и локальные ключи и пароли, поднимает зависимости, применяет миграции и настраивает права. `init` выполняют один раз для нового тома OpenBao. После перезапуска OpenBao достаточно повторить `unseal` и запустить приложение. Файл оператора хранится на хосте с правами 0600. `make app-up` ждёт ответа HTTPS на `/health/ready`. -`make app-stop` сохраняет тома. `docker compose down -v` удаляет учебные данные вместе с хранилищем OpenBao. +`make app-stop` останавливает контейнеры с сохранением данных. Для намеренного удаления учебных томов используется `docker compose down -v`. -## Архитектура +## Архитектура и решения -Из ЛР 6 перенесены API, фоновые задания и телеметрия. HAProxy принимает HTTPS и проверяет API по mTLS. PostgreSQL хранит сообщения, метаданные и намерения обработки. Dispatcher публикует задания в RabbitMQ, worker подтверждает их после фиксации результата. Вложения хранятся в S3, сессии и лимит входа — в Redis. Сервисы получают секреты по сертификату из OpenBao и хранят их в tmpfs. +Из ЛР 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 при запуске. [Матрица доверия](contracts/trust-matrix.md) · [Модель угроз](security/THREAT_MODEL.md) -## Проверки +## Доказательства критериев -| Критерий | Команда и наблюдение | Доказательство | -| --- | --- | --- | -| HTTPS и Argon2id | `make test test-security CA_FILE=secrets/tls/lab7-ingress-ca.crt` прошёл. Argon2id 64 МиБ, 3 прохода, p=2. При 0,5 CPU проверка занимала 177–196 мс в трёх сериях по три операции. | [HTTPS](evidence/grade3-https.md), [замер](evidence/grade3-argon2.md) | -| mTLS HAProxy → API | `python3 scripts/check_ingress_mtls.py` подтвердил отказ обеих реплик без сертификата, с чужим CA и с чужим SAN. | [mTLS](evidence/grade3-mtls.md) | -| TLS зависимостей и OpenBao | `python3 scripts/check_grade3_tls.py` проверил TLS хранилищ, брокера и телеметрии. `python3 scripts/check_bao_roles.py` подтвердил чтение своего KV-пути и запрет чужого чтения и записи. | [TLS](evidence/grade3-dependencies.md), [OpenBao](evidence/grade3-openbao.md) | -| Изоляция контейнеров и лимиты worker | `python3 scripts/check_grade3_runtime.py` подтвердил локальные порты, сброс capabilities, read-only root и tmpfs у проверяемых сервисов. Worker ограничен одним CPU, 512 МиБ и 60 с на обработку по умолчанию. | [Изоляция](evidence/grade4-hardening.md) | -| ACL, сессии и лимиты запросов | Проверки отклонили чужие вложения, подмену пользователя, неверный MIME, превышение размера и просроченную сессию. На 13-й попытке две реплики совместно применили лимит 429. Logout подтверждён smoke. | [ACL](evidence/grade3-http-security.md), [expiry](evidence/grade3-expiry.md), [rate limit](evidence/grade3-login.md) | -| mTLS брокера и Collector | `python3 scripts/collect_grade4.py --only grade4-mtls` подтвердил отказ чужой identity того же CA, раздельные права RabbitMQ и доставку телеметрии. | [Identity и ACL](evidence/grade4-mtls.md) | -| Rehash и нагрузка на вход | `python3 scripts/check_grade4_login.py` подтвердил обновление хеша в PostgreSQL. При 24 параллельных запросах получено 8 ответов 201 и 16 ответов 429. Медиана 548 мс, максимум 1156 мс. | [Rehash и нагрузка](evidence/grade4-login.md) | -| Ротация и отказ OpenBao | `python3 scripts/check_grade4_lifecycle.py` подтвердил замену пароля БД и leaf OpenBao без пересборки, отказ старым credentials и истечение токена. При seal новый вход в OpenBao отклонялся, запущенный API оставался готов. | [Ротация](evidence/grade4-lifecycle.md) | -| Модель угроз и аудит телеметрии | `python3 scripts/collect_grade4.py --only grade4-audit` подтвердил TLS и ACL. Контрольный секрет отсутствовал в связанном логе, трейсе, метриках и логах контейнеров. | [Аудит](evidence/grade4-audit.md) | -| Сканирование | `./scripts/scan_grade4.sh` проверил зависимости и образы Trivy. Для MinIO проверен текущий собранный образ из Compose. | [Скан](evidence/grade4-scan.md), [применимость](evidence/grade4-scan-triage.md) | +| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +| --- | --- | --- | --- | +| Публичный smoke по HTTPS | `make test test-security CA_FILE=secrets/tls/lab7-ingress-ca.crt` | API прошёл smoke. Соединение без доверия к CA отклонено. | [HTTPS](evidence/grade3-https.md) | +| Argon2id | Бенчмарк `BenchmarkPasswordVerification` при 0,5 CPU | 64 МиБ, 3 прохода, p=2. В трёх сериях по три операции среднее время проверки составило 177–196 мс. | [Замер](evidence/grade3-argon2.md) | +| mTLS HAProxy → API | `python3 scripts/check_ingress_mtls.py` | Обе реплики приняли сертификат HAProxy. Отказ без сертификата, с чужим CA и с чужим SAN. | [mTLS](evidence/grade3-mtls.md) | +| TLS зависимостей | `python3 scripts/check_grade3_tls.py`, `./scripts/check_dependency_roles.sh` | Хранилища, брокер и телеметрия приняли соединения с проверкой имени сервера и отклонили чужой CA. Проверены роли PostgreSQL, Redis и RabbitMQ. | [TLS и роли](evidence/grade3-dependencies.md) | +| Доступ к секретам | `python3 scripts/check_bao_roles.py` | Каждая роль прочитала свой путь KV. Попытки прочитать чужой путь или выполнить запись отклонены. | [OpenBao](evidence/grade3-openbao.md) | +| Изоляция и бюджет воркера | `python3 scripts/check_grade3_runtime.py` | Проверены локальные публикации портов, read-only root, сброс capabilities и tmpfs. Для воркера заданы 1 CPU, 512 МиБ и 60 с на обработку по умолчанию. | [Изоляция](evidence/grade4-hardening.md) | +| Вложения, сессии и лимит входа | `check_grade3_http.py`, `check_session_expiry.py`, `check_login_rate.py`, smoke | API отклонил чужое вложение, подмену пользователя, неверный MIME и превышение размера. Токен после выхода или истечения отклонён. На 13-й попытке входа получен 429. | [ACL](evidence/grade3-http-security.md), [сессии](evidence/grade3-expiry.md), [лимит](evidence/grade3-login.md) | +| mTLS брокера и Collector | `python3 scripts/collect_grade4.py --only grade4-mtls` | Сертификат чужой роли от того же CA отклонён. RabbitMQ запретил публикацию воркером и чтение диспетчером. Телеметрия поступила. | [Роли и mTLS](evidence/grade4-mtls.md) | +| Обновление хеша и нагрузка на вход | `python3 scripts/check_grade4_login.py` | Хеш обновился в PostgreSQL после успешного входа. Из 24 параллельных запросов 8 получили 201 и 16 получили 429. Медиана 548 мс, максимум 1156 мс. | [Вход под нагрузкой](evidence/grade4-login.md) | +| Ротация и запечатывание OpenBao | `python3 scripts/check_grade4_lifecycle.py` | Пароль БД и сертификат OpenBao заменены без пересборки. Старые данные и токен после истечения отклонены. При seal запущенный API оставался готов. | [Ротация](evidence/grade4-lifecycle.md) | +| Модель угроз и аудит | `python3 scripts/collect_grade4.py --only grade4-audit` | Повторены проверки TLS и ACL. Синтетический секрет не найден в связанном логе и трейсе, метриках и логах контейнеров. | [Аудит](evidence/grade4-audit.md) | +| Сканирование | `./scripts/scan_grade4.sh` | Trivy проверил зависимости и образы. Для MinIO использован текущий собранный образ, поскольку прежний ID Docker не смог экспортировать. | [Сканирование](evidence/grade4-scan.md), [применимость находок](evidence/grade4-scan-triage.md) | -## Отказы и ограничения +## Эксперименты и отказы -Перезапуск PostgreSQL, Redis, S3, RabbitMQ и обеих API сохранил данные и действующую сессию. При остановке первой API запись восстановилась за 1,454 и 1,580 с без потери подтверждённых сообщений. При остановленной второй реплике прошёл HTTPS smoke. [Перезапуск и отказ](evidence/grade3-resilience.md) · [Вторая реплика](evidence/grade3-other-replica.md) +| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +| --- | --- | --- | --- | +| Перезапуск PostgreSQL, Redis, S3, RabbitMQ и двух API | Данные и сессия сохраняются | Повторный запрос с прежним токеном прошёл. Время старта контейнеров изменилось. | Подтверждённые данные сохранились. [Результат](evidence/grade3-resilience.md) | +| Остановка первой реплики API | Вторая реплика продолжит принимать запросы | В двух прогонах прошли 124 и 122 записи. | Запись восстановилась за 1,454 и 1,580 с. Подтверждённые сообщения сохранились. [Результат](evidence/grade3-resilience.md) | +| Остановка второй реплики API | Первая реплика обслужит бизнес-сценарий | HTTPS smoke прошёл. | Время восстановления отдельно не замерялось. [Результат](evidence/grade3-other-replica.md) | -Стенд односерверный. Отказ хоста или единственного экземпляра хранилища выходит за рамки эксперимента. OpenBao требует ручного unseal. Пароли зависимостей статические и действуют до отзыва в соответствующем сервисе. +## Ограничения + +Стенд работает на одном хосте. Эксперименты покрывают перезапуск хранилищ и остановку одной API-реплики. OpenBao разблокируется вручную. Истечение токена OpenBao прекращает чтение KV, а уже выданный статический пароль действует до смены в целевом сервисе.