Add authentication: admin/agent bearer tokens for the API, login for the dashboard

control-api: every route now carries a mandatory access level (admin / agent /
open) in a route table. All /api/v1/admin/* require the admin token; the
write calls of validator-agent and prober (self-check, events, results,
complete) require a separate static agent token; register, heartbeat and
fetching the assignment stay open. Tokens come from env vars, are compared in
constant time and never logged. An empty token leaves that level open with a
startup warning (backward compatible).

validator-agent / prober: apiclient sends the agent token only to control-api.

admin-dashboard: login/password (from env) with a stateless HMAC session
cookie, Origin-based CSRF check, per-IP brute-force throttle, HX-Redirect for
htmx polls, logout in the sidebar; the dashboard calls control-api with the
admin token. Login page layout fixed after review.

Also: env plumbing in docker-compose/rxprod-compose/systemd/config examples,
e2e script with token assertions, tests, docs (API, SETUP, USAGE, DASHBOARD,
README), plan and review under docs/changes/, bin/ rebuilt with new
SHA256SUMS.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

rxprod-compose/docker-compose.yml

@@ -28,6 +28,10 @@ services:
       OS_USERNAME: "${OS_USERNAME:-}"
       OS_USER_DOMAIN_NAME: "${OS_USER_DOMAIN_NAME:-}"
       OS_PASSWORD: "${OS_PASSWORD:-}"
+      # Static bearer tokens (set in .env; empty = that API level is open).
+      # Generate with: openssl rand -hex 32
+      CONTROL_API_ADMIN_TOKEN: "${CONTROL_API_ADMIN_TOKEN:-}"
+      CONTROL_API_AGENT_TOKEN: "${CONTROL_API_AGENT_TOKEN:-}"
     healthcheck:
       test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://127.0.0.1:8081/healthz"]
       interval: 5s
@@ -44,6 +48,12 @@ services:
       - "8091:8090"
     environment:
       ADMIN_DASHBOARD_CONTROL_API_URL: http://control-api:8081
+      # Admin token of control-api + the dashboard login (empty username/
+      # password = login disabled).
+      ADMIN_DASHBOARD_CONTROL_API_TOKEN: "${ADMIN_DASHBOARD_CONTROL_API_TOKEN:-}"
+      ADMIN_DASHBOARD_USERNAME: "${ADMIN_DASHBOARD_USERNAME:-}"
+      ADMIN_DASHBOARD_PASSWORD: "${ADMIN_DASHBOARD_PASSWORD:-}"
+      ADMIN_DASHBOARD_SESSION_SECRET: "${ADMIN_DASHBOARD_SESSION_SECRET:-}"
     depends_on:
       control-api:
         condition: service_healthy
@@ -57,6 +67,7 @@ services:
     environment:
       PROBER_SITE_ID: "${PROBER_SITE_ID}"
       PROBER_CONTROL_API_URL: http://control-api:8081
+      CONTROL_API_AGENT_TOKEN: "${CONTROL_API_AGENT_TOKEN:-}"
     depends_on:
       control-api:
         condition: service_healthy

rxprod-compose/sources/admin-dashboard.example.yaml

@@ -4,6 +4,23 @@ server:
 control_api:
   base_url: "http://control-api.internal:8080"
   timeout_seconds: 10
+  # Имя переменной окружения с admin-токеном control-api
+  # (CONTROL_API_ADMIN_TOKEN на стороне control-api). Пусто в окружении —
+  # запросы идут без заголовка Authorization.
+  token_env: "ADMIN_DASHBOARD_CONTROL_API_TOKEN"
+
+# Вход в дашборд: один администратор, сессия в cookie. Здесь только ИМЕНА
+# переменных окружения; значения задаются окружением процесса (см.
+# deploy/systemd/admin-dashboard.service). Если логин или пароль не заданы —
+# вход не требуется (в логе предупреждение при старте).
+auth:
+  username_env: "ADMIN_DASHBOARD_USERNAME"
+  password_env: "ADMIN_DASHBOARD_PASSWORD"
+  # Ключ подписи cookie сессии (openssl rand -hex 32). Не задан — ключ
+  # случайный на каждый старт, и рестарт сбрасывает все сессии.
+  session_secret_env: "ADMIN_DASHBOARD_SESSION_SECRET"
+  # Срок жизни сессии, минут (по умолчанию 480 = 8 часов).
+  session_ttl_minutes: 480
 
 # Настройки сводки на странице "Обзор" — см. docs/DASHBOARD.md. Оба поля
 # влияют только на то, как дашборд группирует уже существующие данные

rxprod-compose/sources/control-api.example.yaml

@@ -37,6 +37,22 @@ openstack:
   user_domain_name_env: "OS_USER_DOMAIN_NAME"
   password_env: "OS_PASSWORD"
 
+# Аутентификация API: здесь только ИМЕНА переменных окружения, значения
+# (статические bearer-токены) задаются окружением процесса — см.
+# deploy/systemd/control-api.service (EnvironmentFile=). Генерация:
+#   openssl rand -hex 32
+# Пустой/незаданный токен оставляет соответствующий уровень ОТКРЫТЫМ
+# (в логе при старте предупреждение) — для обратной совместимости.
+auth:
+  # Защищает все /api/v1/admin/* (его использует дашборд и оператор: curl -H
+  # "Authorization: Bearer $TOKEN").
+  admin_token_env: "CONTROL_API_ADMIN_TOKEN"
+  # Защищает запись результатов/событий: POST /agents/{id}/self-check|events|
+  # results|complete и POST /probers/{site_id}/results. Один общий токен для
+  # validator-agent и prober. register/heartbeat/получение задания остаются
+  # открытыми.
+  agent_token_env: "CONTROL_API_AGENT_TOKEN"
+
 orchestrator:
   poll_interval_seconds: 5
   self_check_timeout_seconds: 60

rxprod-compose/sources/prober.example.yaml

@@ -3,6 +3,10 @@
 
 site_id: "site-1"
 control_api_url: "http://control-api.internal:8080"
+# Имя переменной окружения с токеном агентов control-api (тот же, что у
+# validator-agent; CONTROL_API_AGENT_TOKEN на стороне control-api). Нужен для
+# записи результатов; register/heartbeat/получение заданий работают без него.
+control_api_token_env: "CONTROL_API_AGENT_TOKEN"
 poll_interval_seconds: 5
 
 checks:

rxprod-compose/sources/validator-agent.example.yaml

@@ -3,6 +3,12 @@
 
 validator_id: "validator_01"
 control_api_url: "http://control-api.internal:8080"
+# Имя переменной окружения с токеном агентов control-api (тот же, что у
+# prober; CONTROL_API_AGENT_TOKEN на стороне control-api). Нужен для записи
+# результатов/событий; register/heartbeat/получение задания работают без него.
+# Токен отправляется только в control-api — не на ip_echo_urls и не на цели
+# проверок.
+control_api_token_env: "CONTROL_API_AGENT_TOKEN"
 poll_interval_seconds: 5
 
 self_check: