diff --git a/10-systems/hosts/tgclientmcp.md b/10-systems/hosts/tgclientmcp.md index 319607c..d7eba9d 100644 --- a/10-systems/hosts/tgclientmcp.md +++ b/10-systems/hosts/tgclientmcp.md @@ -56,13 +56,36 @@ и в gnexus-creds secret "tgclient-mcp Telegram API (api_id/api_hash)" (id d5d70390-a058-4399-add8-539d71c9e1de). Один набор на деплой — api_id идентифицирует приложение, не аккаунт. - - Всё ещё НЕ заполнены: TGCLIENT_ADMIN_TOKEN, TGCLIENT_AUTH_* (SSO), - TGCLIENT_SYNAPSE_*. + - **SSO gnexus-auth настроен 2026-10-05** (креды выдал владелец): + TGCLIENT_AUTH_BASE_URL=https://auth.gnexus.space, + TGCLIENT_AUTH_CLIENT_ID=gnx_207OcTjCYgqSQJwuTO2V5ks0EB1GftA0, + TGCLIENT_AUTH_REDIRECT_URI=https://tgclientmcp.gnexus.space/auth/callback, + client_secret и webhook secret — в .env и в gnexus-creds secret + "tgclient-mcp SSO gnexus-auth (OAuth client)" + (id 935a3ff1-f9c5-4738-9da5-83fdafb5fd70). + TGCLIENT_AUTH_ALLOWLIST пуст — пускается любой залогиненный gnexus-auth. + - Всё ещё НЕ заполнены: TGCLIENT_ADMIN_TOKEN, TGCLIENT_SYNAPSE_*. - GOTCHA: `TGCLIENT_API_ID=` пустая строка ломает pydantic int — при ротации не оставлять строку пустой, комментировать или вписывать число. - **Креды хоста:** gnexus-creds secret "tgclient-mcp host SSH (192.168.1.171)" (id 70fb91b3-85f0-479c-9ecb-ba009299417f). +## SSO flow (verified 2026-10-05) + +- `GET /auth/login` → 302 на + `https://auth.gnexus.space/oauth/authorize?response_type=code&client_id=…&redirect_uri=https%3A%2F%2Ftgclientmcp.gnexus.space%2Fauth%2Fcallback&state=…&code_challenge=…&code_challenge_method=S256&scope=openid+email+profile+roles+permissions&return_to=/` + (PKCE S256; gnexus-auth показывает страницу Sign in — клиент принят). +- `GET /auth/callback?code&state` — обмен кода (client_secret + PKCE + verifier), сессия в cookie (secure, т.к. redirect_uri https), redirect на + return_to. Фейковый state → 400 «Invalid or expired OAuth state». +- `POST /webhooks/gnexus-auth` (+ вариант с trailing slash) — события + gnexus-auth (HMAC-подпись через TGCLIENT_AUTH_WEBHOOK_SECRET); без подписи + → 401 «invalid webhook signature». +- Внутренние httpx-запросы к gnexus-auth идут с verify=False (сервис в LAN, + TLS терминируется на .226) — это осознанное решение из кода репо. +- Подключение агента: `claude mcp add --transport http tgclient + https://tgclientmcp.gnexus.space/mcp-protocol/ --header "Authorization: Bearer mcp_..."` + ## Deploy fixes (2026-10-05, rei) — баги в репо, исправлены локально на хосте 1. **backend/Dockerfile:** `COPY frontend/package.json frontend/.npmrc ./` — @@ -83,15 +106,12 @@ при `git pull` поверх могут затереться (проверять при обновлении). Стоит отправить в репозиторий. -## SSO / MCP-ключи (pending) +## Pending -- SSO gnexus-auth не настроен (TGCLIENT_AUTH_CLIENT_ID пуст) — сервис - работает в открытом режиме: все акки уходят локальному служебному юзеру. -- Персональные MCP-ключи `mcp_*` выпускаются на странице «MCP-ключи» SPA - (plaintext показывается один раз). Статический TGCLIENT_ADMIN_TOKEN — - супер-бэкдор для скриптов (роль superadmin), пока пуст. -- Подключение агента: `claude mcp add --transport http tgclient - https://tgclientmcp.gnexus.space/mcp-protocol/ --header "Authorization: Bearer mcp_..."` +- TGCLIENT_ADMIN_TOKEN пуст — статический супер-токен для скриптов (роль + superadmin) не задан; персональные MCP-ключи `mcp_*` выпускаются на + странице «MCP-ключи» SPA (plaintext показывается один раз). +- TGCLIENT_SYNAPSE_* пусты — отчёты в Synapse не настроены. ## Listening ports (TCP, verified 2026-10-05)