docs: describe lab 7 threat model and trust boundaries

This commit is contained in:
Dmitrii Grishko
2026-11-14 19:37:49 +03:00
parent 48e6a6ac0d
commit 8986ba6bef
6 changed files with 125 additions and 183 deletions
+1
View File
@@ -1,4 +1,5 @@
# Local/private state
/.memory/
.env
.env.*
!.env.example
+84
View File
@@ -4,10 +4,25 @@ CA_FILE ?=
ACTION_SCRIPT ?=
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)
CLEANUP_ARGS ?= --dry-run
SERVICES ?=
JOB_ID ?=
ATTACHMENT_ID ?=
REASON ?=
export JOB_ID ATTACHMENT_ID REASON
COMPOSE = docker compose --project-name highload-lab7 --env-file .env -f compose.yml
.PHONY: app-init app-build app-up app-start app-stop app-down app-restart app-logs app-status
.PHONY: app-migrate app-s3-bootstrap worker-start worker-stop queue-status attachments-cleanup
.PHONY: jobs-failed jobs-replay jobs-upgrade jobs-cleanup-staging
.PHONY: test-backend test-pipeline
.PHONY: help check validate test load test-persistence test-failover test-security
help:
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
@echo "app-up: build and start the stand; app-status: inspect it; app-down: stop it"
check:
$(PYTHON) scripts/check_contract.py
@@ -31,3 +46,72 @@ test-failover:
test-security:
$(PYTHON) tests/security.py --base-url "$(BASE_URL)" $(TLS_ARGS)
app-init:
$(PYTHON) scripts/init_env.py
./scripts/bootstrap_tls.sh
app-build: app-init
$(COMPOSE) build
app-up: app-init
$(COMPOSE) up -d --build --wait
./scripts/wait_ingress.sh
app-start: app-init
$(COMPOSE) up -d --no-build --wait
./scripts/wait_ingress.sh
app-stop:
$(COMPOSE) stop
app-down:
$(COMPOSE) down
app-restart: app-init
./scripts/restart.sh
app-logs:
$(COMPOSE) logs -f --tail=100 $(SERVICES)
app-status:
$(COMPOSE) ps --all
app-migrate: app-init
$(COMPOSE) run --rm migrate
app-s3-bootstrap: app-init
$(COMPOSE) run --rm s3-bootstrap
worker-start:
$(COMPOSE) start worker
worker-stop:
$(COMPOSE) stop worker
queue-status:
$(COMPOSE) exec -T broker rabbitmqctl -q list_queues name messages_ready messages_unacknowledged --formatter json
attachments-cleanup:
$(COMPOSE) run --rm --no-deps upload-cleanup ./messenger attachments-cleanup $(CLEANUP_ARGS)
jobs-failed:
$(COMPOSE) exec -T dispatcher ./messenger jobs list-failed
jobs-replay:
@test -n "$$JOB_ID" && test -n "$$REASON" || { echo "Set JOB_ID=... REASON='...'"; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs replay "$$JOB_ID" "$$REASON"
jobs-upgrade:
@test -n "$$ATTACHMENT_ID" && test -n "$$REASON" || { echo "Set ATTACHMENT_ID=... REASON='...'"; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs upgrade "$$ATTACHMENT_ID" 2 "$$REASON"
jobs-cleanup-staging:
@test -n "$$JOB_ID" || { echo "Set JOB_ID=..."; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs cleanup-staging "$$JOB_ID"
test-backend: app-init
$(COMPOSE) --profile test run --rm --build backend-tests
test-pipeline: app-init
$(COMPOSE) --profile test run --rm --build backend-tests go test -race -count=1 -v ./backend/tests ./backend/workers -run 'TestPipeline|TestVersionedRendering|TestThumbnail|TestOptimized'
-85
View File
@@ -1,85 +0,0 @@
include Makefile
CLEANUP_ARGS ?= --dry-run
SERVICES ?=
JOB_ID ?=
ATTACHMENT_ID ?=
REASON ?=
export JOB_ID ATTACHMENT_ID REASON
COMPOSE = docker compose --project-name highload-lab7 --env-file .env -f compose.yml
.PHONY: app-init app-build app-up app-start app-stop app-down app-restart app-logs app-status
.PHONY: app-migrate app-s3-bootstrap worker-start worker-stop queue-status attachments-cleanup
.PHONY: jobs-failed jobs-replay jobs-upgrade jobs-cleanup-staging
.PHONY: test-backend test-pipeline
app-init:
$(PYTHON) scripts/init_env.py
./scripts/bootstrap_tls.sh
app-build: app-init
$(COMPOSE) build
app-up: app-init
$(COMPOSE) up -d --build --wait
./scripts/wait_ingress.sh
app-start: app-init
$(COMPOSE) up -d --no-build --wait
./scripts/wait_ingress.sh
app-stop:
$(COMPOSE) stop
app-down:
$(COMPOSE) down
app-restart: app-init
./scripts/restart.sh
app-logs:
$(COMPOSE) logs -f --tail=100 $(SERVICES)
app-status:
$(COMPOSE) ps --all
app-migrate: app-init
$(COMPOSE) run --rm migrate
app-s3-bootstrap: app-init
$(COMPOSE) run --rm s3-bootstrap
worker-start:
$(COMPOSE) start worker
worker-stop:
$(COMPOSE) stop worker
queue-status:
$(COMPOSE) exec -T broker rabbitmqctl -q list_queues name messages_ready messages_unacknowledged --formatter json
attachments-cleanup:
$(COMPOSE) run --rm --no-deps upload-cleanup ./messenger attachments-cleanup $(CLEANUP_ARGS)
jobs-failed:
$(COMPOSE) exec -T dispatcher ./messenger jobs list-failed
jobs-replay:
@test -n "$$JOB_ID" && test -n "$$REASON" || { echo "Set JOB_ID=... REASON='...'"; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs replay "$$JOB_ID" "$$REASON"
jobs-upgrade:
@test -n "$$ATTACHMENT_ID" && test -n "$$REASON" || { echo "Set ATTACHMENT_ID=... REASON='...'"; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs upgrade "$$ATTACHMENT_ID" 2 "$$REASON"
jobs-cleanup-staging:
@test -n "$$JOB_ID" || { echo "Set JOB_ID=..."; exit 2; }
$(COMPOSE) exec -T dispatcher ./messenger jobs cleanup-staging "$$JOB_ID"
test-backend: app-init
$(COMPOSE) --profile test run --rm --build backend-tests
test-pipeline: app-init
$(COMPOSE) --profile test run --rm --build backend-tests go test -race -count=1 -v ./backend/tests ./backend/workers -run 'TestPipeline|TestVersionedRendering|TestThumbnail|TestOptimized'
+19 -32
View File
@@ -1,37 +1,24 @@
# Матрица доверия — заполнить в решении lab7
# Матрица доверия
Это обязательная матрица покрытия. Для каждой строки укажите реальный порт, endpoint, CA, service identity, проверку SAN/ACL, срок жизни credentials и команду положительного/отрицательного теста. TLS шифрует и подтверждает сервер; mTLS также проверяет клиента. При доверенном CA всё равно нужно ограничивать разрешённую identity. Plaintext hop допустим только внутри закрытого локального transport/proxy boundary, без опубликованного обхода; границу и rationale нужно доказать.
Адреса и порты приведены для текущего `compose.yml` с настройками по умолчанию. Столбец «Цель» описывает конфигурацию, которую предстоит реализовать. Для новых серверных сертификатов планируется локальный CA и DNS SAN имени сервиса. Сроки и механизмы выдачи зависимых credentials уточняются при реализации. Текущие пароли зависимостей статические и создаются локально.
| Связь | Минимум на 3 | Дополнительно на 4 | Доказательство / конфиг |
| --- | --- | --- | --- |
| Клиент → ingress/LB | TLS, CA + hostname, Bearer | Проверка expiry/revocation сессии и общего login rate limit | TODO |
| LB → API (все реплики) | mTLS + allowlist LB identity | Ротация leaf без обхода проверки | TODO |
| API/worker → PostgreSQL | TLS verify-full + раздельные ограниченные DB roles | Ротация credentials; mTLS — допустимое усиление | TODO |
| API/worker → S3 | TLS + разные scoped credentials/prefix rights | Проверка denied prefix и ротация | TODO |
| API/worker → broker | TLS + разные producer/consumer identities и ACL | mTLS + ограничение допустимых SAN/ролей | TODO |
| API/worker → Collector | TLS; сеть/аутентификация запрещает произвольный ingest | mTLS с раздельными identities | TODO |
| Collector → telemetry backends | TLS + scoped backend credentials или mTLS | Ротация и проверка least privilege | TODO |
| Grafana → data sources | TLS с проверкой сервера, ограниченная identity | Отрицательные проверки доступа | TODO |
| API/worker/agent → OpenBao | TLS + сервисный auth + scoped policy | Renewal/expiry/revocation | TODO |
| Оператор → OpenBao/Grafana/S3 admin | TLS + authentication, доступ локальный/через защищённый канал | Разделение operator/application roles | TODO |
| API → Redis/Valkey, если используется | TLS + ACL/пароль с минимальными правами | Ротация; mTLS по возможности | TODO |
| Replication/кластерные каналы, если добавлены | TLS/mTLS либо подтверждённый шифрованный transport | Проверка заявленной модели отказа | TODO |
| Связь | Текущее состояние | Цель и способ проверки |
| --- | --- | --- |
| Клиент → HAProxy | HTTPS `localhost:8443`, локальный `lab7-ca`, SAN `localhost` и `127.0.0.1`, leaf 30 дней. Bearer-сессия по умолчанию 3600 с. | Выполнены `make test test-security CA_FILE=secrets/tls/lab7-ca.crt` и `python3 scripts/check_login_rate.py`. Дополнить отказом при неверном имени и запросом после истечения сессии. |
| HAProxy → API | mTLS `api:8080` на обеих репликах. HAProxy проверяет CA и имя `api`, API — цепочку клиента и URI SAN `urn:lab7:load-balancer`. Leaf 30 дней. Прямой порт API не опубликован. | Выполнен `python3 scripts/check_ingress_mtls.py`: верный LB принят, отсутствие cert, чужой CA и чужой SAN отклонены. На «4» проверить замену leaf и отказ для отозванной identity на новых соединениях. |
| API, worker, dispatcher, cleanup и migrate → PostgreSQL | `db:5432`, plaintext, общая роль. | `sslmode=verify-full`, отдельный владелец схемы для миграций и роли по фактическим операциям. Проверить вход с правильным CA, отказ с чужим CA и запрет DDL от runtime-роли. |
| API, worker и служебные задачи → S3 | HTTP `s3:9000`. У bootstrap есть root, приложения делят одну ограниченную identity. | HTTPS и отдельные политики для staging, originals и variants по операциям каждой роли. Проверить штатную загрузку, чтение нужного объекта и `AccessDenied` на чужой префикс. |
| Dispatcher и worker → RabbitMQ | AMQP `broker:5672` с общей учётной записью. | AMQPS с проверкой `broker`, разрешения producer и consumer раздельны, настройка topology вынесена в bootstrap. Проверить доставку и запрет публикации от consumer. На «4» добавить проверку клиентского SAN. |
| API, worker и dispatcher → OTel Collector | HTTP OTLP `otel-collector:4318` в сети `telemetry`. | HTTPS с проверкой имени и авторизация ingest. Проверить поступление сигналов и отказ при запросе без разрешённой identity. На «4» — mTLS с разными identities. |
| Collector → Loki/Tempo и Prometheus → Collector | HTTP `loki:3100/otlp`, `tempo:4318`; Prometheus забирает метрики с `otel-collector:8889`. | TLS и разрешения на ingest и scrape по роли. Проверить поступление логов, трейсов и метрик, отказ с чужим CA или credentials и запрет запросов на чтение от ingest-роли. |
| Grafana → источники | HTTP `prometheus:9090`, `loki:3100`, `tempo:3200`, в сети `telemetry`. | HTTPS и identities только для чтения. Проверить запросы из Grafana и отказ при попытке записи. |
| API/worker и фоновые роли → OpenBao | Сервис отсутствует. | `https://openbao:8200`, cert auth, persistent storage, отдельные KV-пути и токены с плановым TTL 15 минут. Проверить чтение своего пути и запрет чужого, записи и изменения политик. Проверить новый вход при sealed OpenBao. |
| Оператор → OpenBao, Grafana, S3 | OpenBao отсутствует. Grafana опубликована на `127.0.0.1:3000` по HTTP с anonymous viewer. S3 API опубликован на `127.0.0.1:9000` по HTTP. | Локальный административный доступ по HTTPS с отдельными credentials. Убрать анонимный доступ. Проверить отказ без административной роли и ограничения опубликованных портов. |
| API → Redis | `redis:6379` без TLS и пароля, хранение сессий и счётчиков входа. | TLS и ACL для ключей сессий и ограничения входа. Проверить вход и logout, отказ с чужим CA и запрет административных команд от прикладной роли. |
| Replication/кластерные каналы | Не применимо. API-реплики не обмениваются данными напрямую, экземпляры хранилищ одиночные. | Проверять восстановление при остановке каждой API-реплики по HTTPS. |
Нет выбранного компонента — отметьте N/A с причиной, а не оставляйте пустую строку. Внутренний публичный health listener, если нужен, минимален и изолирован; через него нельзя обращаться к бизнес-API без mTLS. Отдельно задокументируйте scrape/health/bootstrap каналы: они тоже не должны создавать обход.
## Health, scrape и bootstrap
## Обязательные отрицательные проверки
HAProxy проверяет `GET /health/ready` каждой реплики через её mTLS listener. Скрипт `scripts/wait_ingress.sh` проверяет готовность через HTTPS с доверенным CA. Служебные проверки Postgres и RabbitMQ запускаются внутри контейнеров, Redis проверяется локальным CLI, MinIO — локальным HTTP-запросом. При переводе зависимостей на TLS проверки должны сохранять те же границы. Связь Prometheus с Collector учитывается отдельно в строке про scrape.
1. HTTPS с правильным CA/hostname проходит; с пустым/чужим CA и неправильным hostname — ошибка верификации, не «сервер недоступен».
2. LB→API: без client cert, с cert чужого CA, с запрещённой identity от доверенного CA — отказ; с разрешённой LB identity — успех.
3. На 4 повторите набор для broker и Collector; ограничение на network policy не заменяет проверку identity.
4. Пользователь вне чата не читает metadata/content и не прикрепляет чужой файл; поддельный X-User-Id не меняет Bearer identity.
5. OpenBao app policy читает только свой secret/path; запись policy и чтение чужого path запрещены. Worker не получает admin credentials API/БД/S3.
6. На 4 отзовите secret/cert и дождитесь контролируемого эффекта с учётом действующих соединений, TLS resumption и cache/TTL. Покажите новое подключение, иначе тест отзыва может ничего не проверить.
## Bootstrap и эксплуатация
В репозитории только открытые конфиги, policy templates и scripts. CA private key, leaf keys, root token, unseal shares и SecretID не коммитятся, не запекаются в образ и не печатаются в отчёте. Для локального стенда оператор создаёт их вне Git и передаёт через files/secrets с ограниченными правами. Опишите, кто имеет доступ к CA/unseal, что нужно после рестарта OpenBao и как восстановить работу.
OpenBao не использует dev-mode. Выберите persistent storage и auth метод (например AppRole с короткоживущим SecretID/response wrapping, cert auth или иная обоснованная identity). Не подменяйте root token постоянной переменной BAO_TOKEN в приложении. Рабочие tokens имеют policy, TTL и renewal/re-auth сценарий. Статические KV secrets на 3 допустимы при реальном чтении через сервисную identity; динамические DB credentials — хорошее расширение, но не обязательное название технологии.
Разрешённый компромисс учебного стенда: ручной operator init/unseal, если он безопасно документирован и не нужен при каждом обычном рестарте API. Автоматическое хранение всех unseal shares рядом с OpenBao без защиты не считается решённым bootstrap.
Bootstrap миграций и S3 выполняется одноразовыми контейнерами. Запланировано использовать для них отдельные учётные данные и TLS с проверкой сервера. Прикладные контейнеры должны получать только свои scoped credentials. Закрытые ключи, unseal shares и административные токены остаются у оператора вне Git и образов. Для отзыва и ротации на «4» проверяются новые соединения после смены credentials, включая отказ отозванной identity.
+21 -9
View File
@@ -1,19 +1,31 @@
# Модель угроз — заполнить
# Модель угроз мессенджера
## Активы и акторы
TODO: пользовательские credentials/сессии, сообщения/вложения, service identities, CA/secrets, telemetry. Акторы: участник чата, посторонний пользователь, внешний клиент, скомпрометированный сервис, оператор. Опишите доступ атакующего и границы учебного стенда.
- Пароли и их Argon2id-хеши, Bearer-токены и записи сессий. Владение действующим токеном даёт права соответствующего пользователя.
- Сообщения, состав чатов, метаданные и байты вложений, включая staging и производные изображения. PostgreSQL хранит бизнес-состояние, S3 — файлы, RabbitMQ — доставку фоновых заданий, Redis — сессии и счётчики входа.
- Ключи CA и сервисов, учётные данные хранилищ и будущие токены OpenBao. Отдельно защищаются телеметрия и её доступность, поскольку поддельные сигналы могут скрыть отказ, а утечка логов — раскрыть секреты.
Внешний клиент может формировать произвольные HTTP-запросы к ingress. Аутентифицированный посторонний знает или угадывает идентификаторы ресурсов в чужом чате. Участник чата может загружать специально подготовленные файлы. При компрометации контейнера атакующий получает доступ к его файлам, учетным данным и доступным ему сетям. Оператор управляет хостом, Docker, сертификатами и хранилищами. Компрометация хоста, Docker daemon или ключа CA выходит за границы защиты приложения. Стенд развёрнут на одном хосте и проверяет отказ отдельной API-реплики.
## Границы доверия
TODO: схема и ссылка на заполненную contracts/trust-matrix.md; публичные/внутренние интерфейсы, процессы, секреты и их выдача.
Клиент обращается к HAProxy по HTTPS. HAProxy подключается к API по mTLS, после чего приложение независимо проверяет пользовательскую сессию и членство в чате. API, worker, dispatcher и служебные задачи пересекают отдельную границу при доступе к данным. Collector принимает сигналы от приложений, а Grafana читает их из хранилищ. Административный доступ и выдача credentials образуют отдельную границу. Текущие и целевые настройки каждой связи перечислены в [матрице доверия](../contracts/trust-matrix.md).
| Угроза и конкретный путь | Нарушаемый инвариант | Контроль | Отрицательный тест | Остаточное ограничение |
| --- | --- | --- | --- | --- |
| TODO | TODO | TODO | TODO | TODO |
На 4 минимум 6 конкретных угроз. Не заменяйте сценарии словами «SQL injection», «безопасный Docker», «mTLS включён» без пути и проверки.
| Угроза и путь | Защищаемое свойство | Контроль и проверка | Остаточное ограничение |
| --- | --- | --- | --- |
| Подмена HTTPS-узла и перехват Basic или Bearer | Клиент передаёт credentials нужному серверу | HTTPS с проверкой CA и SAN. `make test-security CA_FILE=secrets/tls/lab7-ca.crt` подтвердил отказ без доверия к CA. Проверка с доверенным CA и ошибочным именем запланирована. | Токен, украденный на клиенте, пригоден до logout или expiry. |
| Прямой запрос к API из соседнего контейнера или предъявление сертификата другого сервиса | API принимает только HAProxy | API не публикует порт. `python3 scripts/check_ingress_mtls.py` проверил обе реплики с сертификатом LB, без сертификата, с чужим CA и с чужим URI SAN от своего CA. | Кража ключа LB позволяет имитировать его до смены доверия. Пользовательские ACL продолжают действовать. |
| Чтение чужих сообщений или файлов, подмена `X-User-Id`, добавление чужого attachment ID | Ресурсы доступны участникам соответствующего чата | Bearer определяет пользователя, членство проверяется API. Публичный smoke прошёл по HTTPS. Дополнить явными запросами к metadata/content и отправкой сообщения с чужим вложением и поддельным заголовком. | Участник может скопировать легально полученные данные. |
| Повтор использования токена после logout или истечения срока | Отозванная сессия отклоняется всеми API | В Redis хранится ключ на основе SHA-256 токена с TTL, logout удаляет запись. Smoke проверил logout. Для expiry создать сессию на отдельном стенде с коротким TTL и ожидать 401 с тем же токеном после истечения. | Захваченная активная сессия имеет права пользователя. |
| Перебор пароля и нагрузка на Argon2id через чередование реплик и поддельный `X-Forwarded-For` | Ограничение входа действует независимо от реплики | HAProxy заменяет заголовок фактическим адресом, Redis атомарно ведёт общий счётчик. `python3 scripts/check_login_rate.py` подтвердил 429 и `Retry-After` на 13-й попытке. Пароли хешируются Argon2id с индивидуальной солью. | Распределённые источники имеют отдельные окна, пользователи за одним NAT делят лимит. |
| Загрузка слишком большого файла, изображения с чрезмерным числом пикселей или подменённым MIME | Ограничены память, CPU и объём входных данных | API ограничивает upload 10 МиБ и проверяет формат и размеры, обработка выполняется отдельно в worker. Проверить 413 для превышения размера/пикселей и 415 для ложного MIME, затем загрузить штатный файл и дождаться ready. | Параллельные загрузки конкурируют за общие ресурсы. |
| Компрометация worker и выход за пределы его роли | Worker имеет доступ только к ресурсам обработки | Запланированы TLS, отдельные DB/S3/AMQP identities и scoped policy OpenBao. Негативные пробы: чужая таблица или схема, запрещённый prefix, публикация от consumer, чтение чужого пути OpenBao. | Сейчас роли используют общие credentials. После разделения компрометация всё равно затронет разрешённую область worker. |
| Поддельный OTLP ingest или чтение телеметрии соседом | Источник сигналов авторизован, хранилища доступны по ролям | Сейчас действует сетевая сегментация Docker. Запланировать TLS и ACL на ingest/read, проверку отказа для недоверенной identity и поиск синтетического секрета в логах, трейcах и метриках. | Скомпрометированное приложение может посылать ложные сигналы в пределах своей роли. |
| Утечка bootstrap credentials или остановка OpenBao | Сервис получает только свои секреты, отказ закрывает новый доступ | Запланировать cert auth, короткие токены и раздельные KV-пути. Проверить отказ чужого чтения и записи, отсутствие административных секретов в контейнерах и отказ нового запуска при sealed OpenBao. | Действующие подключения и уже загруженные credentials могут жить до закрытия соединения или отзыва в целевой системе. |
## Lifecycle и инциденты
TODO: bootstrap, expiry/renewal, revoke/rotation, компрометация identity, sealed OpenBao и восстановление. Указать владельца CA/unseal и способ защиты bootstrap credentials. Сопоставить scan findings с реальной применимостью и исправлением/остаточным риском.
Сейчас оператор выпускает локальный CA и leaf-сертификаты через `scripts/bootstrap_tls.sh`. CA действует 365 дней, leaf — 30 дней. Закрытый ключ CA остаётся у оператора, контейнеры получают отдельные файлы. Повторный запуск bootstrap сохраняет имеющиеся сертификаты.
Для OpenBao планируется persistent storage и ручное раздельное хранение unseal shares и административных credentials у оператора. После рестарта оператор выполняет unseal. API и worker будут заново получать scoped токены по своим клиентским сертификатам. При компрометации отзыв identity блокирует новую аутентификацию, отзыв токенов закрывает доступ к OpenBao, а смена выданных паролей и закрытие активных подключений ограничивают доступ к зависимостям. Проверки expiry, renewal и ротации выполняются на новых соединениях. Сканирование зависимостей и разбор применимости уязвимостей относятся к следующему уровню.
-57
View File
@@ -1,57 +0,0 @@
# HTTPS и mTLS на входе
Для локального стенда нужны Docker Compose, OpenSSL, curl и Python 3.
`make -f app.mk app-up` создаёт сертификаты в `secrets/tls/`,
запускает два API и ждёт ответа `/health/ready` по HTTPS.
| Связь | Доверие и идентичность |
| --- | --- |
| Клиент → HAProxy, localhost:8443 | TLS 1.2+, локальный CA, SAN localhost и 127.0.0.1. Для бизнес-операций действует Bearer-сессия. |
| HAProxy → API, api:8080 | TLS 1.2+, тот же CA. HAProxy проверяет имя api. API проверяет цепочку, назначение clientAuth и URI SAN urn:lab7:load-balancer. |
| Readiness | HAProxy проверяет обе реплики через тот же mTLS listener. На хосте опубликован только порт балансировщика для API. |
Локальный CA действует 365 дней, сертификаты стенда — 30 дней.
Bootstrap сохраняет уже выпущенные ключи и сертификаты. CA key доступен
оператору в закрытом каталоге. В контейнеры монтируются отдельные нужные
файлы. Тестовый чужой CA и клиентские ключи остаются на хосте.
```sh
make test test-security CA_FILE=secrets/tls/lab7-ca.crt
python3 scripts/check_ingress_mtls.py
make test-persistence CA_FILE=secrets/tls/lab7-ca.crt ACTION_SCRIPT=scripts/restart.sh
make test-failover CA_FILE=secrets/tls/lab7-ca.crt ACTION_SCRIPT=scripts/stop-one.sh
docker compose start api
```
Проверка mTLS запускается на Linux-хосте с доступом к Docker bridge и
проверяет отдельно каждую реплику. Сертификат с правильной ролью и чужим CA,
сертификат со своим CA и чужой ролью и отсутствие сертификата приводят
к ошибкам TLS.
HAProxy перезаписывает `X-Forwarded-For` фактическим адресом соединения.
Redis атомарно считает попытки входа по этому адресу для обеих реплик.
После 12 запросов за окно в 60 секунд API возвращает 429 с `Retry-After`.
На тихом стенде после 60 секунд без входов выполните
`python3 scripts/check_login_rate.py`. Проверка исчерпывает лимит адреса
до конца текущего окна. Пользователи за одним NAT делят лимит.
Использованные настройки TLS описаны в руководстве
[HAProxy 3.2](https://docs.haproxy.org/3.2/configuration.html).
## Стоимость проверки пароля
Перенесённый Argon2id сохраняет параметры в PHC-строке вместе с солью.
Параметры текущей реализации: 64 МиБ, 3 прохода, параллелизм 2.
Среднее время в каждом из трёх прогонов по три операции составило
205, 223 и 290 мс. Go выделял около 64 МиБ на операцию. Замер выполнен
на AMD Ryzen 9 PRO 7940HS с ограничением контейнера 0,5 CPU и 512 МиБ,
`GOMAXPROCS=1`, на одном синтетическом пароле без HTTP и обращения к БД.
Это исходный замер для выбора параметров. Он не измеряет пропускную
способность при конкурентных входах.
```sh
docker compose --profile test build backend-tests
docker run --rm --network none --cpus 0.5 --memory 512m -e GOMAXPROCS=1 \
highload-lab7-backend-tests go test ./backend/services -run '^$' \
-bench '^BenchmarkPasswordVerification$' -benchtime=3x -count=3
```