diff --git a/.gitignore b/.gitignore index b5a7189..2e37cb1 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,5 @@ # Local/private state +/.memory/ .env .env.* !.env.example diff --git a/Makefile b/Makefile index 5ad43ad..5541ad6 100644 --- a/Makefile +++ b/Makefile @@ -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' diff --git a/app.mk b/app.mk deleted file mode 100644 index 83bc09b..0000000 --- a/app.mk +++ /dev/null @@ -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' diff --git a/contracts/trust-matrix.md b/contracts/trust-matrix.md index 0c2a977..00b3b59 100644 --- a/contracts/trust-matrix.md +++ b/contracts/trust-matrix.md @@ -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. diff --git a/security/THREAT_MODEL.md b/security/THREAT_MODEL.md index 31da287..5bd9954 100644 --- a/security/THREAT_MODEL.md +++ b/security/THREAT_MODEL.md @@ -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 и ротации выполняются на новых соединениях. Сканирование зависимостей и разбор применимости уязвимостей относятся к следующему уровню. diff --git a/security/ingress.md b/security/ingress.md deleted file mode 100644 index bfda06c..0000000 --- a/security/ingress.md +++ /dev/null @@ -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 -```