Проверка API-ключа в вебхуке — шаблон n8n
POST-запросы проходят проверку ключа в заголовке, прежде чем получить ответ с ID пользователя или ошибку доступа. workflow n8n связывает два вебхука и внутренний HTTP-запрос.
Оригинал на n8n.io: 🗲 Creating a Secure Webhook - MUST HAVE — Lucas Peyrin
Открыть шаблон на n8n.io бесплатно- Сложность
- средний8 видов узлов
- Просмотров на n8n.io
- 6 055
- Опубликован
- Обновлён
- Автор
- Lucas Peyrinпроверен n8n.io
- Сверено
Что делает шаблон
Вебхук возвращает ответ с ID пользователя при совпадении ключа из заголовка x-api-key со значением в списке зарегистрированных ключей. Если совпадения нет, запрос получает ответ 401 Unauthorized; успешный запрос получает 200 OK. Список с парами user_id и api_key служит имитацией базы данных, и его можно отредактировать. Для рабочей среды вместо этой части предлагается подключить узел базы данных, например Supabase, Postgres или Baserow. Входящий запрос использует метод POST.
Как работает workflow по шагам
- Webhook Secured Webhook принимает POST-запрос с ключом в заголовке x-api-key.
- Узел Check API Key передаёт полученный ключ внутренним HTTP-запросом вебхуку Get API Key.
- Узел Registered API Keys отдаёт список ключей, а фильтр ищет совпадение с переданным значением.
- Узел API Key Identified направляет запрос по ветке ответа: с ID пользователя при совпадении или с ошибкой 401 Unauthorized без него.
- Узел Respond to Webhook возвращает итоговый ответ отправителю.
Что нужно для запуска
- Учётные данные Header Auth для внутреннего обмена между вебхуками и HTTP-запросом
- Пары user_id и api_key для списка Registered API Keys
Как подключить сервисы к n8n
Создаётся учётная запись Header Auth с именем и значением для внутренней авторизации. Эти учётные данные выбираются в четырёх узлах вебхука и HTTP Request.
Что изменить под себя
- В узле Registered API Keys редактируется список пар user_id и api_key.
- Для рабочей среды имитация базы заменяется узлом Supabase, Postgres или Baserow.
Узлы workflow 8
- HTTP Request
- If
- Edit Fields (Set)
- Webhook
- Respond to Webhook
- Sticky Note
- Filter
- Split Out
Виды узлов, из которых собран сценарий, — как их перечисляет страница шаблона. Серым — служебные узлы n8n.
Автор и первоисточник
Сценарий «🗲 Creating a Secure Webhook - MUST HAVE» опубликовал на n8n.io Lucas Peyrin. Файл шаблона и авторское описание — на странице шаблона.
Русское описание написано языковой моделью по странице шаблона и прошло автоматическую проверку: в нём нет сервисов и чисел, которых нет у автора. Сценарий принадлежит автору; каталог его не хранит.