Files
buryan-infra/ops/runbooks/user-provisioning.md
T

145 lines
6.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` — система обновлений