17 KiB
Отчёт — лабораторная 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 в рамках приведённых доказательств не измерялись; численные показатели производительности не заявляются.
Ограничения и следующие шаги
- Зафиксировать операторские команды и состояние каждого контейнера/хранилища до и после persistence hook.
- Сохранить обезличенные логи/выводы проверок в
evidence/, не включая токены, пароли, SecretID, приватные ключи и unseal shares. - При необходимости расширить проверку TLS/ACL для каждого внутреннего backend и документировать точные server SAN, service identity, ACL и сроки credentials по фактической конфигурации.
- Провести отдельный нагрузочный эксперимент с описанием профиля, concurrency, длительности и ограничений генератора.
Для заявленной целевой оценки 3 приведены подтверждённые проверки HTTPS, mTLS, OpenBao scoped policies, Argon2id, rate limit, негативного доступа, контейнерного hardening и отказоустойчивости API. Непроверенные расширения не заявляются как выполненные.