diff --git a/10-systems/services/hard-panel.md b/10-systems/services/hard-panel.md index b1273c3..e008420 100644 --- a/10-systems/services/hard-panel.md +++ b/10-systems/services/hard-panel.md @@ -9,7 +9,7 @@ # hard-panel (GHard Monitor) -Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`). С версии 2026-10-04 (`b6080d0`, v1.30.0) — gnexus-auth (OAuth PKCE), health-чекер сервисов, журнал событий, интеграция с Gnexus Synapse, i18n (en/uk/ru), MCP-промпт `agent_guide`. +Панель мониторинга серверов: приём метрик от агентов hard-monitor, SQLite, ивенты, алерты, веб-интерфейс (Vue 3 + gnexus-ui-kit + chart.js). С версии 2026-09-11 — мониторинг сетевых дисков (NFS-шары через `os.statvfs`). С версии 2026-10-04 (`b6080d0`, v1.30.0) — gnexus-auth (OAuth PKCE), health-чекер сервисов, журнал событий, интеграция с Gnexus Synapse, i18n (en/uk/ru), MCP-промпт `agent_guide`. С `40a8810` — персональные MCP-ключи. - Репозиторий: `https://git.gnexus.space/root/hard-panel` (ветка `master`) - Хост: VM `service` на `hp-proliant-dl380-g6`, адрес `192.168.1.176` @@ -26,14 +26,16 @@ - UI: `http://192.168.1.176:8000/` (без логина; после включения gnexus-auth — вход через OAuth PKCE) - API: `http://192.168.1.176:8000/docs` (OpenAPI) - MCP: `http://192.168.1.176:8000/mcp` (streamable HTTP; тулы `panel_overview`, `server_details`, `server_history`, `services_overview`, `service_incidents`, `events_recent`; промпт `agent_guide` — инструкции агенту) +- MCP-ключи: страница `/mcp-keys` — выпуск и ревок персональных токенов `mcp_*` (plaintext показывается один раз, в БД sha256-хэш + хвост-хинт) - Логи: `docker logs ghard-panel` ## Важно про GHARD_ADMIN_TOKEN - Веб-интерфейс не умеет подписывать запросы токеном (`panel/frontend/src/api.js`): если токен задан, UI получает 401 и показывает пустой список серверов. -- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис (проверено 2026-10-04, форма сохранена). +- В `docker-compose.yml` дефолт `${GHARD_ADMIN_TOKEN:-change-me}` подставляет `change-me` даже при пустой переменной в `.env`. Локально исправлено на строгую форму `${GHARD_ADMIN_TOKEN-}` (2026-09-10) — при `git pull` проверить, не вернулся ли старый синтаксис (проверено 2026-10-04 дважды, форма сохранена). - Текущее состояние: токен пустой (API и UI открыты, доступ только из LAN). Если панель когда-нибудь выйдет в интернет — задать токен и закрыть `/mcp` на reverse proxy. - Старый сгенерированный токен хранится в gnexus-creds (секрет `hard-panel (192.168.1.176)`, поле `admin_token`) на случай, если токен снова включат. +- С `40a8810` токен работает как супер-токен для `/mcp` (гард `require_mcp`): персональный Bearer `mcp_*` ИЛИ статический `GHARD_ADMIN_TOKEN` ИЛИ браузерная cookie-сессия gnexus-auth. ## Update 2026-10-04 21:30 (navi rei) — auth, ui-kit 1.0, health-чекер, Synapse @@ -46,6 +48,15 @@ - Проверено после обновления: `/api/v1/health` ok, флот 19/19 online, агенты инжестят 200 OK, MCP initialize OK (GHard Monitor 1.30.0, 6 тулов + промпт agent_guide), `/mcp` без auth 406, SPA 200 с i18n-строками, synapse reporter корректно disabled (`GHARD_SYNAPSE_API_KEY` не задан). - Известное ожидаемое поведение: `/auth/login` → 500 `ConfigurationException: Invalid gnexus-auth base URL` — `GHARD_AUTH_BASE_URL` ещё не задан; привязка к gnexus-auth — следующий этап (владелец). +## Update 2026-10-04 23:55 (navi rei) — персональные MCP-ключи + +- Обновление `b6080d0..40a8810` (4 коммита, 16 файлов +834/−19): `14007e0` feat: персональные MCP-ключи (канон handbook mcp.md); `ca26b18` feat: страница «MCP-ключи» — выдача и ревок персональных токенов; `8b91999` docs: README — матрица доступа, API, ревок, блокировка; `40a8810` fix: кнопка «Выдать ключ» выровнена с полем ввода. +- Миграции идемпотентные при старте: `_try_alter` добавил `users.system_role` (снейпшот роли gnexus-auth) и `users.blocked` (вебхук user.blocked/deleted/archived); `CREATE TABLE IF NOT EXISTS mcp_tokens` (user_id, name, user_email, system_role, token_hash UNIQUE, token_hint, created_at, last_used_at, revoked_at) — применены, схема проверена PRAGMA. +- Гард `/mcp` заменён на `require_mcp`: персональный Bearer `mcp_*` (выпуск на `/mcp-keys`), статический `GHARD_ADMIN_TOKEN` (супер-токен), браузерная cookie-сессия gnexus-auth. +- docker-compose.yml апстримом не тронут — stash pop без конфликта, локальные правки сохранены; `.env.example` без изменений. +- Бэкап БД до обновления: `/data/hard-panel.db.bak-sqlite-20261004-2155-premcp` (1.6 GB, sqlite3 backup API, включает WAL). +- Проверено после обновления: `/api/v1/health` ok, флот 19/19 online (транзиентный offline после рестарта восстановился за ~90с), агенты инжестят 200 OK, MCP initialize OK, `/mcp-keys` 200, synapse reporter disabled как раньше. + ## Агенты (fleet, 2026-10-04) Агент hard-monitor установлен на все серверы home LAN. Все 19 серверов online (интервал 30 с): @@ -160,3 +171,4 @@ - 2026-09-11: обновление панели до версии с мониторингом шар (git pull, edb6cff). Смонтированы 4 NFS-шары (secraid5-jf, secraid5-cache, firstraid5, nettera8), проброшены в контейнер с `:slave`, добавлены в мониторинг — все online. - 2026-10-04: добавлен сервер `gnsynapse` (192.168.1.172, панель id 46) — агент установлен через scp из `/opt/hard-monitor-src` + `install.sh` (navi rei). Флот 19/19 online. - 2026-10-04: крупное обновление панели `edb6cff..b6080d0` (19 коммитов, v1.30.0): gnexus-auth (OAuth PKCE), ui-kit 1.0 Verdant, health-чекер сервисов, журнал событий, Synapse-интеграция, i18n, MCP agent_guide (navi rei). Бэкапы БД в volume; конфликт compose разрешён, локальные правки сохранены. +- 2026-10-04: обновление `b6080d0..40a8810` — персональные MCP-ключи: страница `/mcp-keys`, гард `require_mcp`, таблица `mcp_tokens`, миграции users (+system_role, +blocked) (navi rei). Бэкап снят, pull без конфликтов, флот 19/19.