Academy
Administração do Sistema

Cadastro de Credenciais

O Cadastro de Credenciais é a tela que centraliza as credenciais de conexão da plataforma — os acessos a ERPs, bancos de dados, storages e APIs que as etapas dos processos usam para importar e exportar dados. Cadastrada uma vez, a credencial é reutilizada em quantas etapas e processos forem necessários, com os segredos protegidos e o uso controlado por perfis. A tela fica em Configurações > Configurações Gerais > Credenciais.

Tipos de credencial

As credenciais são organizadas em quatro categorias, que correspondem às integrações da plataforma:

  • Banco de Dados: conexões usadas pelas etapas Banco de Dados (importação) e Exportação Banco de Dados.

  • ERP: acessos dos conectores nativos usados pela etapa ERP (SAP, Dynamics, Oracle, Sankhya).

  • Armazenamento: conexões de storage (ex.: SFTP) usadas na troca automática de arquivos.

  • API: acessos a APIs externas.

A tela de lista

  • Buscar por nome e filtros de Tipo de credencial e Status refinam a lista.

  • Colunas: Nome, Tipo (com o ícone do conector), Processos (quantos processos usam a credencial — passe o mouse para ver o código e o nome de cada um), Perfis (quantos perfis de privacidade têm acesso — o mouse revela quais) e Status (Ativo ou Inativo).

  • O menu de ações de cada linha traz Editar, Ativar/Desativar e Excluir.

Atenção: ativar e desativar não pedem confirmação — o status muda na hora. Desativar não altera os processos que usam a credencial, mas ela deixa de poder ser selecionada nas etapas e as execuções que dependem dela passam a falhar até a reativação.

Criar uma credencial

  1. Clique em Nova credencial.

  2. No diálogo Selecionar tipo de credencial, navegue pelas abas de categoria (Todos, Banco de Dados, ERP, Armazenamento, API) ou use a busca, e escolha o tipo. O tipo não pode ser trocado depois — para mudar, crie outra credencial.

  3. Preencha o formulário:

  • Nome da credencial — obrigatório e único.

  • Campos do tipo — variam por conector (endereço, usuário, senha, chaves); os obrigatórios vêm marcados com asterisco.

  • Perfis de privacidade — obrigatório ao menos um. São eles que definem quais perfis de usuário podem ver e usar a credencial; usuários fora dos perfis selecionados não a encontram nas etapas.

  1. Clique em Salvar.

  2. Com a credencial salva, use Testar conexão (disponível nos tipos que suportam teste) para validar o acesso — o resultado aparece na própria tela, em verde no sucesso ou em vermelho com a mensagem de erro. Alterações pendentes são salvas automaticamente antes do teste.

Tipos que possuem guia próprio de configuração exibem o botão Documentação no cabeçalho do editor, que abre o material de apoio em nova aba.

Segurança dos dados sensíveis

  • Senhas, segredos e chaves são criptografados no armazenamento e nunca são exibidos de volta — na edição, os campos sensíveis aparecem mascarados.

  • Ao editar, deixe o campo sensível em branco para manter o valor salvo; preencha apenas se quiser substituir o segredo.

  • Credenciais inativas não podem ser editadas — reative antes de alterar.

  • A revogação de um acesso é imediata: Desativar na própria tela (ou desativar o usuário de integração no sistema de origem).

Vínculos com processos

A coluna Processos mostra onde cada credencial está em uso. Uma credencial vinculada a processos não pode ser excluída — o diálogo de exclusão exibe a lista dos processos e orienta: "Esta credencial está vinculada a processos e não pode ser excluída. Remova os vínculos antes de excluir". O desvínculo é feito nos próprios processos, trocando a credencial nas etapas que a utilizam; para interromper o uso imediatamente sem excluir, desative-a.

Uso nas etapas dos processos

Nas etapas que consomem credenciais (ERP, Banco de Dados, Exportação Banco de Dados), o seletor mostra apenas as credenciais da categoria correspondente que os seus perfis permitem usar. Do próprio seletor é possível criar uma nova credencial (atalho "+ Nova credencial") ou editar uma existente, sem sair da etapa. Credenciais inativas aparecem desabilitadas na lista — a etapa ERP, por exemplo, avisa: "A credencial selecionada está inativa. Ative-a para continuar."

Permissões de acesso

O acesso à tela tem dois níveis:

  • Leitura: vê a lista, a busca, os filtros e os vínculos — com as ações desabilitadas.

  • Escrita: cria, edita, ativa/desativa e exclui credenciais; também habilita os atalhos de criar e editar credencial dentro das etapas dos processos.

Usuários sem a permissão não veem o item no menu de Configurações.

Exemplo de utilização

O time de dados cadastra uma credencial do tipo SQL Server com o usuário de leitura fornecido pela TI, valida com Testar conexão e restringe os perfis de privacidade ao time financeiro. A mesma credencial passa a ser selecionada na etapa Banco de Dados de três processos diferentes — e, quando a senha rotaciona, a atualização em um único lugar vale para todos.

Artigos relacionados

  • Introdução às integrações

  • Etapa ERP

  • Etapa Banco de Dados

  • Etapa Exportação Banco de Dados

  • Conectar storages externos (SFTP, SharePoint, OneDrive)

Isso foi útil?