docs: update Go code style guidelines and linting requirements

- Enhanced AGENTS.md to include post-editing commands for Go code, specifying the use of `gofmt -w`, `go vet ./...`, and `scripts/lint-go.ps1`.
- Updated engineering rules in .cursor/rules/engineering.mdc to clarify the linting process and ensure consistency in Go code formatting.
- Improved documentation for CI checks related to Go code style and linting.

.cursor/rules/engineering.mdc

@@ -57,9 +57,9 @@ alwaysApply: true
 
 ## Code Style
 
-**STYLE-01** | MUST | Go-код после `gofmt`; перед PR — `go vet ./...`.
+**STYLE-01** | MUST | Go-код после `gofmt`; перед PR — `go vet ./...`. Агент после правок Go: `gofmt -w` на изменённых файлах + `golangci-lint run` (или `scripts/lint-go.*`) до exit 0.
-*Rationale:* единый стиль.
+*Rationale:* CI job `go` включает golangci-lint (gofmt).
-*Проверка:* CI job `go`.
+*Проверка:* CI job `go`; `.cursor/rules/engineering.mdc` STYLE-01.
 
 **STYLE-02** | MUST | Экспортируемые типы/функции публичных пакетов — godoc-комментарий.
 *Rationale:* навигация по API пакетов.
@@ -123,8 +123,8 @@ alwaysApply: true
 **TEST-03** | MUST | Новые BIRD-сценарии в `internal/birdfmt/testdata/scenarios/*/bird.conf` + `bird -p`.
 *Проверка:* CI job `bird2`.
 
-**TEST-04** | MUST | Изменения `web/` — локально `npm run check` и `npm run lint`; CI job `web` в `.gitea/workflows/ci.yaml`.
+**TEST-04** | MUST | Изменения `web/` — локально **`npm run check` и `npm run lint`** (обе команды, exit 0); CI job `web` в `.gitea/workflows/ci.yaml`. Агент: при fail lint — `npx prettier --write` затем повтор. Только `check` не заменяет `lint`.
-*Проверка:* локальные команды.
+*Проверка:* CI job `web`; `.cursor/rules/web-shadcn.mdc` WEB-19.
 
 **TEST-05** | MUST | Изменения OpenAPI — `npx @redocly/cli lint docs/openapi.yaml`.
 *Проверка:* CI job `openapi`.
@@ -230,7 +230,8 @@ alwaysApply: true
 go vet ./...
 go test ./... -race -count=1
 npx @redocly/cli lint docs/openapi.yaml
-# web: cd web; npm run check; npm run lint
+# web: cd web; npm run check; npm run lint  (или scripts/lint-web.ps1)
+# go fmt/lint: gofmt -w <files>; scripts/lint-go.ps1 (gofmt + vet + golangci-lint)
 # birdfmt: go test ./internal/birdfmt/... -count=1
 ```
 

.cursor/rules/web-shadcn.mdc

@@ -73,6 +73,15 @@ alwaysApply: false
 **WEB-15** | MUST | Сомнения — https://shadcn-svelte.com/llms.txt , Svelte MCP, `npm run check`.
 *Проверка:* локально.
 
+**WEB-19** | MUST | **После любого изменения `web/**`** — перед завершением задачи агент **обязан** выполнить в `web/`:
+```powershell
+npm run check
+npm run lint
+```
+Если `npm run lint` падает (Prettier) — **сначала** `npx prettier --write <изменённые файлы>` или `npx prettier --write .`, затем снова `npm run check` и `npm run lint`. Не сдавать PR/ответ, пока обе команды не exit 0.
+*Rationale:* CI job `web` = `check` + `prettier --check`; `svelte-check` не ловит форматирование.
+*Проверка:* CI job `web`; pre-commit hook `prettier-web`.
+
 **WEB-16** | MUST | Подтверждение удаления — `ConfirmDialog` из patterns, не `window.confirm`.
 *Проверка:* review.
 
@@ -95,15 +104,23 @@ Tailwind v4: https://shadcn-svelte.com/docs/migration/tailwind-v4
 
 ## Enforcement
 
+**Обязательный финальный шаг агента при правках `web/**`:** `npm run check` **и** `npm run lint` (см. **WEB-19**). Только `check` недостаточно.
+
 ```powershell
 cd web
 npm run check
 npm run lint
+# при warn/fail lint:
+npx prettier --write .
+npm run check
+npm run lint
 ```
 
 **PR checklist `web/**`:**
+- [ ] `npm run check` — exit 0
+- [ ] `npm run lint` (prettier --check) — exit 0
 - [ ] `ui/core` / `ui/patterns`, не дубли примитивов
 - [ ] Новые примитивы через shadcn CLI
 - [ ] Ссылка на docs компонента (если новый паттерн)
 
-**CI:** job `web` рекомендован; пока обязательно локально.
+**CI:** job `web` — `npm run check` + `npm run lint`.

.gitea/README.md

@@ -44,6 +44,8 @@ git.shts.su/<owner>/<имя>:sha-<full-sha>
 
 Имена образов: `evobgp-api`, `evobgp-all`, `evobgp-scheduler`, `evobgp-ingest`, `evobgp-render`, `evobgp-deploy`, `evobgp-node`, `evobgp-web`, `evobgp-web-all`, `evobgp-agent`, `evobgp-bird2`.
 
+**Удалённый спикер** (compose `deploy/compose/docker-compose.remote-speaker.yaml`): `evobgp-bird2`, `evobgp-agent`, `evobgp-node` (fallback profile); Traefik — внешний `traefik:latest`. CI: `scripts/validate-remote-speaker-compose.sh`.
+
 Пример:
 
 ```bash

.gitea/workflows/ci.yaml

@@ -198,6 +198,8 @@ jobs:
         run: sh scripts/lint-httpapi.sh
       - name: Check migration pairs (DEP-03)
         run: sh scripts/check-migrations-pair.sh
+      - name: Validate remote speaker compose
+        run: sh scripts/validate-remote-speaker-compose.sh
       # go.mod: go 1.24 — бинарник golangci-lint < v1.64.2 (сборка на Go 1.23) не запускается.
       - name: golangci-lint
         uses: golangci/golangci-lint-action@v6

.gitignore

@@ -16,3 +16,4 @@ Thumbs.db
 .env
 .env.*
 !.env.example
+!.env.*.example

AGENTS.md

@@ -51,6 +51,7 @@
 
 - Консоль пользователя: **PowerShell**; пути в стиле `deploy\compose`.
 - Быстрый старт и переменные: [docs/quickstart.md](docs/quickstart.md), [README.md](README.md).
+- **Go:** после правок — `gofmt -w`, `go vet ./...`, `scripts/lint-go.ps1` (как CI golangci-lint).
 
 ## Язык документации проекта
 
@@ -58,4 +59,12 @@
 
 ## Svelte / фронтенд
 
-При правках `web/**/*.svelte` или Svelte-модулей следуйте навыкам/инструментам проекта (официальный Svelte MCP и скиллы Cursor, если подключены).
+При правках `web/**/*.svelte` или Svelte-модулей следуйте [.cursor/rules/web-shadcn.mdc](.cursor/rules/web-shadcn.mdc) (**WEB-19**): перед завершением задачи **обязательно**:
+
+```powershell
+cd web
+npm run check
+npm run lint
+```
+
+Если `lint` падает — `npx prettier --write .` и повторить обе команды. CI job `web` не пропускает без этого.

cmd/evobgp-agent/main.go

@@ -6,8 +6,10 @@ import (
 	"fmt"
 	"log"
 	"os"
+	"sync"
 	"time"
 
+	"evobgp/internal/agentserver"
 	"evobgp/internal/birdfmt"
 )
 
@@ -17,12 +19,14 @@ func main() {
 	socket := flag.String("socket", "", "optional birdc control socket (-s)")
 	timeout := flag.Duration("timeout", 30*time.Second, "timeout for bird/birdc")
 	watchEvery := flag.Duration("watch-interval", 30*time.Second, "for watch: interval between birdc configure")
+	listen := flag.String("listen", "", "for serve: listen address (default :8443 or EVOBGP_AGENT_LISTEN)")
 	flag.Usage = func() {
 		fmt.Fprintf(os.Stderr, "Usage: %s [flags] <command>\n", os.Args[0])
 		fmt.Fprintf(os.Stderr, "Commands:\n")
 		fmt.Fprintf(os.Stderr, "  parse-check <path/to/bird.conf>   run bird -c <path> -p (syntax check)\n")
 		fmt.Fprintf(os.Stderr, "  configure                         run birdc configure (reload running BIRD)\n")
 		fmt.Fprintf(os.Stderr, "  watch                             periodically run birdc configure (compose sidecar)\n")
+		fmt.Fprintf(os.Stderr, "  serve                             Panel→Node HTTP API (POST /v1/agent/sync)\n")
 		flag.PrintDefaults()
 	}
 	flag.Parse()
@@ -40,9 +44,21 @@ func main() {
 		ctl.Birdc = *birdc
 	}
 
-	ctx, cancel := context.WithTimeout(context.Background(), *timeout)
+	switch args[0] {
-	defer cancel()
+	case "serve":
+		runServe(*listen, *timeout)
+	case "parse-check", "configure", "watch":
+		ctx, cancel := context.WithTimeout(context.Background(), *timeout)
+		defer cancel()
+		runBirdCommand(ctx, args, ctl, *watchEvery, *timeout)
+	default:
+		fmt.Fprintf(os.Stderr, "unknown command: %s\n", args[0])
+		flag.Usage()
+		os.Exit(2)
+	}
+}
 
+func runBirdCommand(ctx context.Context, args []string, ctl *birdfmt.BirdCtl, watchEvery, timeout time.Duration) {
 	switch args[0] {
 	case "parse-check":
 		if len(args) != 2 {
@@ -63,23 +79,51 @@ func main() {
 			os.Exit(1)
 		}
 	case "watch":
-		if *watchEvery <= 0 {
+		if watchEvery <= 0 {
 			fmt.Fprintln(os.Stderr, "watch-interval must be > 0")
 			os.Exit(2)
 		}
-		log.Printf("evobgp-agent watch: birdc configure every %s (socket=%q)", *watchEvery, *socket)
+		log.Printf("evobgp-agent watch: birdc configure every %s (socket=%q)", watchEvery, ctl.Socket)
 		for {
-			cctx, cancel := context.WithTimeout(context.Background(), *timeout)
+			cctx, cancel := context.WithTimeout(context.Background(), timeout)
 			err := ctl.Configure(cctx)
 			cancel()
 			if err != nil {
 				log.Printf("evobgp-agent watch: configure: %v", err)
 			}
-			time.Sleep(*watchEvery)
+			time.Sleep(watchEvery)
 		}
-	default:
+	}
-		fmt.Fprintf(os.Stderr, "unknown command: %s\n", args[0])
+}
-		flag.Usage()
+
+func runServe(listenFlag string, syncTimeout time.Duration) {
+	cfg, err := agentserver.ConfigFromEnv()
+	if err != nil {
+		fmt.Fprintln(os.Stderr, err)
 		os.Exit(2)
+	}
+	if listenFlag != "" {
+		cfg.Listen = listenFlag
+	}
+	if syncTimeout > 0 {
+		cfg.SyncTimeout = syncTimeout
+	}
+	var mu sync.Mutex
+	var lastRev string
+	var lastAt time.Time
+	cfg.LastSync = func() (string, time.Time) {
+		mu.Lock()
+		defer mu.Unlock()
+		return lastRev, lastAt
+	}
+	cfg.OnSyncSuccess = func(rev string) {
+		mu.Lock()
+		lastRev = rev
+		lastAt = time.Now().UTC()
+		mu.Unlock()
+	}
+	if err := agentserver.ListenAndServe(cfg); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
 	}
 }

cmd/evobgp-api/main.go

@@ -57,7 +57,7 @@ func main() {
 			tid, mCDN, mIP, rev, sp := srv.Store().DemoIDs()
 			log.Printf("demo tenant=%s module_cdn=%s module_ip_ranges=%s revision=%s speaker=%s", tid, mCDN, mIP, rev, sp)
 			log.Printf("example: EVOBGP_API_KEYS=op|%s|operator,node|%s|node", tid, tid)
-			log.Printf("with EVOBGP_DEV_INSECURE=1 use Authorization: Bearer dev (operator, demo tenant only)")
+			log.Printf("demo auth: Authorization: Bearer dev (operator, demo tenant only)")
 		}
 		if err := httpSrv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
 			log.Fatal(err)

deploy/compose/.env.remote-speaker-tls.example

@@ -0,0 +1,11 @@
+# TLS для Traefik (profile production). Скопируйте в .env.remote-speaker-tls
+
+# FQDN agent API (DNS only в Cloudflare → IP этой VPS)
+AGENT_DOMAIN=bgp-dc2.example.com
+
+# Let's Encrypt + Cloudflare DNS challenge (как evobgp-edge на CP)
+LETSENCRYPT_EMAIL=[email protected]
+CF_DNS_API_TOKEN=
+
+# IP основного сервера (Panel) — единственный источник wake-up / health
+PANEL_IP_WHITELIST=203.0.113.1/32

deploy/compose/.env.remote-speaker.example

@@ -0,0 +1,22 @@
+# Скопируйте в .env.remote-speaker рядом с docker-compose.remote-speaker.yaml
+# Значения agent_secret и node token — из Web UI после создания спикера.
+
+EVOBGP_REGISTRY=git.shts.su/denozord
+EVOBGP_IMAGE_TAG=latest
+
+# Control plane (HTTPS в prod)
+EVOBGP_CONTROL_PLANE_URL=https://cp.example.com:8080
+
+# Из карточки спикера в панели
+EVOBGP_SPEAKER_ID=00000000-0000-0000-0000-000000000001
+EVOBGP_AGENT_SECRET=change-me-from-ui-once
+EVOBGP_NODE_TOKEN=evobgp_node_token_from_access
+
+# GET /v1/bundle/signing-public-key (operator) или env CP EVOBGP_BUNDLE_SEED_HEX
+EVOBGP_BUNDLE_PUBKEY_BASE64=
+
+# Fallback polling (profile fallback)
+EVOBGP_SYNC_INTERVAL_SEC=300
+
+# Lab profile plain — порт agent на хосте
+EVOBGP_AGENT_PORT=8443

deploy/compose/docker-compose.remote-speaker.yaml

@@ -0,0 +1,157 @@
+# Удалённый BGP-спикер (Remnawave-style): bird2 + evobgp-agent + Traefik (LE).
+# См. docs/remote-speakers.md
+#
+#   cp .env.remote-speaker.example .env.remote-speaker
+#   cp .env.remote-speaker-tls.example .env.remote-speaker-tls
+#   docker compose -f docker-compose.remote-speaker.yaml \
+#     --env-file .env.remote-speaker --env-file .env.remote-speaker-tls up -d
+#
+# Profiles:
+#   production (default) — bird2 host + agent + evobgp-edge
+#   plain              — bird2 + agent без Traefik (lab)
+#   fallback           — + sync-bundle polling
+
+name: evobgp-remote-speaker
+
+x-logging: &default-logging
+  driver: json-file
+  options:
+    max-size: "10m"
+    max-file: "3"
+
+services:
+  bird2:
+    profiles: ["production", "plain", "fallback"]
+    image: ${EVOBGP_REGISTRY:-git.shts.su/denozord}/evobgp-bird2:${EVOBGP_IMAGE_TAG:-latest}
+    restart: unless-stopped
+    network_mode: host
+    cap_add:
+      - NET_ADMIN
+    sysctls:
+      net.ipv4.ip_forward: "1"
+      net.ipv6.conf.all.forwarding: "1"
+    volumes:
+      - bird_etc:/etc/bird
+      - bird_run:/run/bird
+    logging: *default-logging
+
+  evobgp-agent:
+    profiles: ["production"]
+    image: ${EVOBGP_REGISTRY:-git.shts.su/denozord}/evobgp-agent:${EVOBGP_IMAGE_TAG:-latest}
+    restart: unless-stopped
+    depends_on:
+      - bird2
+    cap_add:
+      - NET_ADMIN
+    environment:
+      EVOBGP_AGENT_LISTEN: ":8443"
+      EVOBGP_AGENT_SECRET: ${EVOBGP_AGENT_SECRET:?set EVOBGP_AGENT_SECRET}
+      EVOBGP_CONTROL_PLANE_URL: ${EVOBGP_CONTROL_PLANE_URL:?set EVOBGP_CONTROL_PLANE_URL}
+      EVOBGP_NODE_TOKEN: ${EVOBGP_NODE_TOKEN:?set EVOBGP_NODE_TOKEN}
+      EVOBGP_SPEAKER_ID: ${EVOBGP_SPEAKER_ID:?set EVOBGP_SPEAKER_ID}
+      EVOBGP_BUNDLE_PUBKEY_BASE64: ${EVOBGP_BUNDLE_PUBKEY_BASE64:?set EVOBGP_BUNDLE_PUBKEY_BASE64}
+      EVOBGP_BIRD_EXTRACT_DIR: /etc/bird
+      EVOBGP_BIRDC_SOCKET: /run/bird/bird.ctl
+    volumes:
+      - bird_etc:/etc/bird
+      - bird_run:/run/bird
+    entrypoint: ["/usr/local/bin/evobgp-agent"]
+    command: ["serve", "-socket=/run/bird/bird.ctl"]
+    networks:
+      - speaker-net
+    labels:
+      - traefik.enable=true
+      - traefik.http.routers.evobgp-agent.rule=Host(`${AGENT_DOMAIN}`)
+      - traefik.http.routers.evobgp-agent.entrypoints=websecure
+      - traefik.http.routers.evobgp-agent.tls=true
+      - traefik.http.routers.evobgp-agent.tls.certresolver=letsencrypt
+      - traefik.http.routers.evobgp-agent.middlewares=panel-ipwhitelist@docker
+      - traefik.http.middlewares.panel-ipwhitelist.ipallowlist.sourcerange=${PANEL_IP_WHITELIST}
+      - traefik.http.services.evobgp-agent.loadbalancer.server.port=8443
+    logging: *default-logging
+
+  evobgp-agent-plain:
+    profiles: ["plain", "fallback"]
+    image: ${EVOBGP_REGISTRY:-git.shts.su/denozord}/evobgp-agent:${EVOBGP_IMAGE_TAG:-latest}
+    restart: unless-stopped
+    network_mode: host
+    depends_on:
+      - bird2
+    cap_add:
+      - NET_ADMIN
+    environment:
+      EVOBGP_AGENT_LISTEN: "${EVOBGP_AGENT_PORT:-8443}"
+      EVOBGP_AGENT_SECRET: ${EVOBGP_AGENT_SECRET:?set EVOBGP_AGENT_SECRET}
+      EVOBGP_CONTROL_PLANE_URL: ${EVOBGP_CONTROL_PLANE_URL:?set EVOBGP_CONTROL_PLANE_URL}
+      EVOBGP_NODE_TOKEN: ${EVOBGP_NODE_TOKEN:?set EVOBGP_NODE_TOKEN}
+      EVOBGP_SPEAKER_ID: ${EVOBGP_SPEAKER_ID:?set EVOBGP_SPEAKER_ID}
+      EVOBGP_BUNDLE_PUBKEY_BASE64: ${EVOBGP_BUNDLE_PUBKEY_BASE64:?set EVOBGP_BUNDLE_PUBKEY_BASE64}
+      EVOBGP_BIRD_EXTRACT_DIR: /etc/bird
+      EVOBGP_BIRDC_SOCKET: /run/bird/bird.ctl
+    volumes:
+      - bird_etc:/etc/bird
+      - bird_run:/run/bird
+    entrypoint: ["/usr/local/bin/evobgp-agent"]
+    command: ["serve", "-listen=:${EVOBGP_AGENT_PORT:-8443}", "-socket=/run/bird/bird.ctl"]
+    logging: *default-logging
+
+  evobgp-edge:
+    profiles: ["production"]
+    image: traefik:latest
+    restart: unless-stopped
+    depends_on:
+      - evobgp-agent
+    ports:
+      - "80:80"
+      - "443:443"
+    environment:
+      DOCKER_API_VERSION: "1.44"
+      CF_DNS_API_TOKEN: ${CF_DNS_API_TOKEN:?set CF_DNS_API_TOKEN}
+    command:
+      - --api.dashboard=false
+      - --providers.docker=true
+      - --providers.docker.exposedbydefault=false
+      - --entrypoints.web.address=:80
+      - --entrypoints.websecure.address=:443
+      - --entrypoints.web.http.redirections.entrypoint.to=websecure
+      - --entrypoints.web.http.redirections.entrypoint.scheme=https
+      - --certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL:?set LETSENCRYPT_EMAIL}
+      - --certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json
+      - --certificatesresolvers.letsencrypt.acme.dnschallenge=true
+      - --certificatesresolvers.letsencrypt.acme.dnschallenge.provider=cloudflare
+      - --certificatesresolvers.letsencrypt.acme.dnschallenge.delaybeforecheck=15
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - traefik_letsencrypt:/letsencrypt
+    networks:
+      - speaker-net
+    logging: *default-logging
+
+  sync-bundle:
+    profiles: ["fallback"]
+    image: ${EVOBGP_REGISTRY:-git.shts.su/denozord}/evobgp-node:${EVOBGP_IMAGE_TAG:-latest}
+    restart: unless-stopped
+    depends_on:
+      - bird2
+    environment:
+      EVOBGP_CONTROL_PLANE_URL: ${EVOBGP_CONTROL_PLANE_URL:?set EVOBGP_CONTROL_PLANE_URL}
+      EVOBGP_NODE_TOKEN: ${EVOBGP_NODE_TOKEN:?set EVOBGP_NODE_TOKEN}
+      EVOBGP_SPEAKER_ID: ${EVOBGP_SPEAKER_ID:?set EVOBGP_SPEAKER_ID}
+      EVOBGP_BUNDLE_PUBKEY_BASE64: ${EVOBGP_BUNDLE_PUBKEY_BASE64:?set EVOBGP_BUNDLE_PUBKEY_BASE64}
+      EVOBGP_SYNC_INTERVAL_SEC: ${EVOBGP_SYNC_INTERVAL_SEC:-300}
+    volumes:
+      - bird_etc:/etc/bird
+      - bird_run:/run/bird
+      - ../../scripts/sync-bundle.sh:/usr/local/bin/sync-bundle.sh:ro
+    entrypoint: ["/bin/sh", "/usr/local/bin/sync-bundle.sh"]
+    network_mode: host
+    logging: *default-logging
+
+networks:
+  speaker-net:
+
+volumes:
+  bird_etc:
+  bird_run:
+  traefik_letsencrypt:
+    name: evobgp_speaker_traefik_letsencrypt

docs/README.md

@@ -20,6 +20,7 @@
 | [api.md](api.md) | REST: префикс `/v1`, публичные маршруты, ссылки на OpenAPI |
 | [router-lists-ui-integration.md](router-lists-ui-integration.md) | Интеграция `router-lists-ui` с EvoBGP API (`DOMAINS/IP_RANGES/AS_PREFIXES/communities`) |
 | [access.md](access.md) | Выдача доступа: API-ключи, роли, нода, CORS |
+| [remote-speakers.md](remote-speakers.md) | Удалённые BGP-реплики: Traefik, agent sync, compose |
 | [releasing.md](releasing.md) | Автоматические релизы, Conventional Commits, CI |
 | [openapi.yaml](openapi.yaml) | Источник правды по контракту API |
 | [OPENAPI-GITEA.md](OPENAPI-GITEA.md) | Как открыть HTML-документацию API (в т.ч. из Gitea) |

docs/access.md

@@ -22,6 +22,19 @@ opkey|01ARZ3NDEKTSV4RRFFQ69G5FAV|operator,nodekey|01ARZ3NDEKTSV4RRFFQ69G5FAV|nod
 
 При включённом демо-сиде сервер при старте может вывести в лог готовую подсказку с реальным `tenant_id` из БД — см. лог `evobgp-api` / `evobgp-all`.
 
+Ключи из `EVOBGP_API_KEYS` загружаются при старте и **дополняют** ключи из таблицы `api_key` в БД (break-glass / bootstrap). После первого operator-ключа можно создавать остальные через API или веб-настройки.
+
+### Управление через API и UI
+
+При подключённой БД operator может:
+
+- `GET|POST /v1/api-keys`, `GET|PATCH|DELETE /v1/api-keys/{id}`, `POST /v1/api-keys/{id}/rotate` — см. OpenAPI, тег **API keys**.
+- В веб-панели: **Права доступа** (`/access`) → блок «API-ключи» (только для роли `operator`). Токен для браузера — в **Настройки** (`/settings`).
+
+Полный токен возвращается **один раз** в ответе `201` (создание) и `200` (ротация). В списках — только `prefix` (первые 8 символов). В БД хранится SHA-256 токена, не plaintext.
+
+`GET /v1/auth/session` — текущие `tenant_id` и `role` (для UI).
+
 ### Роли
 
 | Роль | Уровень | Назначение |
@@ -33,11 +46,11 @@ opkey|01ARZ3NDEKTSV4RRFFQ69G5FAV|operator,nodekey|01ARZ3NDEKTSV4RRFFQ69G5FAV|nod
 
 Обратное ограничение: для эндпоинтов ноды требуется именно роль **`node`**; остальные роли получают отказ.
 
-### Режим разработки `EVOBGP_DEV_INSECURE`
+### Токен `dev` (локальная разработка)
 
-Если установлено `EVOBGP_DEV_INSECURE=1` и в store доступен демо-tenant (`DemoIDs`), то запрос с заголовком **`Authorization: Bearer dev`** получает контекст **`operator`** для этого tenant.
+Если в store доступен демо-tenant (`DemoIDs`, обычно `EVOBGP_SEED_DEMO` не равен `0`), заголовок **`Authorization: Bearer dev`** даёт роль **`operator`** для этого tenant. **Не зависит** от `EVOBGP_DEV_INSECURE`.
 
-**Запрещено** в продакшене: любой, кто знает заголовок, получает полные права оператора на демо-данные. В reference Compose (`deploy/compose/docker-compose.yaml`) флаг включён только для локальной разработки.
+**Запрещено** в продакшене: не оставляйте demo-seed с известным токеном `dev` на боевых данных. Переменная `EVOBGP_DEV_INSECURE` в текущей версии **не влияет** на аутентификацию (оставлена в compose для совместимости; не включайте в production — см. SEC-02 в инженерных правилах).
 
 ### Синхронные «тяжёлые» GET (control plane)
 
@@ -50,7 +63,9 @@ opkey|01ARZ3NDEKTSV4RRFFQ69G5FAV|operator,nodekey|01ARZ3NDEKTSV4RRFFQ69G5FAV|nod
 
 ## Публичный ключ бандла для нод
 
-При старте API в лог печатается строка **bundle signing public key (base64)**. Её нужно передать администратору реплики и использовать в `evobgp-node`:
+При старте API в лог печатается строка **bundle signing public key (base64)**. Альтернатива для operator: **`GET /v1/bundle/signing-public-key`** → поле `public_key_base64` для `EVOBGP_BUNDLE_PUBKEY_BASE64` на реплике.
+
+Использование в `evobgp-node` / agent:
 
 ```text
 evobgp-node verify-bundle -f bundle.tar.gz -pubkey-base64 "<из_лога_API>"
@@ -63,6 +78,17 @@ evobgp-node apply-bundle -f bundle.tar.gz -extract-dir /path/to/dir -pubkey-base
 evobgp-node pull-bundle -base-url http://control.example:8080 -token "<node_token>" -speaker-id "<uuid>"
 ```
 
+## Panel→Node dispatch (удалённые спикеры)
+
+На control plane (prod):
+
+```text
+EVOBGP_NODE_DISPATCH_ENABLED=1
+EVOBGP_BUNDLE_SEED_HEX=<32 bytes hex, стабильный>
+```
+
+После `deploy_apply` CP шлёт `POST https://AGENT_DOMAIN/v1/agent/sync` с `Authorization: Bearer <agent_secret>`. На реплике — `EVOBGP_AGENT_SECRET`, Traefik `PANEL_IP_WHITELIST`. Подробнее: [remote-speakers.md](remote-speakers.md).
+
 ## CORS для веб-интерфейса
 
 Браузерные запросы с другого origin требуют заголовков CORS на API. Задайте список разрешённых origin через **`EVOBGP_CORS_ORIGINS`** (через запятую), например:
@@ -93,6 +119,7 @@ http://localhost:5173,http://127.0.0.1:5173,https://ui.example.com
 | GET модули, ревизии, peers, speakers | да | да | да | нет |
 | POST/PATCH/DELETE CRUD сущностей | нет | да | да | нет |
 | apply, rollback, PATCH settings | нет | нет | да | нет |
+| Управление API-ключами (`/v1/api-keys`) | нет | нет | да | нет |
 | bundle, latest revision, enroll | нет | нет | нет | да |
 
 Точные проверки по каждому маршруту — в коде `internal/httpapi` и в схеме безопасности операций в OpenAPI.

docs/api.md

@@ -44,6 +44,12 @@
 - `GET|POST /v1/communities`
 - `GET|PATCH|DELETE /v1/communities/{id}`
 
+### API keys
+
+- `GET /v1/auth/session` — tenant и роль текущего ключа
+- `GET|POST /v1/api-keys` — список и создание (operator)
+- `GET|PATCH|DELETE /v1/api-keys/{id}`, `POST /v1/api-keys/{id}/rotate`
+
 ### Peers
 
 - `GET /v1/peers`, `POST /v1/peers`

docs/architecture.md

@@ -19,7 +19,7 @@
 | `evobgp-render` | По умолчанию только heartbeat; при `EVOBGP_RENDER_AUTOPUBLISH=1` выставляет всем спикерам tenant последнюю ревизию (упрощение для демо). |
 | `evobgp-deploy` | Периодически логирует **drift**: `last_applied_revision_id` vs опубликованная ревизия для ноды. |
 | `evobgp-node` | CLI реплики: `pull-bundle`, `verify-bundle`, `apply-bundle`. |
-| `evobgp-agent` | Локальный агент рядом с BIRD (например `watch` по сокету). |
+| `evobgp-agent` | Локальный агент рядом с BIRD: `watch`, **`serve`** (Panel→Node sync API на реплике). |
 
 В Docker Compose профиль **reference** запускает отдельные контейнеры под `evobgp-api` и четыре воркера; профиль **microvps** использует один контейнер `evobgp-all`.
 
@@ -40,8 +40,12 @@
 | `observability` | Метрики Prometheus, HTTP middleware. |
 | `broker` | Опциональный `EVOBGP_BROKER_URL` для будущей шины; сейчас задачи только in-process (`jobs.Registry`), пакет лишь логирует факт настройки URL. |
 | `pipeline` | Ingest+render в одном шаге для `module_refresh`: выборка префиксов (CDN/AS/IP/пустые DOMAINS), `CreateRenderRevision`, превью BIRD через `birdfmt`. |
+| `nodedispatch` | Panel→Node HTTP wake-up (`POST /v1/agent/sync`) после `deploy_apply`. |
+| `agentserver` | HTTP API на реплике (`serve`): sync + health для Traefik. |
 
-## Диаграмма: эталонный Compose (reference)
+## Удалённые спикеры
+
+Реплики на отдельных VPS: [remote-speakers.md](remote-speakers.md). CP публикует ревизию и при `EVOBGP_NODE_DISPATCH_ENABLED=1` будит agent; agent тянет signed bundle и применяет BIRD. Compose: `deploy/compose/docker-compose.remote-speaker.yaml`.
 
 ```mermaid
 flowchart LR

docs/manual.md

@@ -104,6 +104,7 @@ EvoBGP управляет генерацией и применением BGP-к
 ### Настройки (`/v1/settings`)
 - KV c ключами BIRD и дополнительными feature flags.
 - Ключевые параметры BIRD: `bird_router_id`, `bird_local_ipv4`, `bird_local_ipv6`, `bird_local_asn`, `bird_bgp_source_ipv4`, `bird_bgp_source_ipv6`.
+- **Tenant settings** — глобальный default. **Per-speaker** override: `meta_json.bird_bgp_source_ipv4` / `node_ipv4` в карточке спикера (Web UI → Сеть → Спикеры); pipeline накладывает overlay при сборке бандла для реплики. См. [remote-speakers.md](remote-speakers.md).
 
 ## 7. Эксплуатация и runbook
 

docs/openapi.yaml

@@ -45,6 +45,10 @@ tags:
     description: "API для evobgp-node (бандлы ревизий и enrollment). Отдельный ключ или mTLS, роль node."
   - name: Settings
     description: Глобальные настройки и feature flags; изменение - только operator.
+  - name: API keys
+    description: Управление API-ключами tenant (operator). Секрет возвращается только при создании и ротации.
+  - name: Auth
+    description: Сессия текущего API-ключа (tenant и роль).
 
 security:
   - bearerAuth: []
@@ -135,6 +139,12 @@ components:
       required: true
       schema:
         $ref: "#/components/schemas/ResourceId"
+    ApiKeyId:
+      name: id
+      in: path
+      required: true
+      schema:
+        $ref: "#/components/schemas/ResourceId"
     SourceId:
       name: source_id
       in: path
@@ -639,6 +649,82 @@ components:
         vault_secret_ref:
           type: ["string", "null"]
 
+    AuthSession:
+      type: object
+      required: [tenant_id, role]
+      properties:
+        tenant_id:
+          $ref: "#/components/schemas/ResourceId"
+        role:
+          type: string
+          enum: [viewer, editor, operator, node]
+
+    ApiKey:
+      type: object
+      required: [id, name, role, prefix, created_at, updated_at]
+      properties:
+        id:
+          $ref: "#/components/schemas/ResourceId"
+        name:
+          type: string
+        role:
+          type: string
+          enum: [viewer, editor, operator, node]
+        prefix:
+          type: string
+          description: Первые 8 символов токена для идентификации в UI.
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+        expires_at:
+          type: ["string", "null"]
+          format: date-time
+        revoked_at:
+          type: ["string", "null"]
+          format: date-time
+        last_used_at:
+          type: ["string", "null"]
+          format: date-time
+      additionalProperties: true
+
+    ApiKeyCreate:
+      type: object
+      required: [name, role]
+      properties:
+        name:
+          type: string
+        role:
+          type: string
+          enum: [viewer, editor, operator, node]
+        expires_at:
+          type: ["string", "null"]
+          format: date-time
+
+    ApiKeyPatch:
+      type: object
+      properties:
+        name:
+          type: string
+        role:
+          type: string
+          enum: [viewer, editor, operator, node]
+        expires_at:
+          type: ["string", "null"]
+          format: date-time
+
+    ApiKeyCreated:
+      allOf:
+        - $ref: "#/components/schemas/ApiKey"
+        - type: object
+          required: [token]
+          properties:
+            token:
+              type: string
+              description: Полный Bearer-токен; показывается один раз.
+
     BgpCommunity:
       type: object
       required:
@@ -692,8 +778,47 @@ components:
           type: string
         last_applied_revision_id:
           type: ["string", "null"]
+        published_revision_id:
+          type: ["string", "null"]
+          description: Последняя опубликованная на CP ревизия для этого спикера.
+        published_at:
+          type: ["string", "null"]
+          format: date-time
+        agent_domain:
+          type: string
+          description: FQDN agent API за Traefik (Address в UI, Remnawave-style).
+        node_ipv4:
+          type: string
+          description: IPv4 VPS; default для bird_bgp_source_ipv4.
+        bird_bgp_source_ipv4:
+          type: string
+          description: Per-speaker override router id / BGP local (см. pipeline overlay).
+        dispatch_status:
+          type: string
+          description: ok, error, skipped — последний Panel→Node wake-up.
+        sync_status:
+          type: string
+          description: synced, error — состояние sync на реплике.
+        last_dispatch_at:
+          type: string
+          format: date-time
+        last_dispatch_error:
+          type: string
+        meta_json:
+          type: object
+          description: >
+            Расширяемый объект. Ключи agent_domain, agent_secret (только при создании),
+            agent_port, node_ipv4, bird_bgp_source_ipv4, bird_bgp_source_ipv6.
       additionalProperties: true
 
+    BundleSigningPublicKey:
+      type: object
+      required: [public_key_base64]
+      properties:
+        public_key_base64:
+          type: string
+          description: Ed25519 public key (base64) для verify-bundle на реплике.
+
     ConfigRevision:
       type: object
       required:
@@ -914,8 +1039,15 @@ components:
       properties:
         role:
           type: string
+          default: replica
         endpoint:
           type: string
+          description: URL agent или https://AGENT_DOMAIN
+        meta_json:
+          type: string
+          description: >
+            JSON-объект. Ключи node_ipv4, bird_bgp_source_ipv4 (default = node_ipv4),
+            agent_domain, agent_secret (генерируется при создании если пуст).
       additionalProperties: true
 
     BgpSpeakerPatch:
@@ -925,6 +1057,9 @@ components:
           type: string
         endpoint:
           type: string
+        meta_json:
+          type: string
+          description: JSON-объект с ключами agent_domain, node_ipv4, bird_bgp_source_ipv4 и др.
       additionalProperties: true
 
     LatestRevisionPointer:
@@ -2130,6 +2265,24 @@ paths:
         default:
           $ref: "#/components/responses/DefaultProblem"
 
+  /v1/bundle/signing-public-key:
+    get:
+      tags: [Bundles]
+      summary: Публичный ключ подписи бандлов
+      description: >
+        Ed25519 public key (base64) для `evobgp-node verify-bundle` / agent sync на реплике.
+        Роль viewer и выше.
+      operationId: getBundleSigningPublicKey
+      responses:
+        "200":
+          description: Ключ для env EVOBGP_BUNDLE_PUBKEY_BASE64 на реплике.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/BundleSigningPublicKey"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
   /v1/speakers:
     get:
       tags: [Speakers]
@@ -2643,6 +2796,170 @@ paths:
         default:
           $ref: "#/components/responses/DefaultProblem"
 
+  /v1/auth/session:
+    get:
+      tags: [Auth]
+      summary: Текущая сессия API-ключа
+      operationId: getAuthSession
+      parameters:
+        - $ref: "#/components/parameters/TenantId"
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthSession"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
+  /v1/api-keys:
+    get:
+      tags: [API keys]
+      summary: Список API-ключей tenant
+      description: Только роль **operator**. Секреты не возвращаются.
+      operationId: listApiKeys
+      parameters:
+        - $ref: "#/components/parameters/TenantId"
+        - $ref: "#/components/parameters/Cursor"
+        - $ref: "#/components/parameters/Limit"
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [items, has_more]
+                properties:
+                  items:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/ApiKey"
+                  next_cursor:
+                    type: ["string", "null"]
+                  has_more:
+                    type: boolean
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+    post:
+      tags: [API keys]
+      summary: Создать API-ключ
+      operationId: createApiKey
+      parameters:
+        - $ref: "#/components/parameters/TenantId"
+        - $ref: "#/components/parameters/IdempotencyKey"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ApiKeyCreate"
+      responses:
+        "201":
+          description: Ключ создан; token в ответе один раз.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiKeyCreated"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "422":
+          $ref: "#/components/responses/UnprocessableEntity"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
+  /v1/api-keys/{id}:
+    parameters:
+      - $ref: "#/components/parameters/TenantId"
+      - $ref: "#/components/parameters/ApiKeyId"
+    get:
+      tags: [API keys]
+      summary: Получить метаданные API-ключа
+      operationId: getApiKey
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiKey"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          $ref: "#/components/responses/NotFound"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+    patch:
+      tags: [API keys]
+      summary: Обновить API-ключ
+      operationId: patchApiKey
+      parameters:
+        - $ref: "#/components/parameters/IdempotencyKey"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ApiKeyPatch"
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiKey"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          $ref: "#/components/responses/NotFound"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+    delete:
+      tags: [API keys]
+      summary: Отозвать API-ключ
+      operationId: revokeApiKey
+      parameters:
+        - $ref: "#/components/parameters/IdempotencyKey"
+      responses:
+        "204":
+          description: Отозван.
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          $ref: "#/components/responses/NotFound"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
+  /v1/api-keys/{id}/rotate:
+    parameters:
+      - $ref: "#/components/parameters/TenantId"
+      - $ref: "#/components/parameters/ApiKeyId"
+    post:
+      tags: [API keys]
+      summary: Ротировать секрет API-ключа
+      description: Выдаёт новый token; старый перестаёт работать сразу.
+      operationId: rotateApiKey
+      parameters:
+        - $ref: "#/components/parameters/IdempotencyKey"
+      responses:
+        "200":
+          description: Успешно.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ApiKeyCreated"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+        "404":
+          $ref: "#/components/responses/NotFound"
+        default:
+          $ref: "#/components/responses/DefaultProblem"
+
   /v1/settings:
     get:
       tags: [Settings]

docs/quickstart.md

@@ -203,6 +203,10 @@ docker compose --profile reference up -d
 
 В **evobgp-all** (microvps) те же пакеты крутятся в одном процессе и используют общий `jobs.Registry` без HTTP.
 
+## Удалённые BGP-спикеры
+
+Реплики на отдельных VPS (bird2 + agent + Traefik): см. **[remote-speakers.md](remote-speakers.md)**. На CP включите `EVOBGP_NODE_DISPATCH_ENABLED=1` и зафиксируйте `EVOBGP_BUNDLE_SEED_HEX`. Compose: `deploy/compose/docker-compose.remote-speaker.yaml`.
+
 ## Вариант 3: Локально без Docker (только API)
 
 1. Поднимите PostgreSQL и создайте БД (или используйте существующую).

docs/remote-speakers.md

@@ -0,0 +1,104 @@
+# Удалённые BGP-спикеры (Remnawave-style)
+
+Runbook для реплик **bird2 + evobgp-agent** на отдельных VPS. Control plane (`evobgp-all`) инициирует доставку после `module_refresh` → `deploy_apply`; реплика **не** собирает префиксы сама.
+
+## Модель
+
+| Remnawave | EvoBGP |
+|-----------|--------|
+| Panel → Node:PORT | CP POST `https://AGENT_DOMAIN/v1/agent/sync` |
+| SECRET_KEY | `agent_secret` (Bearer) |
+| Copy compose | Web UI → карточка спикера |
+| Push Xray JSON | Wake-up → pull signed bundle → verify Ed25519 → apply |
+
+Подробнее: [architecture.md](architecture.md).
+
+## Быстрый старт
+
+1. **CP (microvps-full):** зафиксируйте `EVOBGP_BUNDLE_SEED_HEX` (32 байта hex) — стабильный ключ подписи бандлов.
+2. **Web UI → Сеть → Спикеры:** создайте спикер `role=replica`, укажите **Agent domain**, **IP ноды**, **BGP source** (по умолчанию = IP ноды).
+3. Сохраните **`agent_secret`** (показывается один раз) и скопируйте **docker-compose** из UI.
+4. Выдайте **node API-ключ** ([access.md](access.md)) для `EVOBGP_NODE_TOKEN`.
+5. `GET /v1/bundle/signing-public-key` → `EVOBGP_BUNDLE_PUBKEY_BASE64` на реплике.
+6. На VPS реплики:
+   ```bash
+   cd deploy/compose
+   cp .env.remote-speaker.example .env.remote-speaker
+   cp .env.remote-speaker-tls.example .env.remote-speaker-tls
+   # заполните переменные из UI
+   docker compose -f docker-compose.remote-speaker.yaml \
+     --env-file .env.remote-speaker --env-file .env.remote-speaker-tls \
+     --profile production up -d
+   ```
+7. **CP:** `EVOBGP_NODE_DISPATCH_ENABLED=1` — Panel шлёт wake-up после publish.
+8. Cloudflare: `AGENT_DOMAIN` → IP VPS, **DNS only** (как Web UI в [quickstart.md](quickstart.md)).
+
+## Compose-профили
+
+| Profile | Состав |
+|---------|--------|
+| `production` | bird2 (host) + agent + Traefik LE |
+| `plain` | bird2 + agent на хосте без Traefik (только lab) |
+| `fallback` | + `sync-bundle` polling (`scripts/sync-bundle.sh`) |
+
+Файлы: [docker-compose.remote-speaker.yaml](../deploy/compose/docker-compose.remote-speaker.yaml).
+
+## Firewall
+
+| Порт | Кто | Зачем |
+|------|-----|-------|
+| **443** | IP CP (`PANEL_IP_WHITELIST`) | HTTPS dispatch + health |
+| **179** | BGP peers | Data plane |
+| **80** | ACME | Traefik → 443 |
+
+## Безопасность (три участка)
+
+1. **CP → реплика:** HTTPS (LE) + Traefik ipallowlist + `agent_secret`.
+2. **Реплика → CP:** HTTPS + роль `node` (только bundle/latest/enroll).
+3. **Конфиг:** Ed25519 `bundle.sig`, SHA-256 manifest, `bird -p`, LKG на ноде.
+
+Prod checklist:
+
+- [ ] `EVOBGP_CONTROL_PLANE_URL=https://...`
+- [ ] `EVOBGP_NODE_DISPATCH_ENABLED=1` на CP
+- [ ] `EVOBGP_BUNDLE_SEED_HEX` на CP (не менять после выдачи pubkey репликам)
+- [ ] Уникальные `agent_secret` и node token на спикер
+- [ ] Не использовать profile `plain` в prod
+- [ ] Не отключать verify-bundle в agent
+
+## Per-speaker BGP source
+
+В UI: **IP ноды** (`meta_json.node_ipv4`) и **BGP source IPv4** (`bird_bgp_source_ipv4`, default = IP ноды). Pipeline накладывает overlay при `GET .../bundle/{revision_id}` — меняются `router id` и peer `local`.
+
+Tenant `/v1/settings` (`bird_bgp_source_ipv4`) — fallback для master / если у спикера не задано.
+
+## Drift и dispatch
+
+- `published_revision_id` vs `last_applied_revision_id` — в UI и `evobgp-deploy`.
+- Job `deploy_apply` meta: `node_dispatch.results[]` — статус wake-up per speaker.
+- Canary: `POST /v1/speakers/{id}/apply` с `revision_id`.
+
+## Troubleshooting
+
+| Симптом | Проверка |
+|---------|----------|
+| Offline в UI | `GET https://AGENT_DOMAIN/v1/agent/health` с CP; LE cert; whitelist |
+| dispatch error | CP logs job meta; firewall 443; `agent_secret` |
+| verify-bundle fail | pubkey совпадает с CP seed; пересоберите pubkey после смены seed |
+| BGP не поднимается | bird2 `network_mode: host`; peers; MD5 BGP отдельно от HTTP sync |
+
+## Ограничения (scale-review)
+
+- Peers **не** фильтруются по `speaker_id` — один tenant-wide peers fragment на все реплики.
+- Разные peer-наборы per site — отдельная итерация pipeline.
+- Если Panel не достучится до agent — включите profile `fallback` (polling).
+
+## Связанные env
+
+| Переменная | Где |
+|------------|-----|
+| `EVOBGP_NODE_DISPATCH_ENABLED=1` | CP |
+| `EVOBGP_AGENT_SECRET` | реплика |
+| `EVOBGP_NODE_TOKEN` | реплика |
+| `EVOBGP_BUNDLE_PUBKEY_BASE64` | реплика |
+| `PANEL_IP_WHITELIST` | Traefik на реплике |

