Credenciais

Quando um fluxo precisa falar com um sistema externo — o TOTVS RM, uma API, um banco de dados ou um servidor de e-mail — ele usa uma credencial cadastrada uma vez e reaproveitada pelos nós. Assim você não repete usuário e senha em cada fluxo, e os dados sensíveis ficam guardados de forma segura.

Tipos de credencial

Google Workspace não é a mesma coisa que Google Drive. São duas credenciais diferentes, e é o engano mais comum: os nós de arquivos e de compartilhamento do Drive pedem a credencial Google Drive; todos os outros nós do Google — Planilhas, Agenda, Gmail, Documentos e os demais — pedem a Google Workspace. A chave JSON pode até ser a mesma conta de serviço, mas cadastre-a nos dois tipos: cada nó só lista as credenciais do tipo que ele espera, e uma credencial cadastrada no tipo errado simplesmente não aparece na hora de escolher.

Cadastrando

1. Abra Credenciais no menu e escolha o tipo.
2. Dê um nome que ajude a reconhecê-la (ex.: "RM Produção") e preencha os campos.
3. Salve. A credencial passa a aparecer no seletor dos nós que a usam.

Ao editar uma credencial, os campos de senha, token e chave aparecem vazios: deixe em branco para manter o valor que já estava salvo, ou digite um valor novo para substituí-lo.

Conferindo se a credencial funciona

No menu de Ações de cada credencial da lista há Testar conexão: o NEXUS Flow fala com o serviço na hora e diz se os dados foram aceitos — um dado errado aparece aqui, e não no meio de um fluxo. Três tipos não têm essa verificação, e a própria tela explica o motivo:

• SMTP / E-mail — não há como conferir um envio sem enviar. Use o Enviar teste da tela da credencial: informe um destino e receba uma mensagem. Não precisa salvar antes.
• HTTP (autenticação) — o endereço de destino é escolhido em cada nó, então não há um lugar fixo a chamar.
• Banco local (via agente) — quem alcança o banco é o agente instalado na sua rede; a conferência acontece quando ele se conecta. Veja Agente local.

Duas telas trazem ainda um atalho próprio:

• Na credencial TOTVS RM, use Instalar sentenças no RM para preparar o seu RM para os nós do NEXUS Flow. Pode repetir quantas vezes precisar — o resultado é o mesmo. Se você trocou o Banco do RM, salve antes de instalar.
• Na credencial Modelo de linguagem (IA), use Testar conexão e listar modelos ainda no formulário: a chave é conferida na hora e a lista passa a mostrar os modelos que ela alcança, para você escolher um pelo nome em vez de digitá-lo de memória.

A credencial de IA que você cadastra aqui serve aos agentes e aos nós de IA. Já os assistentes do próprio editor — a documentação do fluxo e o apoio na escrita de código — dependem de um recurso habilitado na instalação: se eles seguirem indisponíveis depois de cadastrar a credencial, fale com o seu ponto focal na LBHM.

Usando num nó

Nos nós que exigem acesso externo há um campo credencial. Basta escolher a credencial certa pelo nome — o fluxo cuida do resto na hora de executar. Você pode ter várias credenciais do mesmo tipo (por exemplo, RM de produção e de homologação) e escolher a adequada em cada nó.

Segurança

Senhas, tokens e chaves são guardados de forma cifrada e não voltam preenchidos nos campos do formulário.

Há uma exceção: na credencial Oracle, a tela de edição monta a string de conexão completa, que inclui a senha em claro, para você conferir e copiar. Abra essa tela apenas em um ambiente confiável e evite projetá-la ou compartilhá-la em tela.

Compartilhe o acesso à ferramenta apenas com quem precisa administrar as automações.