Files

6.3 KiB

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. Проверка, что система жива

# 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. Что ломается

Кнопки одобрения не работают

Причина первая: вебхук снят с бота доступов. Проверить командой выше. Вернуть:

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 отдаёт обновления только одним способом. Проверить, кто опрашивает:

pct exec 108 -- docker logs --tail 100 tg-admin-bot | grep -i 'polling\|Бот @'

Бот @Adm_buryans_bot (администратор) опрашивается намеренно, у него вебхука быть не должно. Бот доступов — наоборот: только вебхук.

Причина третья: ошибка TelegramConflictError: terminated by other getUpdates. Значит, один и тот же бот и опрашивается, и имеет вебхук.

Форма принимает заявку, но уведомление не приходит

Проверить журнал n8n:

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 часа. Если истекла — создать заново:

# в Authentik: Directory → Users → <пользователь> → Set password / Enrollment
# либо через API, тем же способом, что и workflow

Проверить, что пользователь есть и в нужных группах:

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 — система обновлений