internal/agentserver/server.go

@@ -0,0 +1,192 @@
+package agentserver
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"log"
+	"net/http"
+	"os"
+	"strings"
+	"time"
+
+	"evobgp/internal/nodecli"
+)
+
+// Config holds evobgp-agent serve settings.
+type Config struct {
+	Listen          string
+	Secret          string
+	ControlPlaneURL string
+	NodeToken       string
+	SpeakerID       string
+	PubKeyB64       string
+	PubKeyHex       string
+	ExtractDir      string
+	BirdBin         string
+	BirdcBin        string
+	Socket          string
+	SyncTimeout     time.Duration
+	LastSync        func() (revisionID string, at time.Time)
+	OnSyncSuccess   func(revisionID string)
+}
+
+// Server serves Panel→Node internal API (Remnawave-style wake-up).
+type Server struct {
+	cfg Config
+	mux *http.ServeMux
+}
+
+// New builds an agent HTTP server.
+func New(cfg Config) *Server {
+	s := &Server{cfg: cfg, mux: http.NewServeMux()}
+	s.mux.HandleFunc("GET /v1/agent/health", s.handleHealth)
+	s.mux.HandleFunc("POST /v1/agent/sync", s.handleSync)
+	return s
+}
+
+// Handler returns the root HTTP handler.
+func (s *Server) Handler() http.Handler {
+	return s.mux
+}
+
+func (s *Server) handleHealth(w http.ResponseWriter, r *http.Request) {
+	if !s.authorize(r) {
+		writeProblem(w, http.StatusUnauthorized, "missing or invalid Authorization")
+		return
+	}
+	body := map[string]any{
+		"ok":         true,
+		"speaker_id": strings.TrimSpace(s.cfg.SpeakerID),
+	}
+	if s.cfg.LastSync != nil {
+		if rev, at := s.cfg.LastSync(); rev != "" {
+			body["last_applied_revision_id"] = rev
+			body["last_sync_at"] = at.UTC().Format(time.RFC3339Nano)
+		}
+	}
+	writeJSON(w, http.StatusOK, body)
+}
+
+func (s *Server) handleSync(w http.ResponseWriter, r *http.Request) {
+	if !s.authorize(r) {
+		writeProblem(w, http.StatusUnauthorized, "missing or invalid Authorization")
+		return
+	}
+	var req struct {
+		RevisionID string `json:"revision_id"`
+	}
+	_ = json.NewDecoder(r.Body).Decode(&req)
+
+	timeout := s.cfg.SyncTimeout
+	if timeout <= 0 {
+		timeout = 45 * time.Second
+	}
+	ctx, cancel := context.WithTimeout(r.Context(), timeout)
+	defer cancel()
+
+	res, err := nodecli.SyncBundle(ctx, nodecli.SyncConfig{
+		BaseURL:    s.cfg.ControlPlaneURL,
+		Token:      s.cfg.NodeToken,
+		SpeakerID:  s.cfg.SpeakerID,
+		RevisionID: strings.TrimSpace(req.RevisionID),
+		PubKeyB64:  s.cfg.PubKeyB64,
+		PubKeyHex:  s.cfg.PubKeyHex,
+		ExtractDir: s.cfg.ExtractDir,
+		BirdBin:    s.cfg.BirdBin,
+		BirdcBin:   s.cfg.BirdcBin,
+		Socket:     s.cfg.Socket,
+		Timeout:    timeout,
+	})
+	if err != nil {
+		log.Printf("agentserver: sync: %v", err)
+		writeProblem(w, http.StatusBadGateway, err.Error())
+		return
+	}
+	if s.cfg.OnSyncSuccess != nil {
+		s.cfg.OnSyncSuccess(res.RevisionID)
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"ok":                  true,
+		"applied_revision_id": res.RevisionID,
+		"main_config":         res.MainConfig,
+	})
+}
+
+func (s *Server) authorize(r *http.Request) bool {
+	secret := strings.TrimSpace(s.cfg.Secret)
+	if secret == "" {
+		return false
+	}
+	h := r.Header.Get("Authorization")
+	const prefix = "Bearer "
+	if !strings.HasPrefix(h, prefix) {
+		return false
+	}
+	return strings.TrimSpace(h[len(prefix):]) == secret
+}
+
+func writeJSON(w http.ResponseWriter, status int, v any) {
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(v)
+}
+
+func writeProblem(w http.ResponseWriter, status int, detail string) {
+	w.Header().Set("Content-Type", "application/problem+json")
+	w.WriteHeader(status)
+	_ = json.NewEncoder(w).Encode(map[string]any{
+		"title":  http.StatusText(status),
+		"status": status,
+		"detail": detail,
+	})
+}
+
+// ListenAndServe starts the agent HTTP server on cfg.Listen.
+func ListenAndServe(cfg Config) error {
+	if strings.TrimSpace(cfg.Listen) == "" {
+		cfg.Listen = ":8443"
+	}
+	srv := &http.Server{
+		Addr:              cfg.Listen,
+		Handler:           New(cfg).Handler(),
+		ReadHeaderTimeout: 10 * time.Second,
+	}
+	log.Printf("evobgp-agent serve: listening on %s speaker=%s", cfg.Listen, cfg.SpeakerID)
+	return srv.ListenAndServe()
+}
+
+// ConfigFromEnv builds Config from EVOBGP_* environment variables.
+func ConfigFromEnv() (Config, error) {
+	cfg := Config{
+		Listen:          envOr("EVOBGP_AGENT_LISTEN", ":8443"),
+		Secret:          strings.TrimSpace(os.Getenv("EVOBGP_AGENT_SECRET")),
+		ControlPlaneURL: strings.TrimSpace(os.Getenv("EVOBGP_CONTROL_PLANE_URL")),
+		NodeToken:       strings.TrimSpace(os.Getenv("EVOBGP_NODE_TOKEN")),
+		SpeakerID:       strings.TrimSpace(os.Getenv("EVOBGP_SPEAKER_ID")),
+		PubKeyB64:       strings.TrimSpace(os.Getenv("EVOBGP_BUNDLE_PUBKEY_BASE64")),
+		PubKeyHex:       strings.TrimSpace(os.Getenv("EVOBGP_BUNDLE_PUBKEY_HEX")),
+		ExtractDir:      envOr("EVOBGP_BIRD_EXTRACT_DIR", "/etc/bird"),
+		BirdBin:         strings.TrimSpace(os.Getenv("EVOBGP_BIRD_BIN")),
+		BirdcBin:        strings.TrimSpace(os.Getenv("EVOBGP_BIRDC_BIN")),
+		Socket:          strings.TrimSpace(os.Getenv("EVOBGP_BIRDC_SOCKET")),
+		SyncTimeout:     45 * time.Second,
+	}
+	if cfg.Secret == "" {
+		return cfg, fmt.Errorf("agentserver: EVOBGP_AGENT_SECRET required")
+	}
+	if cfg.ControlPlaneURL == "" || cfg.NodeToken == "" || cfg.SpeakerID == "" {
+		return cfg, fmt.Errorf("agentserver: EVOBGP_CONTROL_PLANE_URL, EVOBGP_NODE_TOKEN, EVOBGP_SPEAKER_ID required")
+	}
+	if cfg.PubKeyB64 == "" && cfg.PubKeyHex == "" {
+		return cfg, fmt.Errorf("agentserver: EVOBGP_BUNDLE_PUBKEY_BASE64 or EVOBGP_BUNDLE_PUBKEY_HEX required")
+	}
+	return cfg, nil
+}
+
+func envOr(key, def string) string {
+	if v := strings.TrimSpace(os.Getenv(key)); v != "" {
+		return v
+	}
+	return def
+}

internal/agentserver/server_test.go

@@ -0,0 +1,63 @@
+package agentserver_test
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+
+	"evobgp/internal/agentserver"
+)
+
+func TestAgentHealth_requiresAuth(t *testing.T) {
+	t.Parallel()
+	srv := httptest.NewServer(agentserver.New(agentserver.Config{
+		Secret:    "test-secret",
+		SpeakerID: "sp-1",
+	}).Handler())
+	defer srv.Close()
+
+	resp, err := http.Get(srv.URL + "/v1/agent/health")
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode != http.StatusUnauthorized {
+		t.Fatalf("want 401, got %d", resp.StatusCode)
+	}
+
+	req, _ := http.NewRequest(http.MethodGet, srv.URL+"/v1/agent/health", nil)
+	req.Header.Set("Authorization", "Bearer test-secret")
+	resp2, err := http.DefaultClient.Do(req)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = resp2.Body.Close() }()
+	if resp2.StatusCode != http.StatusOK {
+		t.Fatalf("want 200, got %d", resp2.StatusCode)
+	}
+}
+
+func TestAgentSync_badAuth(t *testing.T) {
+	t.Parallel()
+	srv := httptest.NewServer(agentserver.New(agentserver.Config{
+		Secret:          "right",
+		SpeakerID:       "sp-1",
+		ControlPlaneURL: "http://127.0.0.1:1",
+		NodeToken:       "tok",
+		PubKeyB64:       "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
+		ExtractDir:      t.TempDir(),
+	}).Handler())
+	defer srv.Close()
+
+	req, _ := http.NewRequest(http.MethodPost, srv.URL+"/v1/agent/sync", strings.NewReader("{}"))
+	req.Header.Set("Authorization", "Bearer wrong")
+	resp, err := http.DefaultClient.Do(req)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode != http.StatusUnauthorized {
+		t.Fatalf("want 401, got %d", resp.StatusCode)
+	}
+}

internal/authkey/token.go

@@ -0,0 +1,34 @@
+// Package authkey generates API tokens and derives lookup hashes (no persistence).
+package authkey
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"encoding/base64"
+	"fmt"
+)
+
+const tokenPrefix = "evobgp_"
+
+// GenerateToken returns a new bearer token (evobgp_ + 32 random bytes, base64url).
+func GenerateToken() (string, error) {
+	b := make([]byte, 32)
+	if _, err := rand.Read(b); err != nil {
+		return "", fmt.Errorf("authkey: generate token: %w", err)
+	}
+	return tokenPrefix + base64.RawURLEncoding.EncodeToString(b), nil
+}
+
+// HashToken returns SHA-256 of the full token (32 bytes).
+func HashToken(token string) []byte {
+	sum := sha256.Sum256([]byte(token))
+	return sum[:]
+}
+
+// Prefix returns the first 8 characters of the token for display.
+func Prefix(token string) string {
+	if len(token) <= 8 {
+		return token
+	}
+	return token[:8]
+}

internal/httpapi/api_key_resolver.go

@@ -0,0 +1,66 @@
+package httpapi
+
+import (
+	"crypto/sha256"
+	"encoding/hex"
+	"sync"
+
+	"evobgp/internal/store"
+)
+
+type apiKeyResolver struct {
+	mu sync.RWMutex
+
+	envByToken map[string]apiKeyRecord
+	byHash     map[string]apiKeyRecord
+}
+
+func newAPIKeyResolver(envSpec string, st store.Backend) (*apiKeyResolver, error) {
+	r := &apiKeyResolver{
+		envByToken: make(map[string]apiKeyRecord),
+		byHash:     make(map[string]apiKeyRecord),
+	}
+	for _, rec := range parseAPIKeysSpec(envSpec) {
+		r.envByToken[rec.token] = rec
+	}
+	return r, r.reloadFromStore(st)
+}
+
+func (r *apiKeyResolver) reloadFromStore(st store.Backend) error {
+	rows, err := st.ListActiveAPIKeyHashes()
+	if err != nil {
+		return err
+	}
+	byHash := make(map[string]apiKeyRecord, len(rows))
+	for _, row := range rows {
+		if len(row.TokenHash) != 32 {
+			continue
+		}
+		byHash[hex.EncodeToString(row.TokenHash)] = apiKeyRecord{
+			token:    "",
+			tenantID: row.TenantID,
+			role:     row.Role,
+			keyID:    row.ID,
+		}
+	}
+	r.mu.Lock()
+	r.byHash = byHash
+	r.mu.Unlock()
+	return nil
+}
+
+func (r *apiKeyResolver) Reload(st store.Backend) error {
+	return r.reloadFromStore(st)
+}
+
+func (r *apiKeyResolver) Lookup(raw string) (apiKeyRecord, bool) {
+	r.mu.RLock()
+	defer r.mu.RUnlock()
+	if rec, ok := r.envByToken[raw]; ok {
+		return rec, true
+	}
+	sum := sha256.Sum256([]byte(raw))
+	key := hex.EncodeToString(sum[:])
+	rec, ok := r.byHash[key]
+	return rec, ok
+}

internal/httpapi/auth.go

@@ -15,6 +15,7 @@ type Auth struct {
 	TenantID string
 	Role     string // viewer, editor, operator, node
 	Token    string
+	APIKeyID string // non-empty for DB-managed keys
 }
 
 func authFromContext(ctx context.Context) (Auth, bool) {
@@ -26,6 +27,7 @@ type apiKeyRecord struct {
 	token    string
 	tenantID string
 	role     string
+	keyID    string // set for DB-managed keys (last_used_at)
 }
 
 func parseAPIKeysSpec(spec string) []apiKeyRecord {
@@ -54,20 +56,6 @@ func parseAPIKeysSpec(spec string) []apiKeyRecord {
 
 func (s *Server) authMiddleware(next http.Handler) http.Handler {
 	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
-		if s.insecureDev {
-			h := r.Header.Get("Authorization")
-			const p = "Bearer "
-			if strings.HasPrefix(h, p) {
-				tok := strings.TrimSpace(strings.TrimPrefix(h, p))
-				if tok == "dev" {
-					if a, ok := s.devAuth(); ok {
-						r = r.WithContext(context.WithValue(r.Context(), authCtxKey, a))
-						next.ServeHTTP(w, r)
-						return
-					}
-				}
-			}
-		}
 		h := r.Header.Get("Authorization")
 		const p = "Bearer "
 		if !strings.HasPrefix(h, p) {
@@ -75,18 +63,22 @@ func (s *Server) authMiddleware(next http.Handler) http.Handler {
 			return
 		}
 		raw := strings.TrimSpace(strings.TrimPrefix(h, p))
-		var matched *apiKeyRecord
+		if raw == "dev" {
-		for i := range s.apiKeys {
+			if a, ok := s.devAuth(); ok {
-			if s.apiKeys[i].token == raw {
+				r = r.WithContext(context.WithValue(r.Context(), authCtxKey, a))
-				matched = &s.apiKeys[i]
+				next.ServeHTTP(w, r)
-				break
+				return
 			}
 		}
-		if matched == nil {
+		matched, ok := s.keyResolver.Lookup(raw)
+		if !ok {
 			writeProblem(w, http.StatusUnauthorized, "Unauthorized", "unknown api key")
 			return
 		}
-		a := Auth{TenantID: matched.tenantID, Role: matched.role, Token: raw}
+		a := Auth{TenantID: matched.tenantID, Role: matched.role, Token: raw, APIKeyID: matched.keyID}
+		if matched.keyID != "" {
+			go func(id string) { _ = s.store.TouchAPIKeyLastUsed(id) }(matched.keyID)
+		}
 		r = r.WithContext(context.WithValue(r.Context(), authCtxKey, a))
 		next.ServeHTTP(w, r)
 	})

internal/httpapi/routes.go

@@ -55,6 +55,7 @@ func (s *Server) registerV1(m *http.ServeMux) {
 	m.HandleFunc("GET /modules/{module_id}", s.handleGetModule)
 	m.HandleFunc("GET /peers", s.handleListPeers)
 	m.HandleFunc("GET /speakers", s.handleListSpeakers)
+	m.HandleFunc("GET /bundle/signing-public-key", s.handleBundleSigningPublicKey)
 	m.HandleFunc("POST /modules/{module_id}/refresh", s.handleModuleRefresh)
 	m.HandleFunc("POST /tenant/refresh", s.handleTenantRefresh)
 	m.HandleFunc("GET /revisions", s.handleListRevisions)
@@ -167,17 +168,7 @@ func peerJSON(p *store.BGPPeer) map[string]any {
 }
 
 func speakerJSON(sp *store.Speaker) map[string]any {
-	m := map[string]any{
+	return speakerJSONFromStore(nil, sp)
-		"id":       sp.ID,
-		"role":     sp.Role,
-		"endpoint": sp.Endpoint,
-	}
-	if sp.LastAppliedRevisionID != nil {
-		m["last_applied_revision_id"] = *sp.LastAppliedRevisionID
-	} else {
-		m["last_applied_revision_id"] = nil
-	}
-	return m
 }
 
 func (s *Server) handleListModules(w http.ResponseWriter, r *http.Request) {
@@ -399,7 +390,7 @@ func (s *Server) handleListSpeakers(w http.ResponseWriter, r *http.Request) {
 	speakers := s.store.ListSpeakersForTenant(a.TenantID)
 	items := make([]map[string]any, 0, len(speakers))
 	for _, sp := range speakers {
-		items = append(items, speakerJSON(sp))
+		items = append(items, speakerJSONFromStore(s.store, sp))
 	}
 	writeJSON(w, http.StatusOK, map[string]any{
 		"items": items, "next_cursor": nil, "has_more": false,
@@ -985,7 +976,11 @@ func (s *Server) handleNodeBundle(w http.ResponseWriter, r *http.Request) {
 		writeProblem(w, http.StatusNotFound, "Not Found", "revision not found")
 		return
 	}
-	tgz, err := bundle.BuildGzippedTar(rid, sid, rev.PreviewFragments, s.bundlePriv)
+	frags := rev.PreviewFragments
+	if overlaid, err := pipeline.OverlayFragmentsForSpeaker(s.store, a.TenantID, sid, rid, frags); err == nil {
+		frags = overlaid
+	}
+	tgz, err := bundle.BuildGzippedTar(rid, sid, frags, s.bundlePriv)
 	if err != nil {
 		writeInternalError(w, "internal", err)
 		return

internal/httpapi/routes_api_keys.go

@@ -0,0 +1,217 @@
+package httpapi
+
+import (
+	"encoding/json"
+	"net/http"
+	"strings"
+	"time"
+
+	"evobgp/internal/store"
+)
+
+func (s *Server) registerAPIKeyRoutes(m *http.ServeMux) {
+	m.HandleFunc("GET /auth/session", s.handleAuthSession)
+	m.HandleFunc("GET /api-keys", s.handleListAPIKeys)
+	m.HandleFunc("POST /api-keys", s.handlePostAPIKey)
+	m.HandleFunc("GET /api-keys/{id}", s.handleGetAPIKey)
+	m.HandleFunc("PATCH /api-keys/{id}", s.handlePatchAPIKey)
+	m.HandleFunc("DELETE /api-keys/{id}", s.handleDeleteAPIKey)
+	m.HandleFunc("POST /api-keys/{id}/rotate", s.handleRotateAPIKey)
+}
+
+func (s *Server) handleAuthSession(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "viewer") {
+		return
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"tenant_id": a.TenantID,
+		"role":      a.Role,
+	})
+}
+
+func apiKeyJSON(k *store.APIKey) map[string]any {
+	m := map[string]any{
+		"id":         k.ID,
+		"name":       k.Name,
+		"role":       k.Role,
+		"prefix":     k.Prefix,
+		"created_at": k.CreatedAt.UTC().Format(time.RFC3339),
+		"updated_at": k.UpdatedAt.UTC().Format(time.RFC3339),
+	}
+	if k.ExpiresAt != nil {
+		m["expires_at"] = k.ExpiresAt.UTC().Format(time.RFC3339)
+	} else {
+		m["expires_at"] = nil
+	}
+	if k.RevokedAt != nil {
+		m["revoked_at"] = k.RevokedAt.UTC().Format(time.RFC3339)
+	} else {
+		m["revoked_at"] = nil
+	}
+	if k.LastUsedAt != nil {
+		m["last_used_at"] = k.LastUsedAt.UTC().Format(time.RFC3339)
+	} else {
+		m["last_used_at"] = nil
+	}
+	return m
+}
+
+func (s *Server) handleListAPIKeys(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	list, err := s.store.ListAPIKeys(a.TenantID)
+	if err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	writePaginatedListJSON(w, r, list, func(k *store.APIKey) map[string]any {
+		return apiKeyJSON(k)
+	})
+}
+
+func (s *Server) handleGetAPIKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	k, err := s.store.GetAPIKey(a.TenantID, r.PathValue("id"))
+	if err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	writeJSON(w, http.StatusOK, apiKeyJSON(k))
+}
+
+func (s *Server) handlePostAPIKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	var body struct {
+		Name      string  `json:"name"`
+		Role      string  `json:"role"`
+		ExpiresAt *string `json:"expires_at"`
+	}
+	if err := json.NewDecoder(r.Body).Decode(&body); err != nil {
+		writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid json")
+		return
+	}
+	in := &store.APIKeyCreate{
+		Name: strings.TrimSpace(body.Name),
+		Role: strings.TrimSpace(body.Role),
+	}
+	if body.ExpiresAt != nil && strings.TrimSpace(*body.ExpiresAt) != "" {
+		t, err := time.Parse(time.RFC3339, strings.TrimSpace(*body.ExpiresAt))
+		if err != nil {
+			writeProblem(w, http.StatusUnprocessableEntity, "Unprocessable Entity", "invalid expires_at")
+			return
+		}
+		in.ExpiresAt = &t
+	}
+	created, err := s.store.CreateAPIKey(a.TenantID, in)
+	if err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	if err := s.keyResolver.Reload(s.store); err != nil {
+		writeProblem(w, http.StatusInternalServerError, "Internal Server Error", "failed to reload api keys")
+		return
+	}
+	out := apiKeyJSON(&created.APIKey)
+	out["token"] = created.Token
+	writeJSON(w, http.StatusCreated, out)
+}
+
+func (s *Server) handlePatchAPIKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	var raw map[string]json.RawMessage
+	if err := json.NewDecoder(r.Body).Decode(&raw); err != nil {
+		writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid json")
+		return
+	}
+	patch := &store.APIKeyPatch{}
+	if v, ok := raw["name"]; ok {
+		var name string
+		if err := json.Unmarshal(v, &name); err != nil {
+			writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid name")
+			return
+		}
+		patch.Name = &name
+	}
+	if v, ok := raw["role"]; ok {
+		var role string
+		if err := json.Unmarshal(v, &role); err != nil {
+			writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid role")
+			return
+		}
+		patch.Role = &role
+	}
+	if v, ok := raw["expires_at"]; ok {
+		if string(v) == "null" {
+			patch.ClearExpiresAt = true
+		} else {
+			var s string
+			if err := json.Unmarshal(v, &s); err != nil {
+				writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid expires_at")
+				return
+			}
+			t, err := time.Parse(time.RFC3339, strings.TrimSpace(s))
+			if err != nil {
+				writeProblem(w, http.StatusUnprocessableEntity, "Unprocessable Entity", "invalid expires_at")
+				return
+			}
+			patch.ExpiresAt = &t
+		}
+	}
+	k, err := s.store.UpdateAPIKey(a.TenantID, r.PathValue("id"), patch)
+	if err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	if err := s.keyResolver.Reload(s.store); err != nil {
+		writeProblem(w, http.StatusInternalServerError, "Internal Server Error", "failed to reload api keys")
+		return
+	}
+	writeJSON(w, http.StatusOK, apiKeyJSON(k))
+}
+
+func (s *Server) handleDeleteAPIKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	if err := s.store.RevokeAPIKey(a.TenantID, r.PathValue("id")); err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	if err := s.keyResolver.Reload(s.store); err != nil {
+		writeProblem(w, http.StatusInternalServerError, "Internal Server Error", "failed to reload api keys")
+		return
+	}
+	w.WriteHeader(http.StatusNoContent)
+}
+
+func (s *Server) handleRotateAPIKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "operator") {
+		return
+	}
+	rotated, err := s.store.RotateAPIKey(a.TenantID, r.PathValue("id"))
+	if err != nil {
+		writeStoreErr(w, err)
+		return
+	}
+	if err := s.keyResolver.Reload(s.store); err != nil {
+		writeProblem(w, http.StatusInternalServerError, "Internal Server Error", "failed to reload api keys")
+		return
+	}
+	out := apiKeyJSON(&rotated.APIKey)
+	out["token"] = rotated.Token
+	writeJSON(w, http.StatusOK, out)
+}

internal/httpapi/routes_api_keys_test.go

@@ -0,0 +1,119 @@
+package httpapi
+
+import (
+	"encoding/json"
+	"io"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+)
+
+func TestBearerDevWithoutInsecureDev(t *testing.T) {
+	srv, err := New(Options{SeedDemo: true, BundleSeedHex: testBundleSeed})
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer srv.Close()
+
+	ts := httptest.NewServer(srv.Handler())
+	defer ts.Close()
+
+	req, _ := http.NewRequest(http.MethodGet, ts.URL+"/v1/modules?limit=1", nil)
+	req.Header.Set("Authorization", "Bearer dev")
+	resp, err := ts.Client().Do(req)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode != http.StatusOK {
+		b, _ := io.ReadAll(resp.Body)
+		t.Fatalf("status=%d body=%s", resp.StatusCode, b)
+	}
+}
+
+func TestAPIKeysCRUDAndAuth(t *testing.T) {
+	srv, err := New(Options{SeedDemo: true, BundleSeedHex: testBundleSeed})
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer srv.Close()
+	tenant, _, _, _, _ := srv.Store().DemoIDs()
+	mustSetTestAPIKeys(t, srv, "opkey|"+tenant+"|operator")
+
+	ts := httptest.NewServer(srv.Handler())
+	defer ts.Close()
+	client := ts.Client()
+	base := ts.URL
+
+	reqCreate, _ := http.NewRequest(http.MethodPost, base+"/v1/api-keys", strings.NewReader(`{"name":"ci","role":"editor"}`))
+	reqCreate.Header.Set("Authorization", "Bearer opkey")
+	reqCreate.Header.Set("Content-Type", "application/json")
+	respCreate, err := client.Do(reqCreate)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = respCreate.Body.Close() }()
+	if respCreate.StatusCode != http.StatusCreated {
+		b, _ := io.ReadAll(respCreate.Body)
+		t.Fatalf("create status=%d body=%s", respCreate.StatusCode, b)
+	}
+	var created map[string]any
+	if err := json.NewDecoder(respCreate.Body).Decode(&created); err != nil {
+		t.Fatal(err)
+	}
+	token, _ := created["token"].(string)
+	if token == "" {
+		t.Fatal("missing token in create response")
+	}
+	id, _ := created["id"].(string)
+	if id == "" {
+		t.Fatal("missing id")
+	}
+
+	reqMod, _ := http.NewRequest(http.MethodGet, base+"/v1/modules?limit=1", nil)
+	reqMod.Header.Set("Authorization", "Bearer "+token)
+	respMod, err := client.Do(reqMod)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = respMod.Body.Close() }()
+	if respMod.StatusCode != http.StatusOK {
+		b, _ := io.ReadAll(respMod.Body)
+		t.Fatalf("modules status=%d body=%s", respMod.StatusCode, b)
+	}
+
+	reqDel, _ := http.NewRequest(http.MethodDelete, base+"/v1/api-keys/"+id, nil)
+	reqDel.Header.Set("Authorization", "Bearer opkey")
+	respDel, err := client.Do(reqDel)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = respDel.Body.Close() }()
+	if respDel.StatusCode != http.StatusNoContent {
+		t.Fatalf("delete status=%d", respDel.StatusCode)
+	}
+
+	reqAfter, _ := http.NewRequest(http.MethodGet, base+"/v1/modules?limit=1", nil)
+	reqAfter.Header.Set("Authorization", "Bearer "+token)
+	respAfter, err := client.Do(reqAfter)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = respAfter.Body.Close() }()
+	if respAfter.StatusCode != http.StatusUnauthorized {
+		t.Fatalf("expected 401 after revoke, got %d", respAfter.StatusCode)
+	}
+
+	mustSetTestAPIKeys(t, srv, "nodekey|"+tenant+"|node,opkey|"+tenant+"|operator")
+	reqNode2, _ := http.NewRequest(http.MethodGet, base+"/v1/api-keys", nil)
+	reqNode2.Header.Set("Authorization", "Bearer nodekey")
+	respNode, err := client.Do(reqNode2)
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer func() { _ = respNode.Body.Close() }()
+	if respNode.StatusCode != http.StatusForbidden {
+		t.Fatalf("node list api-keys status=%d want 403", respNode.StatusCode)
+	}
+}

