Что такое credentials

Credentials — это сохранённый в n8n допуск для подключения к внешнему сервису. Допуском служит ключ, логин с паролем или токен. Например, чтобы workflow мог обратиться к модели ИИ, ему нужен ключ этой модели.

Как это устроено:

1. Ключ один раз вносится в n8n и получает название, например «OpenAi account 2».

2. В настройках ноды workflow вы не вводите ключ, а просто выбираете credential из списка по его названию.

3. При запуске n8n сам берёт ключ из сохранённого credential и подставляет его в запрос.

Поэтому ключ нигде не виден в workflow и его не нужно копировать. Один и тот же credential можно использовать в любом количестве workflow.

Общие credentials корпоративного n8n

Credentials на корпоративном n8n общие для сотрудников. Их создают администраторы, и они доступны всем, у кого есть доступ к n8n.

Это значит, что:

• для начала работы не нужно создавать свой ключ к моделям, Nextcloud или базе данных — достаточно выбрать готовый credential из списка;

• если администратор меняет общий credential, это отражается на всех, кто его использует;

• персональные ключи хранить у себя или пересылать коллегам не нужно.

Где смотреть credentials:

• вкладка "Shared with you" — общие credentials, которые доступны вам;

• вкладка "Personal" — credentials, которые вы создали самостоятельно.

Если нужного credential нет во вкладке "Shared with you", значит доступа к нему пока нет. Запросите его, см. раздел «Если не хватает доступа» ниже.

Список credentials

OpenAi account 2

Нужен для работы с моделями OpenAI: текстовыми моделями и генерацией изображений.

BaseGeotechModelCreds

Нужен для работы с моделями эмбеддингов: они превращают текст в вектор для поиска по смыслу.

n8n LLM api key

Нужен для обращения к языковым моделям через ноду HTTP Request. Тип credential — Header Auth: ключ передаётся в заголовке запроса.

transcribe api key

Нужен для расшифровки аудио в текст (транскрибации) через ноду HTTP Request. Тип credential — Header Auth.

LiteLLM OCR New

Нужен для распознавания текста на изображениях и в PDF (OCR) через ноду LiteLLM OCR.

NextCloud account

Нужен для чтения и записи файлов в Nextcloud.

Postgres n8n

Нужен для подключения к базе данных PostgreSQL.

Что делать, если credential не подтянулся

Экспортированный JSON хранит ссылки на credentials, но в другой среде они могут не совпадать. Поэтому после импорта workflow проверьте каждую ноду с доступом к внешнему сервису (OpenAI, Nextcloud, PostgreSQL, LLM, OCR, транскрибация) и выберите нужный credential вручную.

Если в списке нет нужного credential, проверьте вкладку "Shared with you". Если его там нет, значит доступа пока нет.

Если не хватает доступа

• Доступ к файлам Nextcloud (cloud.ide-spb.com) запрашивается через заявку: https://helpdesk.ide-spb.com/Form/Render/10

• Доступ к остальным credentials и любые другие вопросы: alsu.yarulina@areal.ru