Учётные данные и безопасность n8n (официально)
Use when handling any auth, API keys, tokens, OAuth, bearer tokens, basic auth, or secret values in n8n workflows. Triggers on
AIn8n-io
official
Разработка
Что делает навык
Навык обеспечивает безопасное управление учетными данными в n8n, запрещая хранение секретов в текстовых полях и требуя использования встроенной системы credentials. Он гарантирует корректное привязывание учетных данных к узлам через их ID и указывает пользователю на необходимость ручного создания учетных записей в интерфейсе.
Когда применять
- Настройка аутентификации для нативных узлов (Slack, Gmail, Postgres, OpenAI) с использованием их родных типов учетных данных.
- Привязка существующих учетных данных к узлам в workflow путем вызова list_credentials и привязки по ID.
- Использование типа httpCustomAuth для аутентификации с несколькими заголовками или комбинацией заголовков и параметров запроса.
- Предотвращение хардкода API-ключей, токенов или паролей в узлах Set или SDK-коде.
Как работает
- Вызовите list_credentials({type}) перед настройкой узла, требующего аутентификации, чтобы получить список доступных учетных записей.
- Если найден один совпадающий тип, привяжите его через newCredential('Label', 'credId') при создании узла или через setNodeCredential при обновлении workflow.
- Если найдено несколько совпадений, запросите у пользователя выбор конкретной учетной записи.
- Избегайте использования одноаргументного newCredential('Label'), так как это создает плейсхолдер, который n8n может неверно разрешить при наличии нескольких записей.
- Информируйте пользователя о точном типе учетных данных, который необходимо создать в UI, так как создание учетных записей программно недоступно.
- Не принимайте секреты в чате для последующей настройки и не используйте текстовые поля для хранения токенов.
Примеры запросов агенту
Настрой аутентификацию для узла Slack, используя существующие учетные данные.
Привяжи учетную запись Postgres к узлу базы данных, убедившись, что она указана по ID.
Используй httpCustomAuth для узла HTTP Request с кастомной аутентификацией.
Что понадобится
- Доступ к n8n MCP (Model Context Protocol) для вызова list_credentials и управления workflow.
- Существующие учетные данные, созданные пользователем в интерфейсе n8n.
- Файл references/CUSTOM_CREDENTIALS.md для справки по типу httpCustomAuth.
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «n8n-credentials-and-security-official» из репозитория:
# https://github.com/n8n-io/skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r n8n-credentials-and-security-official/ ~/.claude/skills/n8n-credentials-and-security-official/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.