forked from mtusi2026/mtusi2026lab7
76 lines
15 KiB
Markdown
76 lines
15 KiB
Markdown
# Отчёт - лабораторная 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).
|