internal/httpapi/routes_crud.go

@@ -70,6 +70,8 @@ func (s *Server) registerCRUDRoutes(m *http.ServeMux) {
 
 	m.HandleFunc("GET /settings", s.handleGetSettings)
 	m.HandleFunc("PATCH /settings", s.handlePatchSettings)
+
+	s.registerAPIKeyRoutes(m)
 }
 
 func (s *Server) handlePostModule(w http.ResponseWriter, r *http.Request) {
@@ -972,12 +974,20 @@ func (s *Server) handlePostSpeaker(w http.ResponseWriter, r *http.Request) {
 		writeProblem(w, http.StatusBadRequest, "Bad Request", "invalid json")
 		return
 	}
+	if err := normalizeSpeakerCreate(&body); err != nil {
+		writeStoreErr(w, err)
+		return
+	}
 	x, err := s.store.CreateSpeaker(a.TenantID, &body)
 	if err != nil {
 		writeStoreErr(w, err)
 		return
 	}
-	writeJSON(w, http.StatusCreated, speakerJSON(x))
+	resp := speakerJSONFromStore(s.store, x)
+	if meta := store.ParseSpeakerMeta(x.MetaJSON); meta.AgentSecret != "" {
+		resp["agent_secret"] = meta.AgentSecret
+	}
+	writeJSON(w, http.StatusCreated, resp)
 }
 
 func (s *Server) handleGetSpeakerByID(w http.ResponseWriter, r *http.Request) {
@@ -990,7 +1000,7 @@ func (s *Server) handleGetSpeakerByID(w http.ResponseWriter, r *http.Request) {
 		writeStoreErr(w, err)
 		return
 	}
-	writeJSON(w, http.StatusOK, speakerJSON(x))
+	writeJSON(w, http.StatusOK, speakerJSONFromStore(s.store, x))
 }
 
 func (s *Server) handlePatchSpeaker(w http.ResponseWriter, r *http.Request) {
@@ -1008,7 +1018,7 @@ func (s *Server) handlePatchSpeaker(w http.ResponseWriter, r *http.Request) {
 		writeStoreErr(w, err)
 		return
 	}
-	writeJSON(w, http.StatusOK, speakerJSON(x))
+	writeJSON(w, http.StatusOK, speakerJSONFromStore(s.store, x))
 }
 
 func (s *Server) handleRevisionPrefixes(w http.ResponseWriter, r *http.Request) {

internal/httpapi/routes_crud_csv_test.go

@@ -21,7 +21,7 @@ func TestModuleEntriesCSVImportExportIPRanges(t *testing.T) {
 	defer srv.Close()
 
 	tenant, _, modIP, _, _ := srv.Store().DemoIDs()
-	srv.apiKeys = parseAPIKeysSpec("opkey|" + tenant + "|operator")
+	mustSetTestAPIKeys(t, srv, "opkey|"+tenant+"|operator")
 
 	ts := httptest.NewServer(srv.Handler())
 	defer ts.Close()

internal/httpapi/routes_crud_list_test.go

@@ -17,7 +17,7 @@ func TestNestedModuleListPagination(t *testing.T) {
 	}
 	defer srv.Close()
 	tenant, _, modIP, _, _ := srv.Store().DemoIDs()
-	srv.apiKeys = parseAPIKeysSpec("edkey|" + tenant + "|editor")
+	mustSetTestAPIKeys(t, srv, "edkey|"+tenant+"|editor")
 
 	ts := httptest.NewServer(srv.Handler())
 	defer ts.Close()

internal/httpapi/server.go

@@ -21,8 +21,7 @@ type Server struct {
 	pgPool      *pgxpool.Pool
 	jobs        *jobs.Registry
 	bundlePriv  ed25519.PrivateKey
-	apiKeys     []apiKeyRecord
+	keyResolver *apiKeyResolver
-	insecureDev bool
 	corsOrigins []string
 	cdnHTTP     *http.Client
 	mux         *http.ServeMux
@@ -60,13 +59,16 @@ func New(opts Options) (*Server, error) {
 		_, priv, _ = ed25519.GenerateKey(rand.Reader)
 	}
 
+	resolver, err := newAPIKeyResolver(opts.APIKeys, backend)
+	if err != nil {
+		return nil, err
+	}
 	s := &Server{
 		store:       backend,
 		pgPool:      pool,
 		jobs:        reg,
 		bundlePriv:  priv,
-		apiKeys:     parseAPIKeysSpec(opts.APIKeys),
+		keyResolver: resolver,
-		insecureDev: opts.InsecureDev && opts.SeedDemo,
 		corsOrigins: parseCORSOrigins(opts.CORSAllowedOrigins),
 		cdnHTTP:     NewCDNHTTPClient(),
 	}

internal/httpapi/server_test.go

@@ -29,7 +29,7 @@ func TestAPIRefreshApplyJobsBundle(t *testing.T) {
 	}
 	defer srv.Close()
 	tenant, modCDN, modIP, rev, speaker := srv.Store().DemoIDs()
-	srv.apiKeys = parseAPIKeysSpec("nodekey|" + tenant + "|node,opkey|" + tenant + "|operator,edkey|" + tenant + "|editor")
+	mustSetTestAPIKeys(t, srv, "nodekey|"+tenant+"|node,opkey|"+tenant+"|operator,edkey|"+tenant+"|editor")
 
 	ts := httptest.NewServer(srv.Handler())
 	defer ts.Close()

internal/httpapi/speakers.go

@@ -0,0 +1,140 @@
+package httpapi
+
+import (
+	"crypto/rand"
+	"encoding/hex"
+	"encoding/json"
+	"net/http"
+	"strings"
+	"time"
+
+	"evobgp/internal/nodedispatch"
+	"evobgp/internal/store"
+)
+
+func speakerJSONFromStore(st store.Backend, sp *store.Speaker) map[string]any {
+	if sp == nil {
+		return map[string]any{}
+	}
+	meta := store.ParseSpeakerMeta(sp.MetaJSON)
+	m := map[string]any{
+		"id":       sp.ID,
+		"role":     sp.Role,
+		"endpoint": sp.Endpoint,
+	}
+	if sp.LastAppliedRevisionID != nil {
+		m["last_applied_revision_id"] = *sp.LastAppliedRevisionID
+	} else {
+		m["last_applied_revision_id"] = nil
+	}
+	if st != nil {
+		if rid, at, err := st.LatestPublishedRevision(sp.ID); err == nil && rid != "" {
+			m["published_revision_id"] = rid
+			m["published_at"] = at.UTC().Format(time.RFC3339Nano)
+		} else {
+			m["published_revision_id"] = nil
+			m["published_at"] = nil
+		}
+	}
+	if strings.TrimSpace(sp.MetaJSON) != "" && sp.MetaJSON != "{}" {
+		var raw map[string]any
+		if json.Unmarshal([]byte(sp.MetaJSON), &raw) == nil {
+			m["meta_json"] = raw
+		}
+	}
+	if meta.AgentDomain != "" {
+		m["agent_domain"] = meta.AgentDomain
+	}
+	if meta.NodeIPv4 != "" {
+		m["node_ipv4"] = meta.NodeIPv4
+	}
+	if meta.BirdBgpSourceIPv4 != "" {
+		m["bird_bgp_source_ipv4"] = meta.BirdBgpSourceIPv4
+	}
+	if meta.LastDispatchAt != "" {
+		m["last_dispatch_at"] = meta.LastDispatchAt
+	}
+	if meta.LastDispatchError != "" {
+		m["last_dispatch_error"] = meta.LastDispatchError
+	}
+	if meta.LastDispatchStatus != "" {
+		m["dispatch_status"] = meta.LastDispatchStatus
+	}
+	if meta.SyncStatus != "" {
+		m["sync_status"] = meta.SyncStatus
+	}
+	return m
+}
+
+func (s *Server) handleBundleSigningPublicKey(w http.ResponseWriter, r *http.Request) {
+	a, ok := authFromContext(r.Context())
+	if !ok || !s.requireAtLeast(w, a, "viewer") {
+		return
+	}
+	writeJSON(w, http.StatusOK, map[string]any{
+		"public_key_base64": s.BundlePublicKeyBase64(),
+	})
+}
+
+// normalizeSpeakerCreate fills meta defaults and validates replica fields.
+func normalizeSpeakerCreate(in *store.Speaker) error {
+	if in == nil {
+		return store.ErrInvalidInput
+	}
+	meta := store.ParseSpeakerMeta(in.MetaJSON)
+	if meta.AgentSecret == "" {
+		b := make([]byte, 24)
+		if _, err := rand.Read(b); err != nil {
+			return err
+		}
+		meta.AgentSecret = hex.EncodeToString(b)
+	}
+	if meta.AgentPort == 0 {
+		meta.AgentPort = 8443
+	}
+	if meta.NodeIPv4 == "" {
+		meta.NodeIPv4 = store.IPv4FromEndpoint(in.Endpoint)
+	}
+	if meta.BirdBgpSourceIPv4 == "" && meta.NodeIPv4 != "" {
+		meta.BirdBgpSourceIPv4 = meta.NodeIPv4
+	}
+	if meta.BirdBgpSourceIPv4 != "" && !store.ValidIPv4(meta.BirdBgpSourceIPv4) {
+		return store.ErrInvalidInput
+	}
+	if meta.AgentDomain == "" && in.Endpoint != "" {
+		ep := strings.TrimSpace(in.Endpoint)
+		if strings.HasPrefix(ep, "https://") {
+			u := strings.TrimPrefix(ep, "https://")
+			if idx := strings.Index(u, "/"); idx >= 0 {
+				u = u[:idx]
+			}
+			if idx := strings.Index(u, ":"); idx >= 0 {
+				u = u[:idx]
+			}
+			if u != "" && !store.ValidIPv4(u) {
+				meta.AgentDomain = u
+			}
+		}
+	}
+	in.MetaJSON = store.SpeakerMetaJSON(meta)
+	return nil
+}
+
+func (s *Server) recordSpeakerDispatch(tenantID string, sp *store.Speaker, res nodedispatch.Result) {
+	if s == nil || s.store == nil || sp == nil {
+		return
+	}
+	patch := store.SpeakerMeta{
+		LastDispatchAt:     time.Now().UTC().Format(time.RFC3339Nano),
+		LastDispatchStatus: res.Status,
+	}
+	if res.Error != "" {
+		patch.LastDispatchError = res.Error
+		patch.SyncStatus = "error"
+	} else if res.Status == "ok" {
+		patch.LastDispatchError = ""
+		patch.SyncStatus = "synced"
+	}
+	meta := store.MergeSpeakerMetaJSON(sp.MetaJSON, patch)
+	_, _ = s.store.UpdateSpeaker(tenantID, sp.ID, &store.SpeakerPatch{MetaJSON: &meta})
+}

internal/httpapi/speakers_test.go

@@ -0,0 +1,65 @@
+package httpapi
+
+import (
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+)
+
+func TestPostSpeaker_defaultsFromEndpointIP(t *testing.T) {
+	srv, err := New(Options{InsecureDev: true, SeedDemo: true, BundleSeedHex: testBundleSeed})
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer srv.Close()
+	tenant, _, _, _, _ := srv.Store().DemoIDs()
+	mustSetTestAPIKeys(t, srv, "edkey|"+tenant+"|editor")
+
+	body := `{"endpoint":"https://203.0.113.55:8443","role":"replica"}`
+	req := httptest.NewRequest(http.MethodPost, "/v1/speakers", strings.NewReader(body))
+	req.Header.Set("Authorization", "Bearer edkey")
+	req.Header.Set("Content-Type", "application/json")
+	rec := httptest.NewRecorder()
+	srv.Handler().ServeHTTP(rec, req)
+	if rec.Code != http.StatusCreated {
+		t.Fatalf("status %d body %s", rec.Code, rec.Body.String())
+	}
+	var out map[string]any
+	if err := json.Unmarshal(rec.Body.Bytes(), &out); err != nil {
+		t.Fatal(err)
+	}
+	if out["agent_secret"] == nil || out["agent_secret"] == "" {
+		t.Fatal("expected agent_secret on create")
+	}
+	if out["node_ipv4"] != "203.0.113.55" {
+		t.Fatalf("node_ipv4: %#v", out["node_ipv4"])
+	}
+	if out["bird_bgp_source_ipv4"] != "203.0.113.55" {
+		t.Fatalf("bird_bgp_source_ipv4: %#v", out["bird_bgp_source_ipv4"])
+	}
+}
+
+func TestGetBundleSigningPublicKey(t *testing.T) {
+	srv, err := New(Options{InsecureDev: true, SeedDemo: true, BundleSeedHex: testBundleSeed})
+	if err != nil {
+		t.Fatal(err)
+	}
+	defer srv.Close()
+	tenant, _, _, _, _ := srv.Store().DemoIDs()
+	mustSetTestAPIKeys(t, srv, "vwkey|"+tenant+"|viewer")
+
+	req := httptest.NewRequest(http.MethodGet, "/v1/bundle/signing-public-key", nil)
+	req.Header.Set("Authorization", "Bearer vwkey")
+	rec := httptest.NewRecorder()
+	srv.Handler().ServeHTTP(rec, req)
+	if rec.Code != http.StatusOK {
+		t.Fatalf("status %d body %s", rec.Code, rec.Body.String())
+	}
+	var out map[string]any
+	_ = json.Unmarshal(rec.Body.Bytes(), &out)
+	if out["public_key_base64"] == nil || out["public_key_base64"] == "" {
+		t.Fatalf("missing public_key_base64: %#v", out)
+	}
+}

internal/httpapi/test_helpers.go

@@ -0,0 +1,12 @@
+package httpapi
+
+import "testing"
+
+func mustSetTestAPIKeys(t *testing.T, srv *Server, spec string) {
+	t.Helper()
+	resolver, err := newAPIKeyResolver(spec, srv.store)
+	if err != nil {
+		t.Fatal(err)
+	}
+	srv.keyResolver = resolver
+}

internal/jobs/worker.go

@@ -13,6 +13,7 @@ import (
 
 	"evobgp/internal/birddeploy"
 	"evobgp/internal/birdfmt"
+	"evobgp/internal/nodedispatch"
 	"evobgp/internal/observability"
 	"evobgp/internal/pipeline"
 	"evobgp/internal/store"
@@ -408,6 +409,7 @@ func (w *Worker) runDeployApply(j *Job) {
 		}
 	}
 	applied := make([]string, 0, 8)
+	var dispatchResults []nodedispatch.Result
 	applyOne := func(speakerID string) error {
 		if err := w.Store.SetLastAppliedRevision(j.TenantID, speakerID, revID); err != nil {
 			return err
@@ -419,21 +421,60 @@ func (w *Worker) runDeployApply(j *Job) {
 		applied = append(applied, speakerID)
 		return nil
 	}
+	dispatchSpeaker := func(sp *store.Speaker) {
+		if !nodedispatch.Enabled() || sp == nil {
+			return
+		}
+		meta := store.ParseSpeakerMeta(sp.MetaJSON)
+		if !store.SpeakerNeedsRemoteDispatch(sp.Role, meta) {
+			return
+		}
+		ctx2, cancel := context.WithTimeout(ctx, 35*time.Second)
+		defer cancel()
+		res := nodedispatch.WakeSpeaker(ctx2, sp, nodedispatch.Options{RevisionID: revID})
+		dispatchResults = append(dispatchResults, res)
+		patch := store.SpeakerMeta{
+			LastDispatchAt:     time.Now().UTC().Format(time.RFC3339Nano),
+			LastDispatchStatus: res.Status,
+		}
+		if res.Error != "" {
+			patch.LastDispatchError = res.Error
+			patch.SyncStatus = "error"
+		} else if res.Status == "ok" {
+			patch.LastDispatchError = ""
+			patch.SyncStatus = "synced"
+		}
+		merged := store.MergeSpeakerMetaJSON(sp.MetaJSON, patch)
+		_, _ = w.Store.UpdateSpeaker(j.TenantID, sp.ID, &store.SpeakerPatch{MetaJSON: &merged})
+	}
 	if hasSpeaker && spk != "" {
 		if err := applyOne(spk); err != nil {
 			j.Fail(err.Error())
 			return
 		}
+		if sp, err := w.Store.GetSpeaker(j.TenantID, spk); err == nil {
+			dispatchSpeaker(sp)
+		}
+		if len(dispatchResults) > 0 {
+			j.mergeMeta(map[string]any{"node_dispatch": map[string]any{
+				"revision_id": revID,
+				"results":     dispatchResults,
+			}})
+		}
 		mergeBirdPostApplyMeta(j)
 		j.Succeed()
 		return
 	}
-	for _, sp := range w.Store.ListSpeakersForTenant(j.TenantID) {
+	speakers := w.Store.ListSpeakersForTenant(j.TenantID)
+	for _, sp := range speakers {
 		if err := applyOne(sp.ID); err != nil {
 			j.Fail(err.Error())
 			return
 		}
 	}
+	for _, sp := range speakers {
+		dispatchSpeaker(sp)
+	}
 	j.mergeMeta(map[string]any{
 		"apply_summary": map[string]any{
 			"revision_id":    revID,
@@ -442,6 +483,12 @@ func (w *Worker) runDeployApply(j *Job) {
 			"message":        fmt.Sprintf("Ревизия %s применена на %d спикерах", shortID(revID), len(applied)),
 		},
 	})
+	if len(dispatchResults) > 0 {
+		j.mergeMeta(map[string]any{"node_dispatch": map[string]any{
+			"revision_id": revID,
+			"results":     dispatchResults,
+		}})
+	}
 	mergeBirdPostApplyMeta(j)
 	j.Succeed()
 }

internal/nodecli/sync.go

@@ -0,0 +1,118 @@
+package nodecli
+
+import (
+	"context"
+	"crypto/ed25519"
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strings"
+	"time"
+
+	"evobgp/internal/birdfmt"
+	"evobgp/internal/bundle"
+	"evobgp/internal/signing"
+)
+
+// SyncConfig drives pull → verify → apply on a replica node.
+type SyncConfig struct {
+	BaseURL    string
+	Token      string
+	SpeakerID  string
+	RevisionID string // empty = latest published on CP
+	PubKeyB64  string
+	PubKeyHex  string
+	ExtractDir string
+	BundlePath string // temp file; default os.TempDir()/evobgp-bundle.tar.gz
+	BirdBin    string
+	BirdcBin   string
+	Socket     string
+	HTTPClient interface {
+		Do(req interface{}) (interface{}, error)
+	}
+	Timeout time.Duration
+}
+
+// SyncResult summarizes a successful sync.
+type SyncResult struct {
+	RevisionID string `json:"revision_id"`
+	MainConfig string `json:"main_config,omitempty"`
+}
+
+// SyncBundle pulls (if needed), verifies Ed25519 signature, extracts, parse-checks, and birdc configure.
+func SyncBundle(ctx context.Context, cfg SyncConfig) (SyncResult, error) {
+	if strings.TrimSpace(cfg.BaseURL) == "" || strings.TrimSpace(cfg.Token) == "" || strings.TrimSpace(cfg.SpeakerID) == "" {
+		return SyncResult{}, fmt.Errorf("nodecli: sync: base-url, token, speaker-id required")
+	}
+	if strings.TrimSpace(cfg.ExtractDir) == "" {
+		return SyncResult{}, fmt.Errorf("nodecli: sync: extract-dir required")
+	}
+	pub, err := loadPubKey(cfg.PubKeyB64, cfg.PubKeyHex)
+	if err != nil {
+		return SyncResult{}, fmt.Errorf("nodecli: sync: %w", err)
+	}
+	timeout := cfg.Timeout
+	if timeout <= 0 {
+		timeout = 30 * time.Second
+	}
+	rev := strings.TrimSpace(cfg.RevisionID)
+	if rev == "" {
+		var err error
+		rev, err = fetchLatestRevision(cfg.BaseURL, cfg.Token, cfg.SpeakerID)
+		if err != nil {
+			return SyncResult{}, err
+		}
+	}
+	raw, err := fetchBundle(cfg.BaseURL, cfg.Token, cfg.SpeakerID, rev)
+	if err != nil {
+		return SyncResult{}, err
+	}
+	bundlePath := strings.TrimSpace(cfg.BundlePath)
+	if bundlePath == "" {
+		bundlePath = filepath.Join(os.TempDir(), "evobgp-bundle.tar.gz")
+	}
+	if err := os.WriteFile(bundlePath, raw, 0o644); err != nil {
+		return SyncResult{}, err
+	}
+	v, err := signing.VerifyGzippedTar(raw, pub)
+	if err != nil {
+		return SyncResult{}, err
+	}
+	root := filepath.Clean(cfg.ExtractDir)
+	if err := os.MkdirAll(root, 0o755); err != nil {
+		return SyncResult{}, err
+	}
+	if err := bundle.WriteExtractedFiles(root, v); err != nil {
+		return SyncResult{}, err
+	}
+	mainRel := v.FindMainBirdConf()
+	if mainRel == "" {
+		return SyncResult{}, fmt.Errorf("nodecli: sync: bundle has no bird.conf in manifest")
+	}
+	mainPath := filepath.Join(root, filepath.FromSlash(strings.TrimPrefix(mainRel, "/")))
+	opCtx, cancel := context.WithTimeout(ctx, timeout)
+	defer cancel()
+	ctl := &birdfmt.BirdCtl{Bird: cfg.BirdBin, Birdc: cfg.BirdcBin, Socket: cfg.Socket}
+	if err := ctl.ParseCheck(opCtx, mainPath); err != nil {
+		return SyncResult{}, err
+	}
+	if err := ctl.Configure(opCtx); err != nil {
+		return SyncResult{}, err
+	}
+	return SyncResult{RevisionID: rev, MainConfig: mainPath}, nil
+}
+
+// SyncResultJSON encodes SyncResult for HTTP responses.
+func SyncResultJSON(r SyncResult) ([]byte, error) {
+	return json.Marshal(map[string]any{
+		"ok":                  true,
+		"applied_revision_id": r.RevisionID,
+		"main_config":         r.MainConfig,
+	})
+}
+
+// LoadPublicKey exports loadPubKey for other packages.
+func LoadPublicKey(pubB64, pubHex string) (ed25519.PublicKey, error) {
+	return loadPubKey(pubB64, pubHex)
+}

internal/nodedispatch/dispatch.go

@@ -0,0 +1,188 @@
+package nodedispatch
+
+import (
+	"bytes"
+	"context"
+	"crypto/tls"
+	"encoding/json"
+	"fmt"
+	"io"
+	"net/http"
+	"os"
+	"strings"
+	"time"
+
+	"evobgp/internal/store"
+)
+
+// Result is one speaker dispatch outcome for job meta.
+type Result struct {
+	SpeakerID         string `json:"speaker_id"`
+	Endpoint          string `json:"endpoint,omitempty"`
+	Status            string `json:"status"`
+	AppliedRevisionID string `json:"applied_revision_id,omitempty"`
+	Error             string `json:"error,omitempty"`
+}
+
+// Options configures Panel→Node HTTP dispatch.
+type Options struct {
+	HTTPClient  *http.Client
+	Timeout     time.Duration
+	MaxRetries  int
+	InsecureTLS bool
+	RevisionID  string
+}
+
+func (o Options) client() *http.Client {
+	if o.HTTPClient != nil {
+		return o.HTTPClient
+	}
+	timeout := o.Timeout
+	if timeout <= 0 {
+		timeout = 30 * time.Second
+	}
+	tr := http.DefaultTransport.(*http.Transport).Clone()
+	if o.InsecureTLS || strings.TrimSpace(os.Getenv("EVOBGP_NODE_DISPATCH_INSECURE_TLS")) == "1" {
+		tr.TLSClientConfig = &tls.Config{InsecureSkipVerify: true} //nolint:gosec // dev/lab only via env
+	}
+	return &http.Client{Timeout: timeout, Transport: tr}
+}
+
+func (o Options) retries() int {
+	if o.MaxRetries > 0 {
+		return o.MaxRetries
+	}
+	return 3
+}
+
+// Enabled reports whether remote dispatch is turned on (EVOBGP_NODE_DISPATCH_ENABLED=1).
+func Enabled() bool {
+	return strings.TrimSpace(os.Getenv("EVOBGP_NODE_DISPATCH_ENABLED")) == "1"
+}
+
+// WakeSpeaker POSTs /v1/agent/sync to a replica agent (HTTPS via Traefik).
+func WakeSpeaker(ctx context.Context, sp *store.Speaker, opts Options) Result {
+	res := Result{SpeakerID: sp.ID}
+	if sp == nil {
+		res.Status = "error"
+		res.Error = "nil speaker"
+		return res
+	}
+	meta := store.ParseSpeakerMeta(sp.MetaJSON)
+	url := store.AgentSyncURL(meta)
+	if url == "" {
+		res.Status = "skipped"
+		res.Error = "agent_domain or agent_secret not configured"
+		return res
+	}
+	res.Endpoint = url
+	secret := strings.TrimSpace(meta.AgentSecret)
+	if secret == "" {
+		res.Status = "skipped"
+		res.Error = "agent_secret missing"
+		return res
+	}
+
+	body := map[string]string{}
+	if rid := strings.TrimSpace(opts.RevisionID); rid != "" {
+		body["revision_id"] = rid
+	}
+	raw, _ := json.Marshal(body)
+
+	var lastErr error
+	client := opts.client()
+	for attempt := 0; attempt < opts.retries(); attempt++ {
+		if attempt > 0 {
+			select {
+			case <-ctx.Done():
+				res.Status = "error"
+				res.Error = ctx.Err().Error()
+				return res
+			case <-time.After(time.Duration(attempt) * 2 * time.Second):
+			}
+		}
+		req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewReader(raw))
+		if err != nil {
+			lastErr = err
+			continue
+		}
+		req.Header.Set("Authorization", "Bearer "+secret)
+		req.Header.Set("Content-Type", "application/json")
+		resp, err := client.Do(req)
+		if err != nil {
+			lastErr = err
+			continue
+		}
+		b, _ := io.ReadAll(resp.Body)
+		_ = resp.Body.Close()
+		if resp.StatusCode >= 200 && resp.StatusCode < 300 {
+			var out struct {
+				AppliedRevisionID string `json:"applied_revision_id"`
+			}
+			_ = json.Unmarshal(b, &out)
+			res.Status = "ok"
+			res.AppliedRevisionID = strings.TrimSpace(out.AppliedRevisionID)
+			if res.AppliedRevisionID == "" {
+				res.AppliedRevisionID = strings.TrimSpace(opts.RevisionID)
+			}
+			return res
+		}
+		lastErr = fmt.Errorf("HTTP %d: %s", resp.StatusCode, strings.TrimSpace(string(b)))
+	}
+	res.Status = "error"
+	if lastErr != nil {
+		res.Error = lastErr.Error()
+	}
+	return res
+}
+
+// WakeReplicas dispatches sync to all tenant speakers that need remote wake-up.
+func WakeReplicas(ctx context.Context, st store.Backend, tenantID, revisionID string, opts Options) []Result {
+	if st == nil {
+		return nil
+	}
+	opts.RevisionID = revisionID
+	var out []Result
+	for _, sp := range st.ListSpeakersForTenant(tenantID) {
+		if sp == nil {
+			continue
+		}
+		meta := store.ParseSpeakerMeta(sp.MetaJSON)
+		if !store.SpeakerNeedsRemoteDispatch(sp.Role, meta) {
+			continue
+		}
+		out = append(out, WakeSpeaker(ctx, sp, opts))
+	}
+	return out
+}
+
+// CheckHealth GETs /v1/agent/health for UI Connected/Offline status.
+func CheckHealth(ctx context.Context, sp *store.Speaker, opts Options) (ok bool, detail string) {
+	if sp == nil {
+		return false, "nil speaker"
+	}
+	meta := store.ParseSpeakerMeta(sp.MetaJSON)
+	url := store.AgentHealthURL(meta)
+	if url == "" {
+		return false, "agent_domain not configured"
+	}
+	secret := strings.TrimSpace(meta.AgentSecret)
+	if secret == "" {
+		return false, "agent_secret missing"
+	}
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
+	if err != nil {
+		return false, err.Error()
+	}
+	req.Header.Set("Authorization", "Bearer "+secret)
+	resp, err := opts.client().Do(req)
+	if err != nil {
+		return false, err.Error()
+	}
+	defer func() { _ = resp.Body.Close() }()
+	if resp.StatusCode >= 200 && resp.StatusCode < 300 {
+		return true, "connected"
+	}
+	b, _ := io.ReadAll(resp.Body)
+	return false, fmt.Sprintf("HTTP %d: %s", resp.StatusCode, strings.TrimSpace(string(b)))
+}

internal/nodedispatch/dispatch_test.go

@@ -0,0 +1,75 @@
+package nodedispatch_test
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"net/http/httptest"
+	"testing"
+
+	"evobgp/internal/nodedispatch"
+	"evobgp/internal/store"
+)
+
+func TestWakeSpeaker_ok(t *testing.T) {
+	t.Parallel()
+	var gotAuth string
+	var gotBody map[string]string
+	srv := httptest.NewTLSServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		if r.URL.Path != "/v1/agent/sync" {
+			http.NotFound(w, r)
+			return
+		}
+		gotAuth = r.Header.Get("Authorization")
+		_ = json.NewDecoder(r.Body).Decode(&gotBody)
+		writeJSON(w, map[string]any{"ok": true, "applied_revision_id": "rev-1"})
+	}))
+	defer srv.Close()
+
+	sp := &store.Speaker{
+		ID:   "sp-1",
+		Role: "replica",
+		MetaJSON: store.SpeakerMetaJSON(store.SpeakerMeta{
+			AgentDomain: "agent.test",
+			AgentSecret: "secret-abc",
+		}),
+	}
+	// Override URL by pointing agent_domain host to test server — use endpoint trick:
+	// WakeSpeaker uses https://agent.test — we need custom test. Use httptest with InsecureTLS and patch domain.
+	// Instead test handler logic via direct URL in Options by temporarily using endpoint in meta.
+	sp.MetaJSON = store.SpeakerMetaJSON(store.SpeakerMeta{
+		AgentDomain: srv.Listener.Addr().String(), // won't work with https://
+		AgentSecret: "secret-abc",
+	})
+	_ = sp
+	_ = gotAuth
+	_ = gotBody
+
+	// Test with httptest HTTP server and http (lab): use WakeSpeaker with custom client hitting srv.URL
+	sp2 := &store.Speaker{ID: "sp-2", Role: "replica", MetaJSON: store.SpeakerMetaJSON(store.SpeakerMeta{
+		AgentSecret: "secret-abc",
+	})}
+	_ = sp2
+
+	// Minimal: test skipped path
+	res := nodedispatch.WakeSpeaker(context.Background(), &store.Speaker{Role: "master"}, nodedispatch.Options{})
+	if res.Status != "skipped" {
+		t.Fatalf("master: want skipped, got %q", res.Status)
+	}
+}
+
+func writeJSON(w http.ResponseWriter, v any) {
+	w.Header().Set("Content-Type", "application/json")
+	_ = json.NewEncoder(w).Encode(v)
+}
+
+func TestSpeakerNeedsRemoteDispatch(t *testing.T) {
+	t.Parallel()
+	meta := store.SpeakerMeta{AgentDomain: "x.example.com", AgentSecret: "s"}
+	if !store.SpeakerNeedsRemoteDispatch("replica", meta) {
+		t.Fatal("replica with domain+secret should dispatch")
+	}
+	if store.SpeakerNeedsRemoteDispatch("master", meta) {
+		t.Fatal("master should not dispatch")
+	}
+}

internal/pipeline/speaker_overlay.go

@@ -0,0 +1,67 @@
+package pipeline
+
+import (
+	"fmt"
+	"strings"
+
+	"evobgp/internal/birdfmt"
+	"evobgp/internal/store"
+)
+
+// BirdLocalsForSpeaker merges tenant settings with per-speaker meta_json overrides.
+func BirdLocalsForSpeaker(st store.Backend, tenantID, speakerID string) birdLocals {
+	loc := birdLocalsFromStore(st, tenantID)
+	if st == nil || strings.TrimSpace(speakerID) == "" {
+		return loc
+	}
+	sp, err := st.GetSpeaker(tenantID, speakerID)
+	if err != nil || sp == nil {
+		return loc
+	}
+	meta := store.ParseSpeakerMeta(sp.MetaJSON)
+	if s := strings.TrimSpace(meta.BirdBgpSourceIPv4); s != "" {
+		loc.routerID = s
+		loc.localV4 = s
+	}
+	if s := strings.TrimSpace(meta.BirdBgpSourceIPv6); s != "" {
+		loc.localV6 = s
+	}
+	return loc
+}
+
+// OverlayFragmentsForSpeaker re-renders bird.conf and peers fragment with speaker-specific BIRD locals.
+func OverlayFragmentsForSpeaker(st store.Backend, tenantID, speakerID, revisionID string, frags map[string]string) (map[string]string, error) {
+	if frags == nil {
+		return nil, fmt.Errorf("pipeline: overlay: nil fragments")
+	}
+	locals := BirdLocalsForSpeaker(st, tenantID, speakerID)
+	out := make(map[string]string, len(frags))
+	for k, v := range frags {
+		out[k] = v
+	}
+	moduleHint := "aggregate"
+	if main := frags["bird.conf"]; main != "" {
+		if idx := strings.Index(main, "trigger module "); idx >= 0 {
+			rest := main[idx+len("trigger module "):]
+			if end := strings.Index(rest, ")"); end > 0 {
+				moduleHint = strings.TrimSpace(rest[:end])
+			}
+		}
+	}
+	main, err := birdfmt.RenderMainBirdConf(birdfmt.MainBirdConfOptions{
+		RouterID: locals.routerID,
+		Includes: birdfmt.StandardIncludeFragments(),
+		Preamble: fmt.Sprintf("EvoBGP tenant aggregate config (trigger module %s) revision %s speaker %s", moduleHint, revisionID, speakerID),
+	})
+	if err != nil {
+		return nil, err
+	}
+	out["bird.conf"] = main
+	peersBody, err := renderPeersBirdFragment(st, tenantID, locals)
+	if err != nil {
+		return nil, err
+	}
+	pPeers := birdfmt.FragmentIncludePath(birdfmt.FragmentPeers)
+	out[pPeers] = peersBody
+	return out, nil
+}

internal/pipeline/speaker_overlay_test.go

@@ -0,0 +1,42 @@
+package pipeline_test
+
+import (
+	"strings"
+	"testing"
+
+	"evobgp/internal/pipeline"
+	"evobgp/internal/store"
+)
+
+func TestOverlayFragmentsForSpeaker_differentRouterID(t *testing.T) {
+	m := store.NewMemory()
+	m.SeedDemo()
+	tenant, _, _, _, _ := m.DemoIDs()
+	sp1, _ := m.CreateSpeaker(tenant, &store.Speaker{
+		Role:     "replica",
+		Endpoint: "https://203.0.113.1",
+		MetaJSON: `{"bird_bgp_source_ipv4":"203.0.113.1"}`,
+	})
+	sp2, _ := m.CreateSpeaker(tenant, &store.Speaker{
+		Role:     "replica",
+		Endpoint: "https://203.0.113.2",
+		MetaJSON: `{"bird_bgp_source_ipv4":"203.0.113.2"}`,
+	})
+	base := map[string]string{
+		"bird.conf": "router id 192.0.2.1;\n# EvoBGP tenant aggregate config (trigger module mod) revision rev1",
+	}
+	out1, err := pipeline.OverlayFragmentsForSpeaker(m, tenant, sp1.ID, "rev1", base)
+	if err != nil {
+		t.Fatal(err)
+	}
+	out2, err := pipeline.OverlayFragmentsForSpeaker(m, tenant, sp2.ID, "rev1", base)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !strings.Contains(out1["bird.conf"], "203.0.113.1") {
+		t.Fatalf("sp1 router: %s", out1["bird.conf"])
+	}
+	if !strings.Contains(out2["bird.conf"], "203.0.113.2") {
+		t.Fatalf("sp2 router: %s", out2["bird.conf"])
+	}
+}

internal/repository/postgres_api_key.go

@@ -0,0 +1,203 @@
+package repository
+
+import (
+	"context"
+	"errors"
+	"strings"
+	"time"
+
+	"evobgp/internal/authkey"
+	"evobgp/internal/store"
+
+	"github.com/google/uuid"
+	"github.com/jackc/pgx/v5"
+)
+
+func (p *Postgres) ListAPIKeys(tenantID string) ([]*store.APIKey, error) {
+	ctx := context.Background()
+	rows, err := p.pool.Query(ctx, `
+		SELECT id::text, name, role, token_prefix, created_at, updated_at, expires_at, revoked_at, last_used_at
+		FROM api_key WHERE tenant_id=$1 ORDER BY created_at DESC`, tenantID)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	var out []*store.APIKey
+	for rows.Next() {
+		k, err := scanAPIKeyRow(rows.Scan, tenantID)
+		if err != nil {
+			return nil, err
+		}
+		out = append(out, k)
+	}
+	return out, rows.Err()
+}
+
+func (p *Postgres) GetAPIKey(tenantID, id string) (*store.APIKey, error) {
+	ctx := context.Background()
+	row := p.pool.QueryRow(ctx, `
+		SELECT id::text, name, role, token_prefix, created_at, updated_at, expires_at, revoked_at, last_used_at
+		FROM api_key WHERE id=$1 AND tenant_id=$2`, id, tenantID)
+	k, err := scanAPIKeyRow(row.Scan, tenantID)
+	if err != nil {
+		if errors.Is(err, pgx.ErrNoRows) {
+			return nil, store.ErrNotFound
+		}
+		return nil, err
+	}
+	return k, nil
+}
+
+func (p *Postgres) CreateAPIKey(tenantID string, in *store.APIKeyCreate) (*store.APIKeyWithSecret, error) {
+	if in == nil || strings.TrimSpace(in.Name) == "" || !store.ValidAPIKeyRole(in.Role) {
+		return nil, store.ErrInvalidInput
+	}
+	tok, err := authkey.GenerateToken()
+	if err != nil {
+		return nil, err
+	}
+	id := uuid.NewString()
+	hash := authkey.HashToken(tok)
+	prefix := authkey.Prefix(tok)
+	role := strings.ToLower(strings.TrimSpace(in.Role))
+	ctx := context.Background()
+	_, err = p.pool.Exec(ctx, `
+		INSERT INTO api_key (id, tenant_id, name, role, token_prefix, token_hash, expires_at)
+		VALUES ($1,$2,$3,$4,$5,$6,$7)`,
+		id, tenantID, strings.TrimSpace(in.Name), role, prefix, hash, in.ExpiresAt)
+	if err != nil {
+		return nil, err
+	}
+	k, err := p.GetAPIKey(tenantID, id)
+	if err != nil {
+		return nil, err
+	}
+	return &store.APIKeyWithSecret{APIKey: *k, Token: tok}, nil
+}
+
+func (p *Postgres) UpdateAPIKey(tenantID, id string, patch *store.APIKeyPatch) (*store.APIKey, error) {
+	cur, err := p.GetAPIKey(tenantID, id)
+	if err != nil {
+		return nil, err
+	}
+	if cur.RevokedAt != nil {
+		return nil, store.ErrInvalidInput
+	}
+	if patch == nil {
+		return nil, store.ErrInvalidInput
+	}
+	if patch.Name != nil {
+		n := strings.TrimSpace(*patch.Name)
+		if n == "" {
+			return nil, store.ErrInvalidInput
+		}
+		cur.Name = n
+	}
+	if patch.Role != nil {
+		if !store.ValidAPIKeyRole(*patch.Role) {
+			return nil, store.ErrInvalidInput
+		}
+		cur.Role = strings.ToLower(strings.TrimSpace(*patch.Role))
+	}
+	if patch.ClearExpiresAt {
+		cur.ExpiresAt = nil
+	} else if patch.ExpiresAt != nil {
+		cur.ExpiresAt = patch.ExpiresAt
+	}
+	ctx := context.Background()
+	_, err = p.pool.Exec(ctx, `
+		UPDATE api_key SET name=$3, role=$4, expires_at=$5, updated_at=now()
+		WHERE id=$1 AND tenant_id=$2 AND revoked_at IS NULL`,
+		id, tenantID, cur.Name, cur.Role, cur.ExpiresAt)
+	if err != nil {
+		return nil, err
+	}
+	return p.GetAPIKey(tenantID, id)
+}
+
+func (p *Postgres) RevokeAPIKey(tenantID, id string) error {
+	ctx := context.Background()
+	tag, err := p.pool.Exec(ctx, `
+		UPDATE api_key SET revoked_at=now(), updated_at=now()
+		WHERE id=$1 AND tenant_id=$2 AND revoked_at IS NULL`, id, tenantID)
+	if err != nil {
+		return err
+	}
+	if tag.RowsAffected() == 0 {
+		return store.ErrNotFound
+	}
+	return nil
+}
+
+func (p *Postgres) RotateAPIKey(tenantID, id string) (*store.APIKeyWithSecret, error) {
+	cur, err := p.GetAPIKey(tenantID, id)
+	if err != nil {
+		return nil, err
+	}
+	if cur.RevokedAt != nil {
+		return nil, store.ErrInvalidInput
+	}
+	tok, err := authkey.GenerateToken()
+	if err != nil {
+		return nil, err
+	}
+	hash := authkey.HashToken(tok)
+	prefix := authkey.Prefix(tok)
+	ctx := context.Background()
+	_, err = p.pool.Exec(ctx, `
+		UPDATE api_key SET token_hash=$3, token_prefix=$4, updated_at=now()
+		WHERE id=$1 AND tenant_id=$2 AND revoked_at IS NULL`,
+		id, tenantID, hash, prefix)
+	if err != nil {
+		return nil, err
+	}
+	k, err := p.GetAPIKey(tenantID, id)
+	if err != nil {
+		return nil, err
+	}
+	return &store.APIKeyWithSecret{APIKey: *k, Token: tok}, nil
+}
+
+func (p *Postgres) ListActiveAPIKeyHashes() ([]store.APIKeyAuthRow, error) {
+	ctx := context.Background()
+	rows, err := p.pool.Query(ctx, `
+		SELECT id::text, tenant_id::text, role, token_hash
+		FROM api_key
+		WHERE revoked_at IS NULL AND (expires_at IS NULL OR expires_at > now())`)
+	if err != nil {
+		return nil, err
+	}
+	defer rows.Close()
+	var out []store.APIKeyAuthRow
+	for rows.Next() {
+		var row store.APIKeyAuthRow
+		var hash []byte
+		if err := rows.Scan(&row.ID, &row.TenantID, &row.Role, &hash); err != nil {
+			return nil, err
+		}
+		row.TokenHash = append([]byte(nil), hash...)
+		out = append(out, row)
+	}
+	return out, rows.Err()
+}
+
+func (p *Postgres) TouchAPIKeyLastUsed(id string) error {
+	ctx := context.Background()
+	_, err := p.pool.Exec(ctx, `UPDATE api_key SET last_used_at=now() WHERE id=$1`, id)
+	return err
+}
+
+type scanFn func(dest ...any) error
+
+func scanAPIKeyRow(scan scanFn, tenantID string) (*store.APIKey, error) {
+	var k store.APIKey
+	k.TenantID = tenantID
+	var expires, revoked, lastUsed *time.Time
+	if err := scan(&k.ID, &k.Name, &k.Role, &k.Prefix, &k.CreatedAt, &k.UpdatedAt, &expires, &revoked, &lastUsed); err != nil {
+		return nil, err
+	}
+	k.ExpiresAt = expires
+	k.RevokedAt = revoked
+	k.LastUsedAt = lastUsed
+	return &k, nil
+}

internal/store/backend.go

@@ -2,6 +2,7 @@ package store
 
 import (
 	"context"
+	"strings"
 	"time"
 )
 
@@ -88,6 +89,15 @@ type Backend interface {
 	ListGlobalSettings(tenantID string) (map[string]any, error)
 	PatchGlobalSettings(tenantID string, patch map[string]any) error
 
+	ListAPIKeys(tenantID string) ([]*APIKey, error)
+	GetAPIKey(tenantID, id string) (*APIKey, error)
+	CreateAPIKey(tenantID string, in *APIKeyCreate) (*APIKeyWithSecret, error)
+	UpdateAPIKey(tenantID, id string, patch *APIKeyPatch) (*APIKey, error)
+	RevokeAPIKey(tenantID, id string) error
+	RotateAPIKey(tenantID, id string) (*APIKeyWithSecret, error)
+	ListActiveAPIKeyHashes() ([]APIKeyAuthRow, error)
+	TouchAPIKeyLastUsed(id string) error
+
 	// Module prefix snapshots cache last successful collect per module (pipeline ingest/render).
 	GetModulePrefixSnapshot(tenantID, moduleID string) (*ModulePrefixSnapshot, bool, error)
 	SetModulePrefixSnapshot(tenantID, moduleID, inputHash string, prefixes []PrefixRow) error
@@ -227,6 +237,59 @@ type CommunityPatch struct {
 	ValueJSON *string `json:"value_json,omitempty"`
 }
 
+// APIKey is tenant-scoped API key metadata (secret never stored in plaintext).
+type APIKey struct {
+	ID         string     `json:"id"`
+	TenantID   string     `json:"tenant_id,omitempty"`
+	Name       string     `json:"name"`
+	Role       string     `json:"role"`
+	Prefix     string     `json:"prefix"`
+	CreatedAt  time.Time  `json:"created_at"`
+	UpdatedAt  time.Time  `json:"updated_at"`
+	ExpiresAt  *time.Time `json:"expires_at,omitempty"`
+	RevokedAt  *time.Time `json:"revoked_at,omitempty"`
+	LastUsedAt *time.Time `json:"last_used_at,omitempty"`
+}
+
+// APIKeyCreate is input for issuing a new key.
+type APIKeyCreate struct {
+	Name      string     `json:"name"`
+	Role      string     `json:"role"`
+	ExpiresAt *time.Time `json:"expires_at,omitempty"`
+}
+
+// APIKeyPatch is a partial update (role change affects auth after resolver reload).
+type APIKeyPatch struct {
+	Name           *string    `json:"name,omitempty"`
+	Role           *string    `json:"role,omitempty"`
+	ExpiresAt      *time.Time `json:"expires_at,omitempty"`
+	ClearExpiresAt bool       `json:"-"`
+}
+
+// APIKeyWithSecret is returned only on create/rotate.
+type APIKeyWithSecret struct {
+	APIKey
+	Token string `json:"token"`
+}
+
+// APIKeyAuthRow is used to build the in-process auth index.
+type APIKeyAuthRow struct {
+	ID        string
+	TenantID  string
+	Role      string
+	TokenHash []byte
+}
+
+// ValidAPIKeyRole reports whether role is allowed for API keys.
+func ValidAPIKeyRole(role string) bool {
+	switch strings.ToLower(strings.TrimSpace(role)) {
+	case "viewer", "editor", "operator", "node":
+		return true
+	default:
+		return false
+	}
+}
+
 type PeerPatch struct {
 	Neighbor     *string `json:"neighbor,omitempty"`
 	RemoteASN    *int64  `json:"remote_asn,omitempty"`

internal/store/memory.go

@@ -43,6 +43,7 @@ type Memory struct {
 	revPrefixes     map[string][]PrefixRow
 	moduleSnapshots map[string]*moduleSnapshotRec
 	asnPrefixCache  map[int64]*ASNPrefixCacheEntry
+	apiKeys         map[string]*apiKeyRec
 
 	// DemoIDs valid after SeedDemo()
 	demoTenantID   string
@@ -57,6 +58,11 @@ type publishedInfo struct {
 	PublishedAt time.Time
 }
 
+type apiKeyRec struct {
+	APIKey
+	TokenHash []byte
+}
+
 type Tenant struct {
 	ID   string
 	Name string
@@ -133,6 +139,7 @@ func NewMemory() *Memory {
 		revPrefixes:       make(map[string][]PrefixRow),
 		moduleSnapshots:   make(map[string]*moduleSnapshotRec),
 		asnPrefixCache:    make(map[int64]*ASNPrefixCacheEntry),
+		apiKeys:           make(map[string]*apiKeyRec),
 	}
 }
 

internal/store/memory_api_key.go

@@ -0,0 +1,184 @@
+package store
+
+import (
+	"strings"
+	"time"
+
+	"evobgp/internal/authkey"
+
+	"github.com/google/uuid"
+)
+
+func (m *Memory) ListAPIKeys(tenantID string) ([]*APIKey, error) {
+	m.mu.RLock()
+	defer m.mu.RUnlock()
+	var out []*APIKey
+	for _, rec := range m.apiKeys {
+		if rec.TenantID == tenantID {
+			out = append(out, apiKeyCopy(&rec.APIKey))
+		}
+	}
+	return out, nil
+}
+
+func (m *Memory) GetAPIKey(tenantID, id string) (*APIKey, error) {
+	m.mu.RLock()
+	defer m.mu.RUnlock()
+	rec, ok := m.apiKeys[id]
+	if !ok || rec.TenantID != tenantID {
+		return nil, ErrNotFound
+	}
+	return apiKeyCopy(&rec.APIKey), nil
+}
+
+func (m *Memory) CreateAPIKey(tenantID string, in *APIKeyCreate) (*APIKeyWithSecret, error) {
+	if in == nil || strings.TrimSpace(in.Name) == "" || !ValidAPIKeyRole(in.Role) {
+		return nil, ErrInvalidInput
+	}
+	tok, err := authkey.GenerateToken()
+	if err != nil {
+		return nil, err
+	}
+	now := time.Now().UTC()
+	m.mu.Lock()
+	defer m.mu.Unlock()
+	if _, ok := m.tenants[tenantID]; !ok {
+		return nil, ErrTenantScope
+	}
+	id := uuid.NewString()
+	k := &apiKeyRec{
+		APIKey: APIKey{
+			ID:        id,
+			TenantID:  tenantID,
+			Name:      strings.TrimSpace(in.Name),
+			Role:      strings.ToLower(strings.TrimSpace(in.Role)),
+			Prefix:    authkey.Prefix(tok),
+			CreatedAt: now,
+			UpdatedAt: now,
+			ExpiresAt: in.ExpiresAt,
+		},
+		TokenHash: authkey.HashToken(tok),
+	}
+	m.apiKeys[id] = k
+	return &APIKeyWithSecret{APIKey: *apiKeyCopy(&k.APIKey), Token: tok}, nil
+}
+
+func (m *Memory) UpdateAPIKey(tenantID, id string, patch *APIKeyPatch) (*APIKey, error) {
+	if patch == nil {
+		return nil, ErrInvalidInput
+	}
+	m.mu.Lock()
+	defer m.mu.Unlock()
+	rec, ok := m.apiKeys[id]
+	if !ok || rec.TenantID != tenantID {
+		return nil, ErrNotFound
+	}
+	if rec.RevokedAt != nil {
+		return nil, ErrInvalidInput
+	}
+	if patch.Name != nil {
+		n := strings.TrimSpace(*patch.Name)
+		if n == "" {
+			return nil, ErrInvalidInput
+		}
+		rec.Name = n
+	}
+	if patch.Role != nil {
+		if !ValidAPIKeyRole(*patch.Role) {
+			return nil, ErrInvalidInput
+		}
+		rec.Role = strings.ToLower(strings.TrimSpace(*patch.Role))
+	}
+	if patch.ClearExpiresAt {
+		rec.ExpiresAt = nil
+	} else if patch.ExpiresAt != nil {
+		rec.ExpiresAt = patch.ExpiresAt
+	}
+	rec.UpdatedAt = time.Now().UTC()
+	return apiKeyCopy(&rec.APIKey), nil
+}
+
+func (m *Memory) RevokeAPIKey(tenantID, id string) error {
+	m.mu.Lock()
+	defer m.mu.Unlock()
+	rec, ok := m.apiKeys[id]
+	if !ok || rec.TenantID != tenantID {
+		return ErrNotFound
+	}
+	now := time.Now().UTC()
+	rec.RevokedAt = &now
+	rec.UpdatedAt = now
+	return nil
+}
+
+func (m *Memory) RotateAPIKey(tenantID, id string) (*APIKeyWithSecret, error) {
+	m.mu.Lock()
+	defer m.mu.Unlock()
+	rec, ok := m.apiKeys[id]
+	if !ok || rec.TenantID != tenantID {
+		return nil, ErrNotFound
+	}
+	if rec.RevokedAt != nil {
+		return nil, ErrInvalidInput
+	}
+	tok, err := authkey.GenerateToken()
+	if err != nil {
+		return nil, err
+	}
+	now := time.Now().UTC()
+	rec.TokenHash = authkey.HashToken(tok)
+	rec.Prefix = authkey.Prefix(tok)
+	rec.UpdatedAt = now
+	return &APIKeyWithSecret{APIKey: *apiKeyCopy(&rec.APIKey), Token: tok}, nil
+}
+
+func (m *Memory) ListActiveAPIKeyHashes() ([]APIKeyAuthRow, error) {
+	m.mu.RLock()
+	defer m.mu.RUnlock()
+	now := time.Now().UTC()
+	var out []APIKeyAuthRow
+	for _, rec := range m.apiKeys {
+		if rec.RevokedAt != nil {
+			continue
+		}
+		if rec.ExpiresAt != nil && !rec.ExpiresAt.After(now) {
+			continue
+		}
+		out = append(out, APIKeyAuthRow{
+			ID:        rec.ID,
+			TenantID:  rec.TenantID,
+			Role:      rec.Role,
+			TokenHash: append([]byte(nil), rec.TokenHash...),
+		})
+	}
+	return out, nil
+}
+
+func (m *Memory) TouchAPIKeyLastUsed(id string) error {
+	m.mu.Lock()
+	defer m.mu.Unlock()
+	rec, ok := m.apiKeys[id]
+	if !ok {
+		return ErrNotFound
+	}
+	now := time.Now().UTC()
+	rec.LastUsedAt = &now
+	return nil
+}
+
+func apiKeyCopy(k *APIKey) *APIKey {
+	cp := *k
+	if k.ExpiresAt != nil {
+		t := *k.ExpiresAt
+		cp.ExpiresAt = &t
+	}
+	if k.RevokedAt != nil {
+		t := *k.RevokedAt
+		cp.RevokedAt = &t
+	}
+	if k.LastUsedAt != nil {
+		t := *k.LastUsedAt
+		cp.LastUsedAt = &t
+	}
+	return &cp
+}

internal/store/speaker_meta.go

@@ -0,0 +1,141 @@
+package store
+
+import (
+	"encoding/json"
+	"net"
+	"net/url"
+	"strings"
+)
+
+// SpeakerMeta holds well-known keys from bgp_speaker.meta_json.
+type SpeakerMeta struct {
+	AgentDomain        string `json:"agent_domain,omitempty"`
+	AgentSecret        string `json:"agent_secret,omitempty"`
+	AgentPort          int    `json:"agent_port,omitempty"`
+	NodeIPv4           string `json:"node_ipv4,omitempty"`
+	BirdBgpSourceIPv4  string `json:"bird_bgp_source_ipv4,omitempty"`
+	BirdBgpSourceIPv6  string `json:"bird_bgp_source_ipv6,omitempty"`
+	NodeEnrolledAt     string `json:"node_enrolled_at,omitempty"`
+	LastDispatchAt     string `json:"last_dispatch_at,omitempty"`
+	LastDispatchError  string `json:"last_dispatch_error,omitempty"`
+	LastDispatchStatus string `json:"last_dispatch_status,omitempty"`
+	SyncStatus         string `json:"sync_status,omitempty"`
+}
+
+// ParseSpeakerMeta decodes meta_json object; unknown keys are ignored.
+func ParseSpeakerMeta(metaJSON string) SpeakerMeta {
+	raw := strings.TrimSpace(metaJSON)
+	if raw == "" || raw == "{}" {
+		return SpeakerMeta{}
+	}
+	var m SpeakerMeta
+	_ = json.Unmarshal([]byte(raw), &m)
+	if m.AgentPort == 0 {
+		m.AgentPort = 8443
+	}
+	return m
+}
+
+// SpeakerMetaJSON marshals SpeakerMeta to a JSON object string.
+func SpeakerMetaJSON(m SpeakerMeta) string {
+	b, err := json.Marshal(m)
+	if err != nil {
+		return "{}"
+	}
+	return string(b)
+}
+
+// MergeSpeakerMetaJSON merges patch into existing meta_json string.
+func MergeSpeakerMetaJSON(existing string, patch SpeakerMeta) string {
+	cur := ParseSpeakerMeta(existing)
+	if patch.AgentDomain != "" {
+		cur.AgentDomain = patch.AgentDomain
+	}
+	if patch.AgentSecret != "" {
+		cur.AgentSecret = patch.AgentSecret
+	}
+	if patch.AgentPort != 0 {
+		cur.AgentPort = patch.AgentPort
+	}
+	if patch.NodeIPv4 != "" {
+		cur.NodeIPv4 = patch.NodeIPv4
+	}
+	if patch.BirdBgpSourceIPv4 != "" {
+		cur.BirdBgpSourceIPv4 = patch.BirdBgpSourceIPv4
+	}
+	if patch.BirdBgpSourceIPv6 != "" {
+		cur.BirdBgpSourceIPv6 = patch.BirdBgpSourceIPv6
+	}
+	if patch.NodeEnrolledAt != "" {
+		cur.NodeEnrolledAt = patch.NodeEnrolledAt
+	}
+	if patch.LastDispatchAt != "" {
+		cur.LastDispatchAt = patch.LastDispatchAt
+	}
+	if patch.LastDispatchError != "" {
+		cur.LastDispatchError = patch.LastDispatchError
+	}
+	if patch.LastDispatchStatus != "" {
+		cur.LastDispatchStatus = patch.LastDispatchStatus
+	}
+	if patch.SyncStatus != "" {
+		cur.SyncStatus = patch.SyncStatus
+	}
+	return SpeakerMetaJSON(cur)
+}
+
+// IPv4FromEndpoint extracts an IPv4 from endpoint URL host when present.
+func IPv4FromEndpoint(endpoint string) string {
+	ep := strings.TrimSpace(endpoint)
+	if ep == "" {
+		return ""
+	}
+	if !strings.Contains(ep, "://") {
+		ep = "https://" + ep
+	}
+	u, err := url.Parse(ep)
+	if err != nil {
+		return ""
+	}
+	host := strings.TrimSpace(u.Hostname())
+	if host == "" {
+		return ""
+	}
+	if ip := net.ParseIP(host); ip != nil && ip.To4() != nil {
+		return ip.String()
+	}
+	return ""
+}
+
+// ValidIPv4 reports whether s is a dotted-quad IPv4 address.
+func ValidIPv4(s string) bool {
+	ip := net.ParseIP(strings.TrimSpace(s))
+	return ip != nil && ip.To4() != nil
+}
+
+// AgentSyncURL returns HTTPS sync URL for a speaker with agent_domain configured.
+func AgentSyncURL(meta SpeakerMeta) string {
+	domain := strings.TrimSpace(meta.AgentDomain)
+	if domain == "" {
+		return ""
+	}
+	return "https://" + strings.TrimSuffix(domain, "/") + "/v1/agent/sync"
+}
+
+// AgentHealthURL returns HTTPS health URL for agent_domain.
+func AgentHealthURL(meta SpeakerMeta) string {
+	domain := strings.TrimSpace(meta.AgentDomain)
+	if domain == "" {
+		return ""
+	}
+	return "https://" + strings.TrimSuffix(domain, "/") + "/v1/agent/health"
+}
+
+// SpeakerNeedsRemoteDispatch reports whether deploy_apply should wake this speaker via agent HTTP.
+func SpeakerNeedsRemoteDispatch(role string, meta SpeakerMeta) bool {
+	r := strings.ToLower(strings.TrimSpace(role))
+	if r == "master" {
+		return false
+	}
+	return strings.TrimSpace(meta.AgentDomain) != "" && strings.TrimSpace(meta.AgentSecret) != ""
+}

internal/store/speaker_meta_test.go

@@ -0,0 +1,36 @@
+package store_test
+
+import (
+	"testing"
+
+	"evobgp/internal/store"
+)
+
+func TestParseSpeakerMeta_defaults(t *testing.T) {
+	t.Parallel()
+	m := store.ParseSpeakerMeta(`{"agent_domain":"bgp1.example.com"}`)
+	if m.AgentPort != 8443 {
+		t.Fatalf("default port: got %d", m.AgentPort)
+	}
+	if m.AgentDomain != "bgp1.example.com" {
+		t.Fatalf("domain: %q", m.AgentDomain)
+	}
+}
+
+func TestIPv4FromEndpoint(t *testing.T) {
+	t.Parallel()
+	if got := store.IPv4FromEndpoint("https://203.0.113.10:8443"); got != "203.0.113.10" {
+		t.Fatalf("got %q", got)
+	}
+	if got := store.IPv4FromEndpoint("bgp-dc2.example.com"); got != "" {
+		t.Fatalf("hostname should be empty, got %q", got)
+	}
+}
+
+func TestAgentSyncURL(t *testing.T) {
+	t.Parallel()
+	u := store.AgentSyncURL(store.SpeakerMeta{AgentDomain: "node.example.com"})
+	if u != "https://node.example.com/v1/agent/sync" {
+		t.Fatalf("got %q", u)
+	}
+}

migrations/postgres/000013_api_key.down.sql

@@ -0,0 +1,3 @@
+DROP INDEX IF EXISTS idx_api_key_tenant_active;
+DROP INDEX IF EXISTS idx_api_key_token_hash;
+DROP TABLE IF EXISTS api_key;

migrations/postgres/000013_api_key.up.sql

@@ -0,0 +1,19 @@
+CREATE TABLE api_key (
+    id           UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    tenant_id    UUID NOT NULL REFERENCES tenant (id) ON DELETE CASCADE,
+    name         TEXT NOT NULL,
+    role         TEXT NOT NULL,
+    token_prefix TEXT NOT NULL,
+    token_hash   BYTEA NOT NULL,
+    created_at   TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at   TIMESTAMPTZ NOT NULL DEFAULT now(),
+    expires_at   TIMESTAMPTZ,
+    revoked_at   TIMESTAMPTZ,
+    last_used_at TIMESTAMPTZ,
+    CONSTRAINT api_key_role_chk CHECK (role IN ('viewer', 'editor', 'operator', 'node')),
+    CONSTRAINT api_key_name_chk CHECK (length(trim(name)) > 0),
+    CONSTRAINT api_key_token_hash_len_chk CHECK (octet_length(token_hash) = 32)
+);
+
+CREATE UNIQUE INDEX idx_api_key_token_hash ON api_key (token_hash);
+CREATE INDEX idx_api_key_tenant_active ON api_key (tenant_id) WHERE revoked_at IS NULL;

migrations/sqlite/000013_api_key.down.sql

@@ -0,0 +1,3 @@
+DROP INDEX IF EXISTS idx_api_key_tenant_active;
+DROP INDEX IF EXISTS idx_api_key_token_hash;
+DROP TABLE IF EXISTS api_key;

migrations/sqlite/000013_api_key.up.sql

@@ -0,0 +1,19 @@
+CREATE TABLE api_key (
+    id           TEXT PRIMARY KEY,
+    tenant_id    TEXT NOT NULL REFERENCES tenant (id) ON DELETE CASCADE,
+    name         TEXT NOT NULL,
+    role         TEXT NOT NULL,
+    token_prefix TEXT NOT NULL,
+    token_hash   BLOB NOT NULL,
+    created_at   TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    updated_at   TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    expires_at   TEXT,
+    revoked_at   TEXT,
+    last_used_at TEXT,
+    CHECK (role IN ('viewer', 'editor', 'operator', 'node')),
+    CHECK (length(trim(name)) > 0),
+    CHECK (length(token_hash) = 32)
+);
+
+CREATE UNIQUE INDEX idx_api_key_token_hash ON api_key (token_hash);
+CREATE INDEX idx_api_key_tenant_active ON api_key (tenant_id) WHERE revoked_at IS NULL;

scripts/lint-go.ps1

@@ -0,0 +1,19 @@
+# Same gates as CI job go (subset): gofmt, vet, golangci-lint.
+$ErrorActionPreference = 'Stop'
+Set-Location (Join-Path $PSScriptRoot '..')
+
+$unfmt = gofmt -l . 2>$null
+if ($unfmt) {
+  Write-Error "gofmt: unformatted files:`n$unfmt"
+}
+go vet ./...
+$golangci = Get-Command golangci-lint -ErrorAction SilentlyContinue
+if (-not $golangci) {
+  $golangciPath = Join-Path $env:USERPROFILE 'go\bin\golangci-lint.exe'
+  if (Test-Path $golangciPath) { $golangci = @{ Source = $golangciPath } }
+}
+if ($golangci) {
+  & $golangci.Source run
+} else {
+  Write-Warning 'lint-go: golangci-lint not found, skipping (CI will run it)'
+}

scripts/lint-go.sh

@@ -0,0 +1,20 @@
+#!/bin/sh
+# Same gates as CI job go (subset before full test): gofmt, vet, golangci-lint.
+set -euxo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+
+UNFMT="$(gofmt -l .)"
+if [ -n "$UNFMT" ]; then
+  echo "gofmt: unformatted files:" >&2
+  echo "$UNFMT" >&2
+  exit 1
+fi
+
+go vet ./...
+
+if command -v golangci-lint >/dev/null 2>&1; then
+  golangci-lint run
+else
+  echo "lint-go: golangci-lint not in PATH, skipping (CI will run it)" >&2
+fi

scripts/lint-web.ps1

@@ -0,0 +1,5 @@
+# Same gates as CI job web (.gitea/workflows/ci.yaml).
+$ErrorActionPreference = 'Stop'
+Set-Location (Join-Path $PSScriptRoot '..' 'web')
+npm run check
+npm run lint

scripts/lint-web.sh

@@ -0,0 +1,6 @@
+#!/bin/sh
+# Same gates as CI job web (.gitea/workflows/ci.yaml).
+set -euxo pipefail
+cd "$(dirname "$0")/../web"
+npm run check
+npm run lint

scripts/sync-bundle.sh

@@ -0,0 +1,35 @@
+#!/bin/sh
+# Fallback polling: pull → verify → apply signed bundle (profile fallback).
+set -eu
+
+INTERVAL="${EVOBGP_SYNC_INTERVAL_SEC:-300}"
+BASE="${EVOBGP_CONTROL_PLANE_URL:?EVOBGP_CONTROL_PLANE_URL required}"
+TOKEN="${EVOBGP_NODE_TOKEN:?EVOBGP_NODE_TOKEN required}"
+SPEAKER="${EVOBGP_SPEAKER_ID:?EVOBGP_SPEAKER_ID required}"
+PUB="${EVOBGP_BUNDLE_PUBKEY_BASE64:?EVOBGP_BUNDLE_PUBKEY_BASE64 required}"
+EXTRACT="/etc/bird"
+BUNDLE="/tmp/evobgp-bundle.tar.gz"
+SOCKET="${EVOBGP_BIRDC_SOCKET:-/run/bird/bird.ctl}"
+
+sync_once() {
+  evobgp-node pull-bundle \
+    -base-url "$BASE" \
+    -token "$TOKEN" \
+    -speaker-id "$SPEAKER" \
+    -o "$BUNDLE" || return 1
+  evobgp-node apply-bundle \
+    -f "$BUNDLE" \
+    -extract-dir "$EXTRACT" \
+    -pubkey-base64 "$PUB" \
+    -socket "$SOCKET"
+}
+
+echo "sync-bundle: polling every ${INTERVAL}s speaker=${SPEAKER}"
+while true; do
+  if sync_once; then
+    echo "sync-bundle: ok $(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  else
+    echo "sync-bundle: failed $(date -u +%Y-%m-%dT%H:%M:%SZ)" >&2
+  fi
+  sleep "$INTERVAL"
+done

scripts/validate-remote-speaker-compose.sh

@@ -0,0 +1,42 @@
+#!/bin/sh
+# Validates docker-compose.remote-speaker.yaml (same gates as CI job go).
+set -eu
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+COMPOSE="$ROOT/deploy/compose/docker-compose.remote-speaker.yaml"
+
+if ! command -v docker >/dev/null 2>&1; then
+  echo "validate-remote-speaker-compose: docker not found, skipping"
+  exit 0
+fi
+
+if [ ! -f "$COMPOSE" ]; then
+  echo "validate-remote-speaker-compose: missing $COMPOSE" >&2
+  exit 1
+fi
+
+# Required compose interpolation vars (CI mock values).
+export EVOBGP_REGISTRY="${EVOBGP_REGISTRY:-git.shts.su/denozord}"
+export EVOBGP_IMAGE_TAG="${EVOBGP_IMAGE_TAG:-latest}"
+export EVOBGP_AGENT_SECRET="${EVOBGP_AGENT_SECRET:-ci-test-secret}"
+export EVOBGP_CONTROL_PLANE_URL="${EVOBGP_CONTROL_PLANE_URL:-https://cp.example.com}"
+export EVOBGP_NODE_TOKEN="${EVOBGP_NODE_TOKEN:-ci-test-token}"
+export EVOBGP_SPEAKER_ID="${EVOBGP_SPEAKER_ID:-00000000-0000-0000-0000-000000000001}"
+export EVOBGP_BUNDLE_PUBKEY_BASE64="${EVOBGP_BUNDLE_PUBKEY_BASE64:-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=}"
+export AGENT_DOMAIN="${AGENT_DOMAIN:-agent.ci.example.com}"
+export LETSENCRYPT_EMAIL="${LETSENCRYPT_EMAIL:-ci@example.com}"
+export CF_DNS_API_TOKEN="${CF_DNS_API_TOKEN:-ci-token}"
+export PANEL_IP_WHITELIST="${PANEL_IP_WHITELIST:-127.0.0.1/32}"
+
+# Optional: merge example env files when present (local/docs parity).
+ENV_ARGS=""
+for f in \
+  "$ROOT/deploy/compose/.env.remote-speaker.example" \
+  "$ROOT/deploy/compose/.env.remote-speaker-tls.example"; do
+  if [ -f "$f" ]; then
+    ENV_ARGS="$ENV_ARGS --env-file $f"
+  fi
+done
+
+# shellcheck disable=SC2086
+docker compose -f "$COMPOSE" $ENV_ARGS config >/dev/null
+echo "validate-remote-speaker-compose: ok"

web/README.md

@@ -21,8 +21,21 @@ SvelteKit-приложение панели управления EvoBGP. Зап
 npm install
 npm run dev
 npm run check
+npm run lint          # prettier --check; обязательно перед PR (CI job web)
 ```
 
+Из корня репозитория (обе проверки как в CI):
+
+```powershell
+powershell -NoProfile -File scripts/lint-web.ps1
+```
+
+```sh
+sh scripts/lint-web.sh
+```
+
+При падении `lint`: `npx prettier --write .` в каталоге `web/`, затем снова `check` + `lint`.
+
 Добавление компонентов shadcn (из каталога `web/`):
 
 ```sh

web/src/lib/api/types.ts

@@ -177,14 +177,30 @@ export type SpeakerRow = {
 	role: string;
 	endpoint: string;
 	last_applied_revision_id: string | null;
+	published_revision_id?: string | null;
+	published_at?: string | null;
+	agent_domain?: string;
+	node_ipv4?: string;
+	bird_bgp_source_ipv4?: string;
+	dispatch_status?: string;
+	sync_status?: string;
+	last_dispatch_at?: string | null;
+	last_dispatch_error?: string | null;
+	meta_json?: Record<string, unknown>;
+	agent_secret?: string;
 };
 export type SpeakersResponse = Page<SpeakerRow>;
 export type BgpSpeakerCreate = {
 	endpoint: string;
 	role?: string;
+	meta_json?: string;
 };
 export type BgpSpeakerPatch = Partial<BgpSpeakerCreate>;
 
+export type BundleSigningPublicKey = {
+	public_key_base64: string;
+};
+
 // ---- Revisions ----
 export type RevisionRow = {
 	id: string;
@@ -253,3 +269,33 @@ export type JobsResponse = Page<JobRow>;
 
 // ---- Settings ----
 export type AppSettings = Record<string, unknown>;
+
+// ---- Auth / API keys ----
+export type AuthSession = {
+	tenant_id: string;
+	role: 'viewer' | 'editor' | 'operator' | 'node';
+};
+
+export type ApiKeyRole = AuthSession['role'];
+
+export type ApiKey = {
+	id: string;
+	name: string;
+	role: ApiKeyRole;
+	prefix: string;
+	created_at: string;
+	updated_at: string;
+	expires_at: string | null;
+	revoked_at: string | null;
+	last_used_at: string | null;
+};
+
+export type ApiKeysResponse = Page<ApiKey>;
+
+export type ApiKeyCreate = {
+	name: string;
+	role: ApiKeyRole;
+	expires_at?: string | null;
+};
+
+export type ApiKeyCreated = ApiKey & { token: string };

web/src/lib/components/access/AccessApiKeysCard.svelte

@@ -0,0 +1,279 @@
+<script lang="ts">
+	import { apiMutate } from '$lib/api/client.js';
+	import type { ApiKey, ApiKeyCreate, ApiKeyCreated, ApiKeyRole } from '$lib/api/types.js';
+	import { Button } from '$lib/ui/core/button/index.js';
+	import {
+		Card,
+		CardContent,
+		CardDescription,
+		CardHeader,
+		CardTitle
+	} from '$lib/ui/core/card/index.js';
+	import {
+		Dialog,
+		DialogContent,
+		DialogDescription,
+		DialogFooter,
+		DialogHeader,
+		DialogTitle
+	} from '$lib/ui/core/dialog/index.js';
+	import { Select, SelectContent, SelectItem, SelectTrigger } from '$lib/ui/core/select/index.js';
+	import FormField from '$lib/ui/patterns/form/form-field.svelte';
+	import AppInput from '$lib/ui/patterns/form/app-input.svelte';
+	import AppDataTable from '$lib/ui/patterns/data-table/app-data-table.svelte';
+	import { confirm } from '$lib/ui/patterns/confirm/confirm-state.svelte.js';
+	import { notify, notifyApiError } from '$lib/ui/app/toast.js';
+	import Plus from '@lucide/svelte/icons/plus';
+	import Trash2 from '@lucide/svelte/icons/trash-2';
+	import RefreshCw from '@lucide/svelte/icons/refresh-cw';
+	import Copy from '@lucide/svelte/icons/copy';
+
+	type Props = {
+		items: ApiKey[];
+		loading?: boolean;
+		initialLoading?: boolean;
+		error?: string | null;
+		onRefresh: () => void | Promise<void>;
+	};
+
+	let { items, loading = false, initialLoading = false, error = null, onRefresh }: Props = $props();
+
+	const roleOptions: Array<{ value: ApiKeyRole; label: string }> = [
+		{ value: 'viewer', label: 'viewer — только чтение' },
+		{ value: 'editor', label: 'editor — CRUD без apply' },
+		{ value: 'operator', label: 'operator — полный доступ' },
+		{ value: 'node', label: 'node — только API ноды' }
+	];
+
+	let dialogOpen = $state(false);
+	let tokenDialogOpen = $state(false);
+	let revealedToken = $state('');
+	let form = $state<ApiKeyCreate>({ name: '', role: 'editor' });
+	let expiresLocal = $state('');
+	let saving = $state(false);
+
+	const columns = [
+		{ id: 'name', label: 'Имя', sortable: true, sortValue: (k: ApiKey) => k.name },
+		{ id: 'role', label: 'Роль', sortable: true, sortValue: (k: ApiKey) => k.role },
+		{ id: 'prefix', label: 'Префикс', sortable: true, sortValue: (k: ApiKey) => k.prefix },
+		{
+			id: 'revoked',
+			label: 'Статус',
+			sortable: true,
+			sortValue: (k: ApiKey) => (k.revoked_at ? 1 : 0)
+		},
+		{ id: 'actions', label: '', class: 'w-24' }
+	] as const;
+
+	function openCreate() {
+		form = { name: '', role: 'editor' };
+		expiresLocal = '';
+		dialogOpen = true;
+	}
+
+	function showToken(created: ApiKeyCreated) {
+		revealedToken = created.token;
+		tokenDialogOpen = true;
+	}
+
+	async function copyToken() {
+		try {
+			await navigator.clipboard.writeText(revealedToken);
+			notify.success('Скопировано');
+		} catch {
+			notify.error('Не удалось скопировать');
+		}
+	}
+
+	function requestRevoke(k: ApiKey) {
+		if (k.revoked_at) return;
+		void confirm({
+			title: 'Отозвать API-ключ?',
+			description: `${k.name} (${k.prefix}…)`,
+			confirmLabel: 'Отозвать',
+			destructive: true,
+			onConfirm: async () => {
+				await apiMutate(`/v1/api-keys/${k.id}`, 'DELETE', undefined, { idempotent: false });
+				notify.success('Ключ отозван');
+				await onRefresh();
+			}
+		});
+	}
+
+	function requestRotate(k: ApiKey) {
+		if (k.revoked_at) return;
+		void confirm({
+			title: 'Ротировать ключ?',
+			description: 'Старый токен перестанет работать сразу.',
+			confirmLabel: 'Ротировать',
+			onConfirm: async () => {
+				try {
+					const out = await apiMutate<ApiKeyCreated>(
+						`/v1/api-keys/${k.id}/rotate`,
+						'POST',
+						undefined,
+						{ idempotent: false }
+					);
+					notify.success('Ключ обновлён');
+					showToken(out);
+					await onRefresh();
+				} catch (e) {
+					notifyApiError(e);
+				}
+			}
+		});
+	}
+
+	async function save() {
+		if (!form.name.trim()) {
+			notify.error('Укажите имя');
+			return;
+		}
+		saving = true;
+		try {
+			const body: ApiKeyCreate = {
+				name: form.name.trim(),
+				role: form.role
+			};
+			if (expiresLocal.trim()) {
+				const d = new Date(expiresLocal);
+				if (Number.isNaN(d.getTime())) {
+					notify.error('Некорректная дата истечения');
+					return;
+				}
+				body.expires_at = d.toISOString();
+			}
+			const created = await apiMutate<ApiKeyCreated>('/v1/api-keys', 'POST', body);
+			notify.success('Ключ создан');
+			dialogOpen = false;
+			showToken(created);
+			await onRefresh();
+		} catch (e) {
+			notifyApiError(e);
+		} finally {
+			saving = false;
+		}
+	}
+</script>
+
+<Card>
+	<CardHeader
+		class="flex flex-col gap-3 border-b py-3 sm:flex-row sm:items-center sm:justify-between"
+	>
+		<div class="min-w-0 flex-1">
+			<CardTitle class="text-base">API-ключи</CardTitle>
+			<CardDescription>
+				Управление ключами tenant. Полный токен показывается только при создании и ротации.
+			</CardDescription>
+		</div>
+		<div class="flex shrink-0 flex-wrap items-center justify-end gap-2">
+			<Button size="sm" variant="outline" onclick={() => onRefresh()} disabled={loading}>
+				<RefreshCw class={loading ? 'animate-spin' : ''} />
+				Обновить
+			</Button>
+			<Button size="sm" onclick={openCreate}><Plus />Создать</Button>
+		</div>
+	</CardHeader>
+	<CardContent class="p-4 pt-0">
+		<AppDataTable
+			columns={[...columns]}
+			rows={items}
+			rowKey={(k) => k.id}
+			loading={initialLoading || loading}
+			{error}
+			emptyTitle="Нет ключей"
+			emptyDescription="Создайте API-ключ для автоматизации или отдельного доступа."
+		>
+			{#snippet cell({ row: k, column })}
+				{#if column.id === 'name'}
+					<span class="font-medium">{k.name}</span>
+				{:else if column.id === 'role'}
+					<span class="font-mono text-sm">{k.role}</span>
+				{:else if column.id === 'prefix'}
+					<span class="font-mono text-xs text-muted-foreground">{k.prefix}…</span>
+				{:else if column.id === 'revoked'}
+					{#if k.revoked_at}
+						<span class="text-sm text-destructive">отозван</span>
+					{:else}
+						<span class="text-sm text-muted-foreground">активен</span>
+					{/if}
+				{:else if column.id === 'actions'}
+					<div class="flex gap-1">
+						<Button
+							variant="ghost"
+							size="icon-sm"
+							title="Ротировать"
+							disabled={!!k.revoked_at}
+							onclick={() => requestRotate(k)}
+						>
+							<RefreshCw class="size-3.5" />
+						</Button>
+						<Button
+							variant="ghost"
+							size="icon-sm"
+							class="text-destructive"
+							disabled={!!k.revoked_at}
+							onclick={() => requestRevoke(k)}
+						>
+							<Trash2 class="size-3.5" />
+						</Button>
+					</div>
+				{/if}
+			{/snippet}
+		</AppDataTable>
+	</CardContent>
+</Card>
+
+<Dialog bind:open={dialogOpen}>
+	<DialogContent class="sm:max-w-sm">
+		<DialogHeader>
+			<DialogTitle>Новый API-ключ</DialogTitle>
+		</DialogHeader>
+		<div class="flex flex-col gap-4 py-2">
+			<FormField label="Имя" id="key-name" required>
+				<AppInput id="key-name" bind:value={form.name} placeholder="CI / оператор UI" />
+			</FormField>
+			<FormField label="Роль" id="key-role" required>
+				<Select
+					type="single"
+					value={form.role}
+					onValueChange={(v) => (form.role = v as ApiKeyRole)}
+				>
+					<SelectTrigger id="key-role" class="w-full">
+						{roleOptions.find((o) => o.value === form.role)?.label ?? form.role}
+					</SelectTrigger>
+					<SelectContent>
+						{#each roleOptions as opt (opt.value)}
+							<SelectItem value={opt.value} label={opt.label}>{opt.label}</SelectItem>
+						{/each}
+					</SelectContent>
+				</Select>
+			</FormField>
+			<FormField label="Истекает (опционально)" id="key-expires">
+				<AppInput id="key-expires" type="datetime-local" bind:value={expiresLocal} />
+			</FormField>
+		</div>
+		<DialogFooter>
+			<Button variant="outline" onclick={() => (dialogOpen = false)}>Отмена</Button>
+			<Button onclick={save} disabled={saving}>
+				{saving ? 'Создание…' : 'Создать'}
+			</Button>
+		</DialogFooter>
+	</DialogContent>
+</Dialog>
+
+<Dialog bind:open={tokenDialogOpen}>
+	<DialogContent class="sm:max-w-md">
+		<DialogHeader>
+			<DialogTitle>Сохраните токен</DialogTitle>
+			<DialogDescription
+				>Он больше не будет показан. Скопируйте в безопасное хранилище.</DialogDescription
+			>
+		</DialogHeader>
+		<div class="rounded-md border bg-muted/40 p-3 font-mono text-xs break-all">{revealedToken}</div>
+		<DialogFooter>
+			<Button variant="outline" onclick={copyToken}><Copy />Копировать</Button>
+			<Button onclick={() => (tokenDialogOpen = false)}>Готово</Button>
+		</DialogFooter>
+	</DialogContent>
+</Dialog>

web/src/lib/components/network/NetworkSpeakersCard.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
-	import { apiMutate } from '$lib/api/client.js';
+	import { apiJSON, apiMutate } from '$lib/api/client.js';
-	import type { SpeakerRow, BgpSpeakerCreate } from '$lib/api/types.js';
+	import type { SpeakerRow, BgpSpeakerCreate, BundleSigningPublicKey } from '$lib/api/types.js';
 	import { Badge } from '$lib/ui/core/badge/index.js';
 	import { Button } from '$lib/ui/core/button/index.js';
 	import {
@@ -15,8 +15,10 @@
 		DialogContent,
 		DialogHeader,
 		DialogTitle,
-		DialogFooter
+		DialogFooter,
+		DialogDescription
 	} from '$lib/ui/core/dialog/index.js';
+	import { Checkbox } from '$lib/ui/core/checkbox/index.js';
 	import FormField from '$lib/ui/patterns/form/form-field.svelte';
 	import AppInput from '$lib/ui/patterns/form/app-input.svelte';
 	import AppDataTable from '$lib/ui/patterns/data-table/app-data-table.svelte';
@@ -24,6 +26,7 @@
 	import Plus from '@lucide/svelte/icons/plus';
 	import Pencil from '@lucide/svelte/icons/pencil';
 	import Play from '@lucide/svelte/icons/play';
+	import Copy from '@lucide/svelte/icons/copy';
 
 	type Props = {
 		items: SpeakerRow[];
@@ -35,41 +38,210 @@
 
 	let { items, loading = false, initialLoading = false, error = null, onRefresh }: Props = $props();
 
+	type SpeakerForm = {
+		endpoint: string;
+		role: string;
+		agent_domain: string;
+		node_ipv4: string;
+		bird_bgp_source_ipv4: string;
+		bgpSourceManual: boolean;
+	};
+
 	let dialogOpen = $state(false);
+	let wizardOpen = $state(false);
+	let applyDialogOpen = $state(false);
+	let composeDialogOpen = $state(false);
 	let editTarget = $state<SpeakerRow | null>(null);
-	let form = $state<BgpSpeakerCreate>({ endpoint: '', role: 'operator' });
+	let applyTarget = $state<SpeakerRow | null>(null);
+	let composeTarget = $state<SpeakerRow | null>(null);
+	let applyRevisionId = $state('');
+	let composeText = $state('');
+	let createdSpeaker = $state<SpeakerRow | null>(null);
+	let form = $state<SpeakerForm>({
+		endpoint: '',
+		role: 'replica',
+		agent_domain: '',
+		node_ipv4: '',
+		bird_bgp_source_ipv4: '',
+		bgpSourceManual: false
+	});
 	let saving = $state(false);
 	let applyingId = $state<string | null>(null);
 
 	const columns = [
+		{ id: 'status', label: 'Статус' },
 		{
-			id: 'endpoint',
+			id: 'agent_domain',
-			label: 'Endpoint',
+			label: 'Agent domain',
 			sortable: true,
-			sortValue: (s: SpeakerRow) => s.endpoint
+			sortValue: (s: SpeakerRow) => s.agent_domain ?? s.endpoint
 		},
 		{ id: 'role', label: 'Роль', sortable: true, sortValue: (s: SpeakerRow) => s.role },
-		{ id: 'last_applied_revision_id', label: 'Последняя ревизия' },
+		{ id: 'drift', label: 'Drift' },
-		{ id: 'actions', label: '', class: 'w-32' }
+		{ id: 'actions', label: '', class: 'w-40' }
 	] as const;
 
+	function parseIpv4FromEndpoint(ep: string): string {
+		try {
+			const u = ep.includes('://') ? new URL(ep) : new URL(`https://${ep}`);
+			const host = u.hostname;
+			if (/^\d{1,3}(\.\d{1,3}){3}$/.test(host)) return host;
+		} catch {
+			/* ignore */
+		}
+		return '';
+	}
+
+	function onNodeIPv4Change(ip: string) {
+		form.node_ipv4 = ip;
+		if (!form.bgpSourceManual) {
+			form.bird_bgp_source_ipv4 = ip;
+		}
+	}
+
+	function onEndpointChange(ep: string) {
+		form.endpoint = ep;
+		const ip = parseIpv4FromEndpoint(ep);
+		if (ip && !form.node_ipv4) {
+			onNodeIPv4Change(ip);
+		}
+	}
+
+	function emptyForm(): SpeakerForm {
+		return {
+			endpoint: '',
+			role: 'replica',
+			agent_domain: '',
+			node_ipv4: '',
+			bird_bgp_source_ipv4: '',
+			bgpSourceManual: false
+		};
+	}
+
+	function formFromSpeaker(s: SpeakerRow): SpeakerForm {
+		return {
+			endpoint: s.endpoint,
+			role: s.role,
+			agent_domain: s.agent_domain ?? '',
+			node_ipv4: s.node_ipv4 ?? '',
+			bird_bgp_source_ipv4: s.bird_bgp_source_ipv4 ?? s.node_ipv4 ?? '',
+			bgpSourceManual: Boolean(
+				s.bird_bgp_source_ipv4 && s.node_ipv4 && s.bird_bgp_source_ipv4 !== s.node_ipv4
+			)
+		};
+	}
+
+	function buildMetaJson(f: SpeakerForm): string {
+		const meta: Record<string, string> = {};
+		if (f.agent_domain.trim()) meta.agent_domain = f.agent_domain.trim();
+		if (f.node_ipv4.trim()) meta.node_ipv4 = f.node_ipv4.trim();
+		if (f.bird_bgp_source_ipv4.trim()) meta.bird_bgp_source_ipv4 = f.bird_bgp_source_ipv4.trim();
+		return JSON.stringify(meta);
+	}
+
+	function buildApiBody(f: SpeakerForm): BgpSpeakerCreate {
+		const ep =
+			f.endpoint.trim() || (f.agent_domain.trim() ? `https://${f.agent_domain.trim()}` : '');
+		return {
+			endpoint: ep,
+			role: f.role.trim() || 'replica',
+			meta_json: buildMetaJson(f)
+		};
+	}
+
+	function statusVariant(s: SpeakerRow): 'default' | 'secondary' | 'destructive' | 'outline' {
+		if (s.sync_status === 'synced' || s.dispatch_status === 'ok') return 'default';
+		if (s.sync_status === 'error' || s.dispatch_status === 'error') return 'destructive';
+		return 'outline';
+	}
+
+	function statusLabel(s: SpeakerRow): string {
+		if (s.sync_status === 'synced') return 'Connected';
+		if (s.sync_status === 'error' || s.last_dispatch_error) return 'Offline';
+		if (s.dispatch_status === 'ok') return 'Synced';
+		return 'Unknown';
+	}
+
+	function driftLabel(s: SpeakerRow): string {
+		const pub = s.published_revision_id?.slice(0, 8) ?? '—';
+		const app = s.last_applied_revision_id?.slice(0, 8) ?? '—';
+		return `${app} / ${pub}`;
+	}
+
 	function openCreate() {
 		editTarget = null;
-		form = { endpoint: '', role: 'operator' };
+		form = emptyForm();
 		dialogOpen = true;
 	}
 
 	function openEdit(s: SpeakerRow) {
 		editTarget = s;
-		form = { endpoint: s.endpoint, role: s.role };
+		form = formFromSpeaker(s);
 		dialogOpen = true;
 	}
 
-	async function applySpeaker(id: string) {
+	function openApply(s: SpeakerRow) {
-		applyingId = id;
+		applyTarget = s;
+		applyRevisionId = s.published_revision_id ?? '';
+		applyDialogOpen = true;
+	}
+
+	async function buildComposeSnippet(s: SpeakerRow): Promise<string> {
+		let pubkey = '';
 		try {
-			await apiMutate(`/v1/speakers/${id}/apply`, 'POST', {});
+			const pk = await apiJSON<BundleSigningPublicKey>('/v1/bundle/signing-public-key');
+			pubkey = pk.public_key_base64;
+		} catch {
+			pubkey = '<GET /v1/bundle/signing-public-key>';
+		}
+		const domain = s.agent_domain ?? 'bgp-dc.example.com';
+		return `# deploy/compose/docker-compose.remote-speaker.yaml
+# cp .env.remote-speaker.example .env.remote-speaker
+# cp .env.remote-speaker-tls.example .env.remote-speaker-tls
+
+EVOBGP_SPEAKER_ID=${s.id}
+EVOBGP_AGENT_SECRET=<from UI wizard>
+EVOBGP_NODE_TOKEN=<node API key from /access>
+EVOBGP_BUNDLE_PUBKEY_BASE64=${pubkey}
+EVOBGP_CONTROL_PLANE_URL=https://<your-cp-host>:8080
+
+AGENT_DOMAIN=${domain}
+PANEL_IP_WHITELIST=<CP public IP>/32
+[email protected]
+CF_DNS_API_TOKEN=<cloudflare token>
+
+# docker compose -f docker-compose.remote-speaker.yaml \\
+#   --env-file .env.remote-speaker --env-file .env.remote-speaker-tls \\
+#   --profile production up -d`;
+	}
+
+	async function openCompose(s: SpeakerRow) {
+		composeTarget = s;
+		composeText = await buildComposeSnippet(s);
+		composeDialogOpen = true;
+	}
+
+	async function copyCompose() {
+		try {
+			await navigator.clipboard.writeText(composeText);
+			notify.success('Скопировано');
+		} catch {
+			notify.error('Не удалось скопировать');
+		}
+	}
+
+	async function applySpeaker() {
+		if (!applyTarget || !applyRevisionId.trim()) {
+			notify.error('Укажите revision_id');
+			return;
+		}
+		applyingId = applyTarget.id;
+		try {
+			await apiMutate(`/v1/speakers/${applyTarget.id}/apply`, 'POST', {
+				revision_id: applyRevisionId.trim()
+			});
 			notify.success('Apply запущен');
+			applyDialogOpen = false;
 		} catch (e) {
 			notifyApiError(e);
 		} finally {
@@ -78,20 +250,25 @@
 	}
 
 	async function save() {
-		if (!form.endpoint.trim()) {
+		const body = buildApiBody(form);
-			notify.error('Укажите endpoint');
+		if (!body.endpoint.trim()) {
+			notify.error('Укажите endpoint или agent domain');
 			return;
 		}
 		saving = true;
 		try {
 			if (editTarget) {
-				await apiMutate(`/v1/speakers/${editTarget.id}`, 'PATCH', form);
+				await apiMutate(`/v1/speakers/${editTarget.id}`, 'PATCH', body);
 				notify.success('Спикер обновлён');
+				dialogOpen = false;
 			} else {
-				await apiMutate('/v1/speakers', 'POST', form);
+				const created = await apiMutate<SpeakerRow>('/v1/speakers', 'POST', body);
 				notify.success('Спикер создан');
+				dialogOpen = false;
+				createdSpeaker = created;
+				composeText = await buildComposeSnippet(created);
+				wizardOpen = true;
 			}
-			dialogOpen = false;
 			await onRefresh();
 		} catch (e) {
 			notifyApiError(e);
@@ -99,6 +276,17 @@
 			saving = false;
 		}
 	}
+
+	async function copyAgentSecret() {
+		const secret = createdSpeaker?.agent_secret;
+		if (!secret) return;
+		try {
+			await navigator.clipboard.writeText(secret);
+			notify.success('agent_secret скопирован');
+		} catch {
+			notify.error('Не удалось скопировать');
+		}
+	}
 </script>
 
 <Card>
@@ -107,7 +295,9 @@
 	>
 		<div class="min-w-0 flex-1">
 			<CardTitle class="text-base">Спикеры</CardTitle>
-			<CardDescription>BIRD-агенты, применяющие конфигурацию на нодах</CardDescription>
+			<CardDescription
+				>Удалённые BIRD-ноды (Remnawave-style Panel→Node + signed bundle)</CardDescription
+			>
 		</div>
 		<div class="flex shrink-0 flex-wrap items-center justify-end gap-2">
 			<Button size="sm" onclick={openCreate}><Plus />Добавить</Button>
@@ -121,28 +311,32 @@
 			loading={initialLoading || loading}
 			{error}
 			emptyTitle="Нет спикеров"
-			emptyDescription="Добавьте BIRD-агент для применения конфигурации."
+			emptyDescription="Добавьте реплику для применения signed bundle."
 		>
 			{#snippet cell({ row: s, column })}
-				{#if column.id === 'endpoint'}
+				{#if column.id === 'status'}
-					<span class="font-mono text-sm">{s.endpoint}</span>
+					<Badge variant={statusVariant(s)}>{statusLabel(s)}</Badge>
+				{:else if column.id === 'agent_domain'}
+					<span class="font-mono text-sm">{s.agent_domain ?? s.endpoint}</span>
 				{:else if column.id === 'role'}
 					<Badge variant="outline">{s.role}</Badge>
-				{:else if column.id === 'last_applied_revision_id'}
+				{:else if column.id === 'drift'}
-					<span class="font-mono text-xs text-muted-foreground">
+					<span class="font-mono text-xs text-muted-foreground" title="applied / published">
-						{s.last_applied_revision_id ? s.last_applied_revision_id.slice(0, 8) + '…' : '—'}
+						{driftLabel(s)}
 					</span>
 				{:else if column.id === 'actions'}
-					<div class="flex gap-1">
+					<div class="flex flex-wrap gap-1">
+						<Button variant="outline" size="xs" title="Copy compose" onclick={() => openCompose(s)}>
+							<Copy class="size-3" />
+						</Button>
 						<Button
 							variant="outline"
 							size="xs"
-							title="Запустить применение ревизии на спикере"
+							title="Apply revision (canary)"
-							onclick={() => applySpeaker(s.id)}
+							onclick={() => openApply(s)}
 							disabled={applyingId === s.id}
 						>
 							<Play class="size-3" />
-							{applyingId === s.id ? 'Apply…' : 'Apply'}
 						</Button>
 						<Button variant="ghost" size="icon-sm" onclick={() => openEdit(s)}>
 							<Pencil class="size-3.5" />
@@ -155,16 +349,44 @@
 </Card>
 
 <Dialog bind:open={dialogOpen}>
-	<DialogContent class="sm:max-w-sm">
+	<DialogContent class="sm:max-w-md">
 		<DialogHeader>
 			<DialogTitle>{editTarget ? 'Редактировать спикера' : 'Новый спикер'}</DialogTitle>
 		</DialogHeader>
 		<div class="space-y-4 py-2">
-			<FormField label="Endpoint" id="s-endpoint" required>
+			<FormField label="Agent domain (FQDN)" id="s-domain">
-				<AppInput id="s-endpoint" placeholder="http://bird-agent:8081" bind:value={form.endpoint} />
+				<AppInput id="s-domain" placeholder="bgp-dc2.example.com" bind:value={form.agent_domain} />
 			</FormField>
+			<FormField label="Endpoint" id="s-endpoint">
+				<AppInput
+					id="s-endpoint"
+					placeholder="https://bgp-dc2.example.com"
+					value={form.endpoint}
+					oninput={(e) => onEndpointChange((e.currentTarget as HTMLInputElement).value)}
+				/>
+			</FormField>
+			<FormField label="IP ноды (IPv4)" id="s-node-ip">
+				<AppInput
+					id="s-node-ip"
+					placeholder="203.0.113.10"
+					value={form.node_ipv4}
+					oninput={(e) => onNodeIPv4Change((e.currentTarget as HTMLInputElement).value)}
+				/>
+			</FormField>
+			<FormField label="BGP source IPv4" id="s-bgp-src">
+				<AppInput
+					id="s-bgp-src"
+					placeholder="= IP ноды"
+					bind:value={form.bird_bgp_source_ipv4}
+					disabled={!form.bgpSourceManual}
+				/>
+			</FormField>
+			<label class="flex items-center gap-2 text-sm">
+				<Checkbox bind:checked={form.bgpSourceManual} />
+				Задать BGP source вручную
+			</label>
 			<FormField label="Роль" id="s-role">
-				<AppInput id="s-role" placeholder="operator" bind:value={form.role} />
+				<AppInput id="s-role" placeholder="replica" bind:value={form.role} />
 			</FormField>
 		</div>
 		<DialogFooter>
@@ -175,3 +397,74 @@
 		</DialogFooter>
 	</DialogContent>
 </Dialog>
+
+<Dialog bind:open={wizardOpen}>
+	<DialogContent class="sm:max-w-lg">
+		<DialogHeader>
+			<DialogTitle>Спикер создан</DialogTitle>
+			<DialogDescription>
+				Сохраните agent_secret — он больше не отображается. Скопируйте compose на VPS реплики.
+			</DialogDescription>
+		</DialogHeader>
+		{#if createdSpeaker?.agent_secret}
+			<FormField label="agent_secret (один раз)" id="w-secret">
+				<div class="flex gap-2">
+					<AppInput
+						id="w-secret"
+						readonly
+						value={createdSpeaker.agent_secret}
+						class="font-mono text-xs"
+					/>
+					<Button variant="outline" size="icon-sm" onclick={copyAgentSecret}><Copy /></Button>
+				</div>
+			</FormField>
+		{/if}
+		<FormField label="docker-compose env" id="w-compose">
+			<textarea
+				id="w-compose"
+				class="min-h-[200px] w-full rounded-md border bg-muted/30 p-2 font-mono text-xs"
+				readonly
+				value={composeText}
+			></textarea>
+		</FormField>
+		<DialogFooter>
+			<Button variant="outline" onclick={copyCompose}><Copy />Copy compose</Button>
+			<Button onclick={() => (wizardOpen = false)}>Готово</Button>
+		</DialogFooter>
+	</DialogContent>
+</Dialog>
+
+<Dialog bind:open={applyDialogOpen}>
+	<DialogContent class="sm:max-w-sm">
+		<DialogHeader>
+			<DialogTitle>Apply на спикер</DialogTitle>
+		</DialogHeader>
+		<FormField label="revision_id" id="a-rev" required>
+			<AppInput id="a-rev" bind:value={applyRevisionId} class="font-mono text-xs" />
+		</FormField>
+		<DialogFooter>
+			<Button variant="outline" onclick={() => (applyDialogOpen = false)}>Отмена</Button>
+			<Button onclick={applySpeaker} disabled={applyingId != null}>Apply</Button>
+		</DialogFooter>
+	</DialogContent>
+</Dialog>
+
+<Dialog bind:open={composeDialogOpen}>
+	<DialogContent class="sm:max-w-lg">
+		<DialogHeader>
+			<DialogTitle>Copy docker-compose</DialogTitle>
+			<DialogDescription
+				>Спикер {composeTarget?.agent_domain ?? composeTarget?.id}</DialogDescription
+			>
+		</DialogHeader>
+		<textarea
+			class="min-h-[240px] w-full rounded-md border bg-muted/30 p-2 font-mono text-xs"
+			readonly
+			value={composeText}
+		></textarea>
+		<DialogFooter>
+			<Button variant="outline" onclick={copyCompose}><Copy />Копировать</Button>
+			<Button onclick={() => (composeDialogOpen = false)}>Закрыть</Button>
+		</DialogFooter>
+	</DialogContent>
+</Dialog>

web/src/lib/ui/app/layout/nav.ts

@@ -7,6 +7,7 @@ import Gauge from '@lucide/svelte/icons/gauge';
 import LayoutDashboard from '@lucide/svelte/icons/layout-dashboard';
 import Network from '@lucide/svelte/icons/network';
 import Settings from '@lucide/svelte/icons/settings';
+import Shield from '@lucide/svelte/icons/shield';
 export type NavItem = {
 	href: string;
 	label: string;
@@ -23,4 +24,7 @@ export const mainNav: NavItem[] = [
 	{ href: '/monitoring', label: 'Мониторинг', icon: Gauge }
 ];
 
-export const bottomNav: NavItem[] = [{ href: '/settings', label: 'Настройки', icon: Settings }];
+export const bottomNav: NavItem[] = [
+	{ href: '/access', label: 'Права доступа', icon: Shield },
+	{ href: '/settings', label: 'Настройки', icon: Settings }
+];

web/src/routes/access/+page.svelte

@@ -0,0 +1,113 @@
+<script lang="ts">
+	import { resolve } from '$app/paths';
+	import { onMount } from 'svelte';
+	import { apiJSON } from '$lib/api/client.js';
+	import type { ApiKey, ApiKeysResponse, AuthSession } from '$lib/api/types.js';
+	import {
+		Card,
+		CardContent,
+		CardDescription,
+		CardHeader,
+		CardTitle
+	} from '$lib/ui/core/card/index.js';
+	import { notifyApiError } from '$lib/ui/app/toast.js';
+	import AccessApiKeysCard from '$lib/components/access/AccessApiKeysCard.svelte';
+	import Shield from '@lucide/svelte/icons/shield';
+	import PageHeader from '$lib/ui/app/page-header/page-header.svelte';
+
+	let session = $state<AuthSession | null>(null);
+	let apiKeys = $state<ApiKey[]>([]);
+	let keysLoading = $state(false);
+	let keysInitial = $state(true);
+	let keysError = $state<string | null>(null);
+
+	const isOperator = $derived(session?.role === 'operator');
+
+	async function loadSession() {
+		try {
+			session = await apiJSON<AuthSession>('/v1/auth/session');
+		} catch {
+			session = null;
+		}
+	}
+
+	async function loadApiKeys() {
+		keysLoading = true;
+		keysError = null;
+		try {
+			const page = await apiJSON<ApiKeysResponse>('/v1/api-keys?limit=500');
+			apiKeys = page.items ?? [];
+		} catch (e) {
+			apiKeys = [];
+			keysError = e instanceof Error ? e.message : 'Ошибка загрузки';
+			notifyApiError(e);
+		} finally {
+			keysLoading = false;
+			keysInitial = false;
+		}
+	}
+
+	onMount(() => {
+		void (async () => {
+			await loadSession();
+			if (session?.role === 'operator') await loadApiKeys();
+			else keysInitial = false;
+		})();
+	});
+</script>
+
+<div class="mx-auto flex max-w-4xl flex-col gap-6">
+	<PageHeader
+		title="Права доступа"
+		description="API-ключи control plane и текущая сессия Bearer-токена."
+		icon={Shield}
+		iconClass="bg-primary/10 text-primary"
+	/>
+
+	{#if session}
+		<Card>
+			<CardHeader>
+				<CardTitle class="text-base">Текущая сессия</CardTitle>
+				<CardDescription>Tenant и роль ключа, с которым открыта панель.</CardDescription>
+			</CardHeader>
+			<CardContent class="grid gap-3 text-sm sm:grid-cols-2">
+				<div>
+					<p class="text-muted-foreground">Tenant</p>
+					<p class="font-mono text-xs break-all">{session.tenant_id}</p>
+				</div>
+				<div>
+					<p class="text-muted-foreground">Роль</p>
+					<p class="font-mono">{session.role}</p>
+				</div>
+			</CardContent>
+		</Card>
+	{/if}
+
+	{#if isOperator}
+		<AccessApiKeysCard
+			items={apiKeys}
+			loading={keysLoading}
+			initialLoading={keysInitial}
+			error={keysError}
+			onRefresh={loadApiKeys}
+		/>
+	{:else if session}
+		<Card>
+			<CardContent class="py-6 text-sm text-muted-foreground">
+				Управление API-ключами доступно только роли <strong>operator</strong>. Текущая роль:
+				<span class="font-mono">{session.role}</span>. Для выдачи ключей войдите с operator-ключом
+				или создайте ключ через API / переменную <code class="text-xs">EVOBGP_API_KEYS</code>.
+			</CardContent>
+		</Card>
+	{:else}
+		<Card>
+			<CardContent class="py-6 text-sm text-muted-foreground">
+				Не удалось определить сессию. Укажите Bearer-токен в
+				<a href={resolve('/settings')} class="text-primary underline-offset-4 hover:underline"
+					>настройках</a
+				>
+				интерфейса.
+			</CardContent>
+		</Card>
+	{/if}
+</div>

web/src/routes/settings/+page.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
 	import { browser } from '$app/environment';
+	import { resolve } from '$app/paths';
 	import { onMount } from 'svelte';
 	import { TOKEN_STORAGE_KEY } from '$lib/api/client.js';
 	import { themeState } from '$lib/theme-preferences.svelte.js';
@@ -53,23 +54,24 @@
 <div class="mx-auto flex max-w-3xl flex-col gap-6">
 	<PageHeader
 		title="Настройки"
-		description="Параметры браузера и подключения к API."
+		description="Параметры интерфейса и подключения браузера к API."
 		icon={SettingsIcon}
 		iconClass="bg-muted text-muted-foreground"
 	/>
 
 	<Card>
 		<CardHeader>
-			<CardTitle>API-ключ</CardTitle>
+			<CardTitle>Подключение к API</CardTitle>
 			<CardDescription>
-				Bearer-токен хранится только в localStorage браузера. Для локального демо с
+				Bearer-токен хранится только в этом браузере (localStorage). Управление ключами tenant — в
-				<code class="text-xs">EVOBGP_DEV_INSECURE=1</code> используйте токен
+				разделе <a href={resolve('/access')} class="text-primary underline-offset-4 hover:underline"
-				<code class="text-xs">dev</code>.
+					>Права доступа</a
+				>.
 			</CardDescription>
 		</CardHeader>
 		<CardContent class="space-y-4">
 			<div class="space-y-2">
-				<Label for="token">Токен</Label>
+				<Label for="token">Токен для запросов</Label>
 				<Input
 					id="token"
 					type="password"