Files
mtusi2026lab7/REPORT.md
T
celis f028a76d05
Skeleton contracts / contracts (pull_request) Canceled after 0s
Skeleton contracts / https-smoke (pull_request) Canceled after 0s
Использовать обычный дефис в отчёте ЛР 7
2026-11-13 08:33:33 +03:00

76 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Отчёт - лабораторная 7
- Автор - Морару Сергей Сергеевич, БПИ2303.
- Целевая оценка - 5. Трек 1 «Компрометация worker».
- Ветка - `solution/bpi2303-moraru` от `mtusi2026/mtusi2026lab7:main`.
- База реализации - [ЛР № 6, PR № 6](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab6/pulls/6), ветка студента на коммите `66367ca`.
- Источники - [OpenBao cert auth](https://openbao.org/docs/auth/cert/), [RabbitMQ TLS](https://www.rabbitmq.com/docs/ssl), [SeaweedFS S3 credentials](https://github.com/seaweedfs/seaweedfs/wiki/S3-Credentials), [Prometheus exporter toolkit](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md), [Tempo TLS](https://grafana.com/docs/tempo/latest/configuration/network/tls/), [OWASP Password Storage](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html). Codex использовался для переноса, реализации защиты и тестов, диагностики Compose и подготовки отчёта.
## Запуск из чистого clone
Нужны Docker Engine с Compose v2+, Python 3.9+, OpenSSL 3+ и свободное место под контейнеры, образы и volumes. Для полного стенда выделите Docker около 8 ГиБ RAM. Node 24 и версии сервисов закреплены в Dockerfile и Compose. Порты 8443, 8200 и 3000 должны быть свободны на loopback.
```sh
scripts/up.sh
curl --fail --cacert secrets/tls/service-ca/ca.crt https://localhost:8443/health/ready
make check
make test test-security CA_FILE=secrets/tls/service-ca/ca.crt
```
`scripts/up.sh` создаёт локальную конфигурацию, запускает зависимости, применяет миграции, настраивает SCRAM, инициализирует и распечатывает OpenBao, записывает scoped policies и запускает приложение. Файл `.env` управляет портами, числом реплик, TTL сессий и лимитами. Сертификаты и материалы оператора находятся в `secrets/` с закрытым родительским каталогом. Они исключены из Git и Docker build context. После отдельного перезапуска OpenBao выполните `python3 scripts/bao.py unseal`. При исчерпанном пуле адресов Docker можно задать свободные непересекающиеся подсети для `frontend`, `backend` и `telemetry` в локальном `compose.local.yaml`, подключив его через `COMPOSE_FILE=compose.yaml:compose.local.yaml` в `.env`.
`docker compose down` останавливает стенд с сохранением volumes. `docker compose down -v` намеренно удаляет данные стенда, включая OpenBao. Для нового учебного bootstrap после удаления volumes уберите старый локальный каталог `secrets/` с учётом правил хранения ключей.
## Архитектура
Две stateless API-реплики обслуживают контракт ЛР № 6. HAProxy проверяет readiness через mTLS. PostgreSQL хранит пользователей, сессии, чаты, сообщения, метаданные, задания и outbox. Вложения попадают в устойчивый staging. После завершения upload одна транзакция обновляет статус и создаёт job и outbox. Relay отмечает публикацию после подтверждения quorum-очереди. Worker использует ручной ack и fencing в PostgreSQL. SeaweedFS хранит оригиналы и варианты. Reconciler сверяет PostgreSQL и S3. Collector принимает трассы, метрики и логи. Grafana загружает dashboard, источники, SLO и алерты из конфигурации. Схемы бизнес-API и публичные тесты сохранены. Основной эксперимент выполнен на Mac15,6, macOS 14.8.4, Docker Engine 29.8.2 в OrbStack arm64 (11 vCPU, 9 ГБ RAM для VM). Из-за заполнения VM на этом хосте локальный override также поднял порог записи Loki до 99,9%; в Compose из Git действует штатный порог Loki.
Пути доверия описаны в [матрице](contracts/trust-matrix.md), атаки и отрицательные проверки - в [модели угроз](security/THREAT_MODEL.md). API, worker и reconciler получают credentials только после cert auth. Операторские bootstrap и replay используют отдельные credentials. API и worker выполняются с UID 1000, read-only rootfs, tmpfs, dropped capabilities и запретом эскалации. У worker 1 CPU, 768 МиБ и таймаут попытки 60 с. Stateful-сервисы пишут в volumes. PostgreSQL, RabbitMQ и SeaweedFS оставляют штатную инициализацию прав на data directory.
## Проверки
| Критерий | Команда | Доказательство |
| --- | --- | --- |
| Контракт | `make check`, `make validate PYTHON=.venv/bin/python` | [contract.txt](evidence/checks/contract.txt) |
| HTTPS API и вложения | `make test CA_FILE=secrets/tls/service-ca/ca.crt` | [smoke.txt](evidence/checks/smoke.txt) |
| Недоверенный CA | `make test-security CA_FILE=secrets/tls/service-ca/ca.crt` | [public-tls.txt](evidence/checks/public-tls.txt) |
| ACL, logout, expiry, rehash, общий login rate limit | `python3 student-tests/auth_security.py` | [auth.txt](evidence/checks/auth.txt) |
| Внутреннее TLS/mTLS, чужая identity | `student-tests/tls-audit.sh` | [internal-mtls.txt](evidence/checks/internal-mtls.txt) |
| Сохранность и отказ реплик | `make test-persistence ACTION_SCRIPT=scripts/restart.sh CA_FILE=secrets/tls/service-ca/ca.crt`, `make test-failover ACTION_SCRIPT=scripts/stop-one.sh CA_FILE=secrets/tls/service-ca/ca.crt`, `python3 student-tests/alternate_failover.py --replica 1` | [persistence.txt](evidence/checks/persistence.txt), [failover-api-1.txt](evidence/checks/failover-api-1.txt), [failover-api-2.txt](evidence/checks/failover-api-2.txt) |
| Ограничение доступа и смена ключей | `python3 student-tests/worker_compromise.py --output evidence/checks/worker-track.json` | [worker-track.txt](evidence/checks/worker-track.txt) |
| Истечение доступа при sealed OpenBao | `python3 student-tests/bao_expiry.py` | [bao-expiry.txt](evidence/checks/bao-expiry.txt) |
| Три сигнала, отсутствие утечек | `python3 student-tests/telemetry_check.py --ca-file secrets/tls/service-ca/ca.crt` | [telemetry.txt](evidence/checks/telemetry.txt) |
| Контейнеры API/worker | `student-tests/hardening.sh` | [hardening.txt](evidence/checks/hardening.txt) |
При последовательной проверке двух реплик запись восстановилась через 3.17 с для API-1 и 3.28 с для API-2. В каждом прогоне подтверждено 122 записи без ошибок и дублей. После общего перезапуска проверены прежний токен, история и байты вложения. При seal обе реплики зафиксировали истечение credentials, через 44.7 с ingress вернул 503. После unseal обе реплики снова отвечали через 48.7 с от начала сценария.
### Бюджет Argon2id
Параметры `m=19456 КиБ, t=2, p=1`, случайная соль 16 байт. Для каждой реплики одновременно считаются до двух хешей. Общий PostgreSQL-лимит допускает до 30 запросов входа в 10-секундное окно на весь стенд. При отказе выдаётся 429 с Retry-After. Успешный вход переводит scrypt из ЛР № 6 в Argon2id условным UPDATE. Старые сессии остаются действительны до истечения TTL или logout.
`node student-tests/argon2_bench.mjs` на macOS arm64, Node 25.8.2, один прогрев, 25 операций на поток. В сохранённом прогоне при 1 потоке p50/p95/p99 составили 91/110/208 мс, CPU 1.82 с за 25 хешей. При 2 потоках p50/p95/p99 91/136/152 мс, CPU 3.54 с за 50 хешей, peak RSS процесса 111 МиБ. CPU одного хеша около 71-73 мс. [Сводка](evidence/checks/argon2.jsonl). Бюджет памяти двух параллельных Argon2id - 38 МиБ плюс память Node и зависимостей. Время ответа на этой загруженной машине включает планирование CPU; эксперимент не оценивает пропускную способность всего API.
В серии из 64 входов с неверным паролем при concurrency 4 получены 26 ответов 401 и 38 ответов 429 с Retry-After. Отказы наблюдались у обеих API-реплик. p50/p95 ответов 401 составили 101/171 мс. [Вывод](evidence/checks/auth.txt).
### Трек 1 - компрометация worker
Гипотеза. Украденные права worker позволяют читать staging, создавать варианты, потреблять очередь и менять состояние заданий. Они не дают читать пароли или сообщения, писать в произвольный prefix, публиковать задания или менять топологию. Ротация должна перекрыть старый доступ и сохранить все задания, которые API успел подтвердить.
Методика. Синтетический стенд, два worker, concurrency 2 на worker. Скрипт запускает пробу в backend с leaf и credentials worker. Проверяет операции по трём зависимостям и OpenBao. Останавливает worker, загружает 6 PNG и ждёт, пока outbox отметит публикацию. Оператор убирает прежний leaf из OpenBao, отзывает сертификат и пользователя AMQP, завершает DB connections, меняет пароль и S3 key, затем поднимает worker и открывает новые соединения со старыми материалами. Проверяются SHA-256 каждого оригинала, ровно шесть done и восемнадцать строк вариантов. Время считается от начала ротации до проверки каждого оригинала. Эксперимент покрывает очередь без активных lease на момент отключения.
Результат прогона. Старый leaf получил отказ на OpenBao, RabbitMQ и Collector. Прежние пароль БД и ключ S3 также отклонены. Все 6 заданий обработаны с первой попытки, записаны 18 вариантов, SHA-256 всех 6 оригиналов совпал. Первое подтверждение получено через 84.48 с от начала ротации, последнее через 84.74 с. [Вывод проверок](evidence/checks/worker-track.txt) · [Измерения](evidence/checks/worker-track.json).
До разграничения в ЛР № 6 worker подключался к PostgreSQL как владелец схемы, имел Read/Write на весь bucket, брокер уже разделял публикацию и потребление. Здесь даже действующий worker видит только рабочие prefix и таблицы pipeline, а его брокерный credential связан с leaf. Внутри своих разрешений worker может повредить рабочие данные или задержать обработку. Время восстановления зависит от рестартов одиночного RabbitMQ и SeaweedFS, поэтому это проверка сохранности, а не высокой доступности этих зависимостей.
### Сканирование
`npm audit --omit=dev` вернул 0 известных уязвимостей зависимостей npm. Trivy 0.76.2 в исходном однослойном образе обнаружил zlib CVE-2026-4738 и уязвимости пакетов, поставленных вместе с npm, включая brace-expansion и undici. Исходники сервиса не используют npm CLI в runtime. Финальный образ исключает глобальный npm и Yarn, сохраняя production dependencies приложения. В финальном скане Trivy оставил одну запись CVE-2026-4738 для системного zlib. Описание NVD указывает путь GDAL `frmts/zlib/contrib/infback9`. GDAL отсутствует в runtime, поэтому путь из advisory не входит в поверхность стенда. При обновлении базового образа следует повторить скан. [Вывод Trivy и npm audit](evidence/checks/scan.txt).
## Ограничения стенда
OpenBao, PostgreSQL, S3, RabbitMQ и telemetry backends работают в одном экземпляре. OpenBao требует ручного unseal после своего рестарта. Локальная ротация worker переинициализирует слушатели с новыми сертификатами и ACL, сохраняя volumes. Окно fail-closed составляет до 45 с после последнего успешного получения credentials. Это учебный стенд с локальным CA и синтетическими данными.
## Публикация
В Gitea создайте fork `mtusi2026/mtusi2026lab7` в аккаунте `s.s.moraru`. Из этой ветки выполните `git push -u fork solution/bpi2303-moraru`. В новом PR выберите base `mtusi2026/mtusi2026lab7:main` и head `s.s.moraru/mtusi2026lab7:solution/bpi2303-moraru`. Заголовок - **ЛР 7 - БПИ2303 - Морару - на 5**. Описание подготовлено в [шаблоне PR](.github/pull_request_template.md).