# Runbook: выдача доступов новому пользователю **Относится к:** F6-2 (Self-Service Registration) **Расположение:** n8n (CT 108), workflow `F6-2: Self-Service Registration` (id `dDhihSKtoZ4EE9jV`) --- ## 1. Как это устроено ``` Заявка (форма) ──POST──▶ /webhook/register-request │ ▼ уведомление владельцу в Telegram через бота доступов @Auth_buryans_bot │ владелец нажимает «Одобрить» / «Отклонить» │ ▼ /webhook/tg-callback (вебхук того же бота) │ ┌─────────┴─────────┐ ▼ ▼ Одобрено: создаём Отклонено: сообщаем пользователя в Authentik владельцу + ссылка на вход (24 ч) ``` **Ключевая деталь:** заявку обрабатывает **бот доступов**, потому что именно он отправляет уведомление. Кнопки работают только у того бота, который получает обновления. У `@Auth_buryans_bot` стоит вебхук: ``` https://n8n.buryans.ru/webhook/tg-callback ``` Если этот вебхук слетит — кнопки одобрения перестанут работать, при этом форма продолжит принимать заявки. --- ## 2. Порядок действий владельца 1. Пользователь заполняет форму заявки. 2. Владельцу приходит сообщение в Telegram от `@Auth_buryans_bot`. 3. Владелец нажимает «Одобрить». 4. В Authentik создаётся пользователь, приходит ссылка на вход (действует 24 часа). 5. Владелец передаёт ссылку пользователю. 6. Создаётся задача в Gitea с записью о выдаче доступа. --- ## 3. Проверка, что система жива ```bash # workflow существует и включён pct exec 108 -- docker exec n8n n8n list:workflow | grep 'F6-2' # вебхук бота доступов на месте AUTH=$(grep -m1 AUTH_TOKEN /root/bots-tokens.env | cut -d= -f2) curl -s -x http://192.168.1.10:10888 \ "https://api.telegram.org/bot${AUTH}/getWebhookInfo" | jq -r '.result.url' # ожидается: https://n8n.buryans.ru/webhook/tg-callback # сам вебхук отвечает (не 404) curl -s -o /dev/null -w '%{http_code}\n' -X POST \ https://n8n.buryans.ru/webhook/tg-callback -d '{}' ``` --- ## 4. Что ломается ### Кнопки одобрения не работают **Причина первая:** вебхук снят с бота доступов. Проверить командой выше. Вернуть: ```bash AUTH=$(grep -m1 AUTH_TOKEN /root/bots-tokens.env | cut -d= -f2) curl -s -x http://192.168.1.10:10888 -X POST \ "https://api.telegram.org/bot${AUTH}/setWebhook" \ -d 'url=https://n8n.buryans.ru/webhook/tg-callback' \ -d 'allowed_updates=["message","callback_query"]' ``` **Причина вторая:** бот доступов начали опрашивать вместо вебхука. Опрос и вебхук несовместимы — Telegram отдаёт обновления только одним способом. Проверить, кто опрашивает: ```bash pct exec 108 -- docker logs --tail 100 tg-admin-bot | grep -i 'polling\|Бот @' ``` Бот `@Adm_buryans_bot` (администратор) опрашивается намеренно, у него вебхука быть не должно. Бот доступов — наоборот: только вебхук. **Причина третья:** ошибка `TelegramConflictError: terminated by other getUpdates`. Значит, один и тот же бот и опрашивается, и имеет вебхук. ### Форма принимает заявку, но уведомление не приходит Проверить журнал n8n: ```bash pct exec 108 -- docker exec n8n n8n list:workflow | grep F6-2 pct exec 108 -- docker logs --tail 50 n8n | grep -i 'register-request' ``` ### Пользователь создан, но войти не может Ссылка на вход действует **24 часа**. Если истекла — создать заново: ```bash # в Authentik: Directory → Users → <пользователь> → Set password / Enrollment # либо через API, тем же способом, что и workflow ``` Проверить, что пользователь есть и в нужных группах: ```bash curl -s -H "Authorization: Bearer <токен Authentik>" \ 'http://192.168.1.114:9000/api/v3/core/users/?search=<логин>' | jq ``` --- ## 5. Учётные записи и роли Боты и их назначение — в `docs/BOTS.md`. Там же правило: **один бот — одна роль — одно место хранения токена.** Токены лежат в `/root/bots-tokens.env` (права 600) и в `D:\Buryans Hub\bots\` на закрытом компьютере. В Git токены не попадают. Учётные данные Authentik для workflow — в самом n8n, а не в файлах репозитория. Действующий токен, записанный прямо в теле workflow, — это утечка, такие случаи перечислены в `docs/SECRETS-ROTATION-PLAN.md`. --- ## 6. Связанные документы - `docs/BOTS.md` — роли ботов и правила хранения токенов - `docs/SECRETS-ROTATION-PLAN.md` — план смены секретов - `ops/runbooks/update-manager.md` — система обновлений