forked from mtusi2026/mtusi2026lab7
Перенесена реализация lab6; бизнес-API без изменений, транспорт — HTTPS. - Внешний HTTPS (public-ca) на 127.0.0.1:8443; HSTS, TLS >= 1.2. - Обязательное mTLS LB -> каждая API-реплика: API проверяет цепочку internal-ca и SAN клиента (allowlist: lb); health только на 127.0.0.1. - TLS с проверкой сервера ко всем зависимостям: PostgreSQL verify-full (pg_hba только hostssl), HTTPS S3, AMQPS, OTLP/HTTPS с client cert, mTLS Collector -> Prometheus/Loki/Tempo, Grafana -> datasources, scrape. - OpenBao 2.7.2 не в dev-mode: Raft на volume, init/unseal оператором, auth/cert с ролью и policy на сервис, TTL 15 мин + renew/re-login. - Отдельные роли PostgreSQL с грантами по таблицам; разные ключи S3 и пользователи брокера выдаются из OpenBao. - Argon2id (m=19 MiB, t=2, p=1, замер на стенде) и rehash при входе. - Случайный X-Instance-Id; hardening контейнеров (non-root, cap_drop ALL, no-new-privileges, read-only, лимиты); TCP_NODELAY на сокете API. - Модель угроз, trust matrix, отрицательные тесты TLS/mTLS, API, OpenBao, hardening; evidence, в т.ч. прогон из чистого clone.
123 lines
9.0 KiB
INI
123 lines
9.0 KiB
INI
# Lab3/4/6/7: единая точка входа перед API-репликами.
|
||
#
|
||
# Lab7: снаружи только HTTPS :8443 (сертификат public-ca, SAN localhost/127.0.0.1). LB -> каждая
|
||
# API-реплика: mTLS — LB предъявляет identity `lb` (internal-ca), сам проверяет сертификат API
|
||
# (internal-ca + SAN api). Readiness-проверки идут тем же mTLS-каналом. Plaintext до API нет.
|
||
#
|
||
# Lab4: upload вложений — тело идёт потоком (без http-buffer-request); для upload timeout server
|
||
# увеличен до 75 с (> UPLOAD_TIMEOUT_SECONDS=60 у API + запись в S3). Content-Length
|
||
# больше лимита API отклоняет сам, не читая тело.
|
||
#
|
||
# Обнаружение реплик: DNS Docker (127.0.0.11) отдаёт по имени сервиса `api` адреса
|
||
# ВСЕХ его контейнеров; server-template создаёт до 8 слотов и заполняет их по DNS.
|
||
# Поэтому `docker compose up --scale api=N` не требует правки конфигурации.
|
||
#
|
||
# Readiness: активная проверка GET /health/ready каждую 1 с; 2 неудачи подряд -> DOWN,
|
||
# 2 успеха -> UP. Максимальное время обнаружения отказа:
|
||
# inter(1s) + timeout check(1s) + fastinter(0.5s) + timeout check(1s) ~= 3.5 с;
|
||
# ready=503 или refused без ожидания таймаута -> ~1.5 с.
|
||
# Sticky sessions НЕ используются: balance roundrobin без cookie/stick-table для backend
|
||
# (stick-table во frontend считает только частоту входов по IP, на выбор реплики не влияет).
|
||
#
|
||
# Перегрузка: maxconn 10 на реплику (= DB_POOL_SIZE) — лишние запросы ждут в очереди LB
|
||
# (timeout queue 5s), а не плодят потоки внутри Python-процесса. Переполнение -> 503 JSON.
|
||
|
||
global
|
||
log stdout format raw local0 info
|
||
maxconn 4096
|
||
ssl-default-bind-options ssl-min-ver TLSv1.2 no-tls-tickets
|
||
ssl-default-bind-ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256
|
||
ssl-default-bind-ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305
|
||
ssl-default-server-options ssl-min-ver TLSv1.2 no-tls-tickets
|
||
# Без кэша TLS-сессий к backend: каждое новое соединение с API — полный handshake с проверкой.
|
||
tune.ssl.cachesize 0
|
||
|
||
resolvers docker
|
||
nameserver dns 127.0.0.11:53
|
||
resolve_retries 3
|
||
timeout resolve 1s
|
||
timeout retry 1s
|
||
hold valid 2s
|
||
hold other 2s
|
||
hold refused 2s
|
||
hold nx 2s
|
||
hold timeout 2s
|
||
hold obsolete 2s
|
||
accepted_payload_size 8192
|
||
|
||
defaults
|
||
mode http
|
||
log global
|
||
option httplog
|
||
option dontlognull
|
||
# Внутри одного Docker-host соединение устанавливается за доли мс: 500 мс хватает с запасом,
|
||
# а при внезапно исчезнувшей реплике запрос быстро уходит в retry на другую.
|
||
timeout connect 500ms
|
||
timeout client 30s
|
||
timeout server 10s
|
||
timeout http-request 10s
|
||
timeout http-keep-alive 5s
|
||
timeout queue 5s
|
||
timeout check 1s
|
||
# Повтор только если соединение с backend НЕ установлено (запрос точно не дошёл
|
||
# до приложения) — это безопасно даже для неидемпотентных POST. Повтор уходит
|
||
# на другую реплику (redispatch). Ответы/таймауты после отправки не повторяются.
|
||
retries 2
|
||
retry-on conn-failure
|
||
option redispatch 1
|
||
|
||
# Ошибки, которые формирует сам HAProxy (нет живых реплик, обрыв backend, timeout,
|
||
# переполнение очереди), отдаются в общем JSON-формате ошибки контракта, а не HTML.
|
||
# Ответы приложения (в т.ч. его 503) эти правила не затрагивают.
|
||
unique-id-format %[uuid()]
|
||
http-error status 400 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" lf-string '{"error":{"code":"invalid_request","message":"Неверный запрос","request_id":"%ID"}}'
|
||
http-error status 408 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" lf-string '{"error":{"code":"invalid_request","message":"Запрос не получен вовремя","request_id":"%ID"}}'
|
||
http-error status 413 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" lf-string '{"error":{"code":"payload_too_large","message":"Файл больше допустимого размера","request_id":"%ID"}}'
|
||
http-error status 429 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" hdr Retry-After "10" lf-string '{"error":{"code":"rate_limited","message":"Слишком много запросов, повторите позже","request_id":"%ID"}}'
|
||
http-error status 500 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" lf-string '{"error":{"code":"internal_error","message":"Внутренняя ошибка сервера","request_id":"%ID"}}'
|
||
http-error status 502 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" hdr Retry-After "1" lf-string '{"error":{"code":"unavailable","message":"Сервис временно недоступен","request_id":"%ID"}}'
|
||
http-error status 503 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" hdr Retry-After "1" lf-string '{"error":{"code":"unavailable","message":"Сервис временно недоступен","request_id":"%ID"}}'
|
||
http-error status 504 content-type "application/json; charset=utf-8" hdr X-Request-Id "%ID" hdr Retry-After "1" lf-string '{"error":{"code":"unavailable","message":"Сервис временно недоступен","request_id":"%ID"}}'
|
||
|
||
frontend fe_api
|
||
bind :8443 ssl crt /run/secrets/lb-public.pem alpn http/1.1
|
||
http-response set-header Strict-Transport-Security "max-age=31536000"
|
||
# Ответ не раскрывает внутренние адреса/версии LB.
|
||
http-response del-header Server
|
||
# X-Request-Id формирует само приложение; LB только пробрасывает адрес клиента.
|
||
option forwardfor
|
||
# Защита входа от перебора паролей и шторма scrypt: не более LOGIN_RATE_LIMIT
|
||
# попыток POST /auth/sessions за 10 с с одного IP, сверх — 429 rate_limited.
|
||
stick-table type ip size 100k expire 60s store http_req_rate(10s)
|
||
acl is_login method POST
|
||
acl is_login_path path /api/v1/auth/sessions
|
||
# Явно вычисляем unique-id до deny: иначе в ответе 429 request_id остаётся пустым.
|
||
http-request set-var(txn.request_id) unique-id
|
||
http-request track-sc0 src if is_login is_login_path
|
||
http-request deny deny_status 429 if is_login is_login_path { sc_http_req_rate(0) gt "${LOGIN_RATE_LIMIT}" }
|
||
# Lab4: лимит размера upload проверяет API по Content-Length ДО чтения тела (ответ 413
|
||
# с X-Instance-Id по контракту). Дублирующий deny на LB убран: его ответ без X-Instance-Id.
|
||
default_backend be_api
|
||
|
||
backend be_api
|
||
balance roundrobin
|
||
http-request set-timeout server 75s if METH_POST { path_reg ^/api/v1/chats/[^/]+/attachments$ }
|
||
option httpchk
|
||
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host lb
|
||
http-check expect status 200
|
||
# on-marked-down shutdown-sessions НЕ используется: при штатной остановке реплика ещё
|
||
# дообслуживает начатые запросы (drain), и обрыв их сессий дал бы лишние 502.
|
||
default-server maxconn 10 check inter 1s fastinter 500ms downinter 1s fall 2 rise 2 resolvers docker resolve-prefer ipv4 init-addr libc,none ssl verify required ca-file /run/secrets/internal-ca.crt verifyhost api sni str(api) check-sni api crt /run/secrets/lb.pem alpn http/1.1 no-ssl-reuse
|
||
server-template api 8 api:8443
|
||
|
||
# Статистика LB и /metrics: только сеть telemetry, HTTPS с обязательным client cert internal-ca
|
||
# (Prometheus). Наружу (на хост) не публикуется.
|
||
frontend stats
|
||
bind :8404 ssl crt /run/secrets/lb.pem ca-file /run/secrets/internal-ca.crt verify required
|
||
# Lab6: встроенный Prometheus-экспортёр HAProxy (USE_PROMEX) — снимает Prometheus по сети telemetry.
|
||
http-request use-service prometheus-exporter if { path /metrics }
|
||
stats enable
|
||
stats uri /stats
|
||
stats refresh 2s
|
||
stats show-legends
|