Files
mtusi2026lab7/REPORT.md

17 KiB
Raw Permalink Blame History

Отчёт — лабораторная 7

Сведения о работе

  • Автор, группа: Перевалова Виктория, БПИ2302.
  • Целевая оценка: 3.
  • Выбранный трек 5: не заявлен.
  • Commit/PR: не указан.
  • Использованные технологии: Python 3.11, FastAPI, SQLAlchemy, PostgreSQL, Redis, RabbitMQ, SeaweedFS/S3 API, OpenBao 2.2.0, Docker Compose, Nginx, TLS/stunnel, pytest/скрипты проверки проекта.
  • Помощь ИИ: использовалась при анализе требований, диагностике, проверке конфигурации и подготовке документации. Реализация и результаты проверок должны быть подтверждены локальным стендом.

Запуск и эксплуатация

Рабочее окружение — Windows PowerShell, Docker Compose. Проверки выполнялись на локальном стенде с внешним HTTPS endpoint https://localhost:8443 и CA-файлом secrets/tls/ca.crt.

Предварительные условия

  • Docker Desktop с поддержкой Docker Compose.
  • Python 3.11 для запуска локальных проверочных скриптов.
  • Локально подготовленные .env и TLS secrets/certificates согласно README.md, infra/README.md, infra/openbao/README.md и contracts/README.md.
  • TLS private keys, CA private key, OpenBao root token, unseal shares и AppRole SecretID должны создаваться/передаваться оператором вне Git. Секреты в отчёт не включаются.

Запуск существующего стенда

Из корня репозитория:

docker compose up -d --build
docker compose ps

Проверка внешней готовности:

Invoke-WebRequest `
  -Uri https://localhost:8443/health/ready `
  -Certificate (Get-Item .\secrets\tls\ca.crt)

Для Python-проверок:

python .\tests\smoke.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt
python .\tests\security.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt
python .\tests\test_login_rate_limit.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt

Команда security.py проверяет внешний HTTPS и отказ при пустом trust store. Внутренний mTLS и OpenBao ACL проверялись отдельными сценариями, описанными ниже.

Остановка

Обычная остановка без удаления постоянных данных:

docker compose stop

Для последующего запуска:

docker compose start

Удаление volumes намеренно не выполнялось. Команду docker compose down -v нельзя использовать как обычную остановку: она удаляет постоянные данные стенда.

Для воспроизведения из чистого clone необходимо выполнить локальный bootstrap секретов и конфигурации по README-файлам проекта. Точные значения секретов в отчёте не приводятся.

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

Стенд развёрнут контейнерами Docker Compose. Внешний REST-трафик проходит через Nginx ingress по HTTPS на 127.0.0.1:8443. API не публикует собственный бизнес-порт на хост. Внутренний доступ LB → API защищён mTLS: API проверяет клиентский сертификат и разрешённую URI SAN identity spiffe://lab7/ingress/nginx.

Основные компоненты:

  • Nginx — внешний TLS ingress и проксирование запросов к API.
  • API — FastAPI-приложение; две реплики в Compose.
  • PostgreSQL — постоянное хранилище пользователей, сессий, чатов, сообщений, вложений, задач и outbox-записей.
  • Redis — вспомогательное хранилище/координация, в том числе для ограничения частоты входа.
  • RabbitMQ — брокер задач обработки вложений.
  • SeaweedFS/S3 API — хранение исходных файлов и производных объектов.
  • Worker — асинхронная обработка изображений.
  • Outbox publisher — публикация событий из transactional outbox.
  • OpenBao — хранение секретов с сервисными AppRole identities и отдельными policy.
  • TLS proxy/stunnel — TLS-граница для внутренних соединений, где приложение/сервис использует локальный proxy hop.
  • Telemetry/Collector — сбор телеметрии согласно конфигурации infra.

Вложения загружаются в staging, для них создаются записи БД и задания обработки. Worker забирает задания из брокера, обрабатывает изображения и сохраняет варианты в S3-совместимое хранилище. Метаданные и состояние обработки хранятся в PostgreSQL. Доступ к вложению проверяется по членству пользователя в чате. Для загрузки действует предел 10 MiB: проверяется и заявленный Content-Length, и фактически прочитанный размер потока; при превышении возвращается HTTP 413.

Пароли пользователей хешируются Argon2id. Проверенная конфигурация: time_cost=2, memory_cost=19456 KiB, parallelism=1. Ограничение входа настроено на 5 неудачных попыток в окне 60 секунд; при превышении API возвращает HTTP 429 и Retry-After.

OpenBao работает не в dev mode, использует persistent storage и TLS listener. API, Worker и Outbox используют отдельные AppRole credentials и scoped policies. Проверены чтение собственного пути (HTTP 200), отказ чтения чужого пути (HTTP 403) и отказ записи (HTTP 403). Приложения подключаются к OpenBao по HTTPS с проверкой CA.

Контейнерная изоляция

По результатам docker inspect:

  • API: пользователь app, read_only=true, privileged=false, CapDrop=ALL, лимит памяти 768 MiB, CPU 1.
  • Worker: пользователь app, read_only=true, privileged=false, CapDrop=ALL, лимит памяти 1 GiB, CPU 1.
  • Outbox publisher: пользователь app, read_only=true, privileged=false, CapDrop=ALL, лимит памяти 384 MiB, CPU 0.5.
  • Nginx: пользователь 101:101, privileged=false, CapDrop=ALL.
  • Все проверенные контейнеры не используют host network. В compose.yaml и Dockerfile не обнаружены ссылки на Docker socket, network_mode: host или privileged: true.
  • API port не опубликован напрямую на хост; внешняя точка входа — Nginx на loopback 127.0.0.1:8443. Административные endpoints OpenBao и вспомогательные порты привязаны к loopback.

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

Критерий Команда / сценарий Наблюдаемый результат Статус
Argon2id Проверка app/services/user_service.py и runtime env API Argon2id; time_cost=2, memory_cost=19456 KiB, parallelism=1 PASS
Внешний HTTPS python .\tests\security.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt Доверенный CA/hostname принимается; пустой trust store отклонён именно ошибкой проверки сертификата PASS
Публичный API smoke python .\tests\smoke.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt PASS: lab7 public API scenario; проверены пользователи, чаты, сообщения, ошибки доступа, вложения и logout PASS
Login rate limit python .\tests\test_login_rate_limit.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt PASS: login rate limit returns 429 and Retry-After PASS
Размер вложения Анализ app/api/attachments.py, read_limited() и вызова в upload_attachment() Проверяются Content-Length и реальный поток; превышение MAX_BYTES (10 MiB) приводит к HTTP 413. Отдельный runtime negative upload test не зафиксирован Реализация подтверждена; отдельный тест не заявлен
Доступ к вложениям Smoke: GET metadata/content от участника и постороннего пользователя Для постороннего пользователя metadata и content возвращают 404 PASS
Logout Smoke: DELETE /api/v1/auth/sessions/current, затем GET /api/v1/users/me Logout возвращает 204; повторный запрос со старой сессией возвращает 401 PASS
Подмена пользователя Smoke: запрос с X-User-Id другого пользователя Bearer identity не меняется PASS
Внутренний mTLS Временный probe в API container: no-cert, foreign-CA, wrong-identity, positive Без сертификата и с чужим CA — TLS отказ; Worker identity от доверенного CA — отказ API; ingress identity — успех PASS
OpenBao TLS Запрос из API container к https://openbao:8200/v1/sys/health с verify=/run/tls/ca.crt HTTP 200, TLS verification PASS PASS
OpenBao ACL Проверки AppRole API/Worker/Outbox: свой path, чужой path, запись Свой path HTTP 200; чужой path и запись HTTP 403 PASS
Persistence python .\tests\resilience_windows.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt --mode persistence --action-script .\scripts\restart.sh Подтверждённые данные и существующая сессия сохранены после перезапуска; тест сообщил, что scope hook требует операторского подтверждения PASS
API failover python .\tests\resilience_windows.py --base-url https://localhost:8443 --ca-file .\secrets\tls\ca.crt --mode failover --action-script .\scripts\stop-one.sh 2 наблюдаемые реплики; 5 успешных записей; 1 переходная ошибка; восстановление за 6.297 s; подтверждённые данные и сессия сохранены PASS
Docker hardening docker inspect контейнеров и поиск по compose/Dockerfile API/Worker/Outbox non-root, read-only, CapDrop ALL, CPU/RAM limits; privileged=false; host network и Docker socket не обнаружены PASS
Отсутствие прямого обхода ingress docker compose ps / docker inspect port bindings API не опубликован на host; Nginx слушает 127.0.0.1:8443 PASS

Ограничения доказательств

  • Для persistence/failover проверены результаты сценариев, но тестовая утилита отдельно предупреждает, что реальный scope инфраструктурного hook требует операторского подтверждения. Поэтому не утверждается, что каждый backend-компонент был перезапущен тестом.
  • Временный mTLS probe выполнялся в контейнере API и не изменял исходный тестовый файл проекта. Исходный scripts/test-mtls.ps1 не считается полностью пройденным; в частности, проверка запрещённой identity выполнялась отдельным корректно направленным запросом непосредственно к API.
  • Отдельный отрицательный runtime-тест на upload больше 10 MiB в зафиксированных результатах отсутствует; подтверждены реализация и точка вызова ограничения.
  • Успешные проверки локального учебного стенда не являются аудитом production-безопасности.

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

Воздействие Ожидаемое поведение Наблюдение Восстановление / потеря данных
HTTPS без доверенного CA TLS handshake должен завершиться ошибкой верификации Соединение с правильным CA прошло; пустой trust store отклонён ошибкой сертификата Отказ корректный
mTLS без клиентского сертификата API не должен принимать соединение TLS handshake отклонён Отказ корректный
mTLS с сертификатом чужого CA API не должен принимать соединение TLS handshake отклонён Отказ корректный
mTLS с доверенным, но запрещённым URI SAN spiffe://lab7/worker API должен отклонить identity API отклонил запрос Отказ корректный
mTLS с разрешённой ingress identity API должен принять запрос Запрос принят Успех
Превышение login rate limit HTTP 429 + Retry-After Отдельный тест завершился PASS Доступ ограничивается на время окна
Остановка одной API-реплики Вторая реплика продолжает обслуживать запросы 5 успешных записей, 1 переходная ошибка, восстановление за 6.297 s Подтверждённые данные и сессия сохранены
Перезапуск по persistence hook Сохранение подтверждённых данных и сессии Данные и сессия сохранены Потери подтверждённых данных не обнаружено; scope hook требует операторского подтверждения

Нагрузочные RPS и p50/p95/p99 в рамках приведённых доказательств не измерялись; численные показатели производительности не заявляются.

Ограничения и следующие шаги

  1. Зафиксировать операторские команды и состояние каждого контейнера/хранилища до и после persistence hook.
  2. Сохранить обезличенные логи/выводы проверок в evidence/, не включая токены, пароли, SecretID, приватные ключи и unseal shares.
  3. При необходимости расширить проверку TLS/ACL для каждого внутреннего backend и документировать точные server SAN, service identity, ACL и сроки credentials по фактической конфигурации.
  4. Провести отдельный нагрузочный эксперимент с описанием профиля, concurrency, длительности и ограничений генератора.

Для заявленной целевой оценки 3 приведены подтверждённые проверки HTTPS, mTLS, OpenBao scoped policies, Argon2id, rate limit, негативного доступа, контейнерного hardening и отказоустойчивости API. Непроверенные расширения не заявляются как выполненные.