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. Порядок действий владельца
- Пользователь заполняет форму заявки.
- Владельцу приходит сообщение в Telegram от
@Auth_buryans_bot. - Владелец нажимает «Одобрить».
- В Authentik создаётся пользователь, приходит ссылка на вход (действует 24 часа).
- Владелец передаёт ссылку пользователю.
- Создаётся задача в 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— система обновлений