Подключения (Credentials)

Подключения хранят учетные данные для доступа к внешним сервисам.

Типы подключений

API Key

Простой ключ для доступа к API.

Параметры:

• API Key
• Header Name (обычно "Authorization" или "X-API-Key")

Пример использования:

Header: X-API-Key: your_api_key_here

OAuth2

Современный стандарт авторизации.

Параметры:

• Client ID
• Client Secret
• Authorization URL
• Access Token URL
• Scopes

Поддерживаемые сервисы:

• Google (Gmail, Sheets, Drive)
• GitHub
• Discord
• Slack

Basic Auth

Базовая HTTP аутентификация.

Параметры:

• Username
• Password

Token Auth

Bearer токен для API.

Параметры:

• Token

Использование:

Header: Authorization: Bearer your_token_here

Database Credentials

Подключение к базам данных.

PostgreSQL:

Host: localhost
Port: 5432
Database: mydb
User: username
Password: password
SSL: enabled

MySQL:

Host: localhost
Port: 3306
Database: mydb
User: username
Password: password

Управление подключениями

Создание подключения

1. Перейдите в "Credentials" в главном меню
2. Нажмите "+ New Credential"
3. Выберите тип подключения
4. Заполните параметры
5. Нажмите "Save"

Использование в нодах

1. Откройте настройки ноды
2. Найдите поле "Credential"
3. Выберите существующее или создайте новое
4. Нажмите "Test" для проверки

Безопасность

⚠️ Важно:

• Подключения шифруются в базе данных
• Никогда не передавайте credentials в открытом виде
• Используйте environment variables для чувствительных данных
• Регулярно обновляйте ключи и токены

Популярные интеграции

Google Services

Google Sheets

Type: OAuth2
Scopes: 
  - https://www.googleapis.com/auth/spreadsheets
  - https://www.googleapis.com/auth/drive

Gmail

Type: OAuth2
Scopes:
  - https://www.googleapis.com/auth/gmail.send
  - https://www.googleapis.com/auth/gmail.readonly

Discord

Type: OAuth2 или Webhook URL
Bot Token: для Discord Bot
Webhook URL: для Discord Webhook

Slack

Type: OAuth2
Scopes:
  - chat:write
  - channels:read
  - users:read

Telegram

Type: API Token
Bot Token: получить у @BotFather

GitHub

Type: OAuth2 или Personal Access Token
Scopes:
  - repo (для приватных репозиториев)
  - public_repo (для публичных)
  - workflow (для GitHub Actions)

Переменные окружения

Вместо хардкода credentials в нодах, используйте environment variables:

Настройка на сервере

export N8N_API_KEY="your_api_key"
export N8N_DB_PASSWORD="secure_password"

Использование в n8n

// В нодах
{{ $env.N8N_API_KEY }}

// В Code ноде
const apiKey = process.env.N8N_API_KEY;

Тестирование подключений

Встроенный тест

Большинство типов подключений имеют кнопку "Test":

• Проверяет валидность credentials
• Показывает детали ошибки
• Подтверждает успешное подключение

Ручное тестирование

Создайте тестовый воркфлоу:

Manual Trigger → HTTP Request (с credential) → Check Response

Обновление credentials

Когда обновлять

• Истек срок действия токена
• Изменились права доступа
• Обнаружена утечка ключа
• Ротация по расписанию (безопасность)

Как обновить

1. Перейдите в "Credentials"
2. Найдите нужное подключение
3. Нажмите "Edit"
4. Обновите параметры
5. Нажмите "Test" и "Save"

Шаринг credentials

В пределах instance

• Все пользователи видят одни credentials
• Нужен доступ к n8n для просмотра

Между instances

• Экспортируйте воркфлоу (credentials не включены)
• Создайте credentials вручную на новом instance
• Импортируйте воркфлоу и привяжите credentials

Troubleshooting

"Invalid credentials" ошибка

1. Проверьте правильность ключа/токена
2. Убедитесь, что не истек срок
3. Проверьте права доступа (scopes)
4. Проверьте URL и endpoints

"Authentication failed"

1. Для OAuth2: пройдите авторизацию заново
2. Проверьте Client ID и Secret
3. Убедитесь в правильности redirect URL

"Connection timeout"

1. Проверьте сетевое подключение
2. Убедитесь, что хост доступен
3. Проверьте firewall правила

Следующие шаги

• API документация
• Примеры воркфлоу