145 lines
6.3 KiB
Markdown
145 lines
6.3 KiB
Markdown
# 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` — система обновлений
|