Credential

O bloco Credential entrega a um bloco downstream uma credencial OAuth para usar, sem expor o secret. Tem duas operações: Select Credential produz a referência de ID de uma credencial para outros blocos usarem; List Credentials retorna todas as credenciais OAuth do workspace (opcionalmente filtradas por provedor) como um array para iterar.

O bloco Credential produz referências de ID de credencial, não secrets. Blocos downstream recebem o ID e resolvem o token OAuth real com segurança durante a própria execução.

Configuração

Operation

Valor	Descrição
Select Credential	Escolha uma credencial OAuth e produza sua referência — use para ligar uma única credencial a blocos downstream
List Credentials	Retorna todas as credenciais OAuth do workspace como um array — use com um loop ForEach

Credential (operação Select)

Selecione uma credencial OAuth do seu workspace. O dropdown mostra todas as contas OAuth conectadas (Google, GitHub, Slack etc.).

No modo advanced, cole um credential ID diretamente. Você pode copiar um credential ID na página Credentials das settings do workspace.

Provider (operação List)

Filtre as credenciais OAuth retornadas por provedor. Selecione um ou mais provedores no dropdown — só aparecem provedores para os quais você tem credenciais. Deixe vazio para retornar todas as credenciais OAuth.

Exemplo	Retorna
Gmail	Só credenciais Gmail
Slack	Só credenciais Slack
Gmail + Slack	Credenciais Gmail e Slack

Saídas

Saída	Tipo	Descrição
`credentialId`	`string`	O credential ID — passe para os campos de credencial de outros blocos
`displayName`	`string`	Nome legível (ex.: "waleed@company.com")
`providerId`	`string`	ID do provedor OAuth (ex.: `google-email`, `slack`)

Saída	Tipo	Descrição
`credentials`	`json`	Array de objetos de credencial OAuth (veja a forma abaixo)
`count`	`number`	Número de credenciais retornadas

Cada objeto no array credentials:

Campo	Tipo	Descrição
`credentialId`	`string`	O credential ID
`displayName`	`string`	Nome legível
`providerId`	`string`	ID do provedor OAuth

Exemplos

Compartilhar uma credencial entre blocos

Selecione uma conta Google uma vez e referencie <credential.credentialId> nos blocos Gmail, Drive e Calendar. Mude a conta num só lugar e todos os blocos seguem.

Rotear para uma conta diferente por lógica

Um Condition escolhe a credencial de production ou staging a partir de uma variável de workflow, e o bloco Slack downstream posta com a que rodou.

Listar todas as contas e fazer fan-out

Credential (List, Provider: Gmail) → ForEach Loop → Gmail (Send) using <loop.currentItem.credentialId>

Como ligar um bloco Credential

Select Credential

Solte um bloco Credential e selecione sua credencial OAuth no picker
No bloco downstream, mude para advanced mode no campo de credencial
Informe <credentialBlockName.credentialId> como valor

A mesma referência funciona para qualquer bloco OAuth. No campo de credencial de um bloco Gmail ou Slack (advanced mode), informe <myCredential.credentialId>.

List Credentials

Solte um bloco Credential, defina Operation como List Credentials
Opcionalmente selecione um ou mais Providers para restringir os resultados (só seus provedores conectados aparecem)
Ligue <credentialBlockName.credentials> a um ForEach Loop como fonte de itens
Dentro do loop, referencie <loop.currentItem.credentialId> nos campos de credencial dos blocos downstream

Boas práticas

Defina uma vez, referencie muitas: Quando cinco blocos usam a mesma conta Google, use um bloco Credential e ligue os cinco a <credential.credentialId> em vez de selecionar a conta cinco vezes
Saídas são seguras para logar: A saída credentialId é uma referência UUID, não um secret. É seguro inspecionar nos logs de execução
Use para troca de ambiente: Combine com um bloco Condition para rotear para uma credencial OAuth de production ou staging com base numa variável de workflow
Advanced mode é obrigatório: Blocos downstream precisam estar em advanced mode no campo de credencial para aceitar uma referência dinâmica
Use List + ForEach para fan-out: Quando precisar rodar a mesma ação em todas as contas de um provedor, List Credentials alimenta naturalmente um loop ForEach
Restrinja por provedor: Use o multiselect Provider para filtrar serviços específicos — só provedores para os quais você tem credenciais são mostrados

Common Questions

Não. O bloco produz um credential ID (um UUID), não o token OAuth real. Blocos downstream recebem o ID e resolvem o token com segurança no próprio contexto de execução. Secrets nunca aparecem no estado do workflow, nos logs ou no canvas.

Só contas OAuth conectadas (Google, GitHub, Slack etc.). Variáveis de ambiente e service accounts não podem ser resolvidas por ID em blocos downstream, então não são suportadas.

Funcionalmente idêntico — ambos passam o mesmo credential ID ao bloco downstream. O bloco Credential agrega valor quando você precisa usar uma credencial em muitos blocos (mude uma vez), ou quando quer escolher entre credenciais dinamicamente com um bloco Condition.

Sim. Defina Operation como 'List Credentials'. Opcionalmente filtre por provedor com o multiselect Provider. Ligue a saída credentials a um loop ForEach para processar cada credencial individualmente.

Sim. Referencie <credential.credentialId> no código do bloco Function. Note que a função receberá a string UUID crua — se precisar do token resolvido, o bloco downstream precisa cuidar da resolução (como os blocos de integração fazem). O bloco Function não resolve credential IDs automaticamente.

A operação Select lança um erro em tempo de execução: 'Credential not found'. A operação List simplesmente omite a credencial excluída dos resultados. Atualize o bloco Credential para selecionar uma credencial válida antes de reexecutar.

Credential

Common Questions

On this page