Credenciais

Credenciais armazenam informações de conexão de forma segura e centralizada. Em vez de colocar senhas e tokens diretamente nos nós, você cria uma credencial e a referencia nos fluxos.

Gerenciando Credenciais

1. No menu lateral, clique em Credenciais
2. A lista exibe todas as credenciais cadastradas

Imagem: Tela de credenciais com lista mostrando nome, tipo e data de criação

Criando uma Credencial

1. Clique em + Nova Credencial
2. Selecione o tipo de credencial
3. Preencha os campos específicos do tipo
4. (Opcional) Clique em Testar Conexão para verificar
5. Clique em Salvar

Tipos de Credenciais

HTTP / API

Para conexões com APIs REST.

Uso no nó HTTP Request: Selecione a credencial e informe apenas o path:

Credencial: "API Exemplo"
URL: /api/users  (o URL base é adicionado automaticamente)

Override por Pipeline — Enterprise

Na integração de CI/CD do QANode Enterprise, campos específicos de uma credencial podem ser sobrescritos apenas para a execução atual.

Exemplo:

npx @qanode/cli run scenario \
  --scenario-id SCENARIO_ID \
  --credential api-main.token=$API_TOKEN \
  --wait

Esse padrão é útil para:

• tokens efêmeros de pipeline
• segredos temporários de homologação
• endpoints de ambiente transitório

O valor salvo na credencial continua intacto após o término da execução.

Para detalhes, veja Overrides por Execução.

PostgreSQL

MySQL

MariaDB

Mesmos campos do MySQL.

Oracle

MongoDB

URI de exemplo:

mongodb://usuario:senha@host:27017/banco?authSource=admin
mongodb+srv://usuario:senha@cluster.mongodb.net/banco

SSH

Email

Credencial para conexão com caixas de e-mail via IMAP. Usada pelo nó Email Inbox.

Modo Password:

Para Gmail com senha, é obrigatório usar uma App Password — não a senha normal da conta. Gerar App Password

Modo OAuth2:

Após preencher Client ID e Secret, clique em Connect OAuth (Browser) para autorizar. Uma janela abrirá para login no provedor e, ao concluir, o Access Token e Refresh Token serão preenchidos automaticamente.

Gmail: cadastre o OAuth Callback URI exibido no campo como "URI de redirecionamento autorizado" no Google Cloud Console → Credenciais → OAuth 2.0.

Outlook: cadastre o URI como "Redirect URI" no Azure Portal → Registros de aplicativo → Autenticação.

Testando Conexão

Antes de usar uma credencial, teste a conexão:

1. Na tela de edição da credencial, clique em Testar Conexão
2. O QANode tentará se conectar usando os dados fornecidos
3. O resultado será exibido: sucesso ✅ ou erro ❌ com mensagem detalhada

Imagem: Credencial com botão de teste de conexão e mensagem de sucesso

Usando Credenciais nos Fluxos

Em Nós de Banco de Dados

No nó PostgreSQL, MySQL, MariaDB, Oracle ou MongoDB:

1. No campo Credencial, selecione a credencial
2. Os campos de conexão são preenchidos automaticamente
3. Configure apenas a query/operação

Em Nós HTTP Request

1. No campo Credencial, selecione a credencial HTTP
2. A URL base e a autenticação são aplicadas automaticamente
3. No campo URL, informe apenas o path

Em Nós SSH

1. No campo Credencial, selecione a credencial SSH
2. Os dados de conexão são aplicados automaticamente
3. Configure apenas os comandos

Segurança

• Senhas e tokens são criptografados no banco de dados
• Valores sensíveis são mascarados na interface
• Credenciais são acessíveis somente por usuários com permissão
• O proprietário da credencial pode editá-la; outros precisam de permissão de admin

Dicas

• Crie credenciais por ambiente — Produção, Staging, Dev
• Sempre teste a conexão antes de usar no fluxo
• Use nomes descritivos: "PostgreSQL Produção" é melhor que "pg1"
• Prefira credenciais em vez de colocar senhas diretamente nos nós
• Ao duplicar ambientes, crie novas credenciais para cada um