Блок "Учетные данные" имеет две операции: Выбрать учетные данные выбирает одну OAuth-учетную запись и выводит ее ID-ссылку для последующих блоков; Список учетных данных возвращает все OAuth-учетные записи в рабочей области (опционально отфильтрованные по провайдеру) в виде массива для итерации.
Блок "Учетные данные" выводит ID-ссылки на учетные данные, а не секреты. Последующие блоки получают ID и безопасно разрешают фактический OAuth-токен во время своего собственного выполнения.
Параметры конфигурации
Операция
| Значение | Описание |
|---|---|
| Выбрать учетные данные | Выберите одну OAuth-учетную запись и выведите ее ссылку — используйте это для подключения одной учетной записи к последующим блокам |
| Список учетных данных | Верните все OAuth-учетные записи в рабочей области в виде массива — используйте это с циклом ForEach |
Учетные данные (операция Выбрать)
Выберите OAuth-учетную запись из вашей рабочей области. Выпадающий список показывает все подключенные OAuth-аккаунты (Google, GitHub, Slack и т.д.).
В расширенном режиме вставьте ID учетных данных напрямую. Вы можете скопировать ID учетных данных со страницы настроек "Учетные данные" вашей рабочей области.
Провайдер (операция Список)
Отфильтруйте возвращаемые OAuth-учетные данные по провайдеру. Выберите одного или нескольких провайдеров из выпадающего списка — будут показаны только провайдеры, для которых у вас есть учетные данные. Оставьте пустым, чтобы вернуть все OAuth-учетные данные.
| Пример | Возвращает |
|---|---|
| Gmail | Только учетные данные Gmail |
| Slack | Только учетные данные Slack |
| Gmail + Slack | Учетные данные Gmail и Slack |
Выходные данные
| Выход | Тип | Описание |
|---|---|---|
credentialId | string | ID учетных данных — передайте это в поля учетных данных других блоков |
displayName | string | Человекочитаемое имя (например, "waleed@company.com") |
providerId | string | ID OAuth-провайдера (например, google-email, slack) |
| Выход | Тип | Описание |
|---|---|---|
credentials | json | Массив объектов OAuth-учетных данных (см. структуру ниже) |
count | number | Количество возвращенных учетных данных |
Каждый объект в массиве credentials:
| Поле | Тип | Описание |
|---|---|---|
credentialId | string | ID учетных данных |
displayName | string | Человекочитаемое имя |
providerId | string | ID OAuth-провайдера |
Примеры использования
Общие учетные данные для нескольких блоков — Определите один раз, используйте везде
Credential (Select, Google) → Gmail (Send) & Google Drive (Upload) & Google Calendar (Create)Воркфлоу с несколькими аккаунтами — Маршрутизация к разным учетным данным на основе логики
Agent (Determine account) → Condition → Credential A or Credential B → Slack (Post)Итерация по всем аккаунтам Gmail
Credential (List, Provider: Gmail) → ForEach Loop → Gmail (Send) using <loop.currentItem.credentialId>
Как подключить блок "Учетные данные"
Выбрать учетные данные
- Добавьте блок Учетные данные и выберите вашу OAuth-учетную запись из селектора
- В последующем блоке переключитесь в расширенный режим в его поле учетных данных
- Введите
<credentialBlockName.credentialId>в качестве значения
В поле учетных данных блока Gmail (расширенный режим):
<myCredential.credentialId>В поле учетных данных блока Slack (расширенный режим):
<myCredential.credentialId>Список учетных данных
- Добавьте блок Учетные данные, установите Операцию в Список учетных данных
- Опционально выберите одного или нескольких Провайдеров для сужения результатов (появляются только ваши подключенные провайдеры)
- Подключите
<credentialBlockName.credentials>к циклу ForEach в качестве источника элементов - Внутри цикла ссылайтесь на
<loop.currentItem.credentialId>в полях учетных данных последующих блоков
Рекомендации
- Определите один раз, ссылайтесь много раз: Когда пять блоков используют один и тот же аккаунт Google, используйте один блок "Учетные данные" и подключите все пять к
<credential.credentialId>вместо выбора аккаунта пять раз - Выходные данные безопасны для логирования: Выход
credentialId— это UUID-ссылка, а не секрет. Безопасно проверять в логах выполнения - Используйте для переключения сред: Сочетайте с блоком "Условие" для маршрутизации к production или staging OAuth-учетным данным на основе переменной воркфлоу
- Требуется расширенный режим: Последующие блоки должны быть в расширенном режиме в их поле учетных данных, чтобы принимать динамическую ссылку
- Используйте Список + ForEach для fan-out: Когда вам нужно выполнить одно и то же действие для всех аккаунтов провайдера, "Список учетных данных" естественным образом передается в цикл ForEach
- Сужайте по провайдеру: Используйте мультивыбор Провайдера для фильтрации по конкретным сервисам — показываются только провайдеры, для которых у вас есть учетные данные