As chaves de integração autenticam as chamadas que outros sistemas fazem à API da Coodesh, como a integração com o seu ATS ou a exportação de dados do Datalake. Cada chave pertence a uma área de trabalho.
Para gerenciar as chaves, abra o menu da área de trabalho (logo da empresa, no canto superior esquerdo) e clique em Integrações. A página também fica em Configurações › Integrações.
Quem pode gerenciar as chaves
Criar, editar e excluir chaves exige a permissão Gerenciar chaves de integração. Administradores e Gerentes já têm essa permissão; ela também pode ser concedida individualmente a outras pessoas da área de trabalho.
Criar uma chave
Na seção Chaves de integração, clique em Nova Chave e preencha os campos:
Nome (obrigatório): um nome que identifique onde a chave é usada, por exemplo "Integração ATS".
Descrição: detalhes opcionais sobre a integração.
Provedor (obrigatório): a plataforma que vai usar a chave, como Gupy, Greenhouse, Lever ou InHire. Se a sua não estiver na lista, mantenha a opção padrão Coodesh.
Permissões (obrigatório): as ações que a chave pode executar: Listar, Ler, Criar, Atualizar e Excluir. Todas vêm marcadas; desmarque as que a integração não usa.
Clique em Salvar e continuar. A chave aparece na tela seguinte, com um botão para copiar.
A chave é exibida uma única vez. Copie agora e guarde em um local seguro, ou cole direto na plataforma de integração. Depois disso, a tabela mostra apenas uma versão mascarada da chave.
Recursos acessíveis
O campo Recursos acessíveis define quais grupos de endpoints a chave alcança, como os endpoints padrão e os do Datalake. Ele é configurado pela equipe da Coodesh.
Sem recursos definidos, a chave acessa os endpoints padrão da API, mas não os do Datalake. Se a sua integração precisar do Datalake, peça a liberação ao seu contato comercial ou ao suporte, informando o nome da chave. Veja Datalake: exportação de dados para BI e data warehouse.
Editar uma chave
Na tabela, clique em Editar na linha da chave. Você pode alterar:
Nome
Descrição
Provedor
Permissões
Por segurança, o valor da chave e o ID não podem ser alterados. Para trocar a chave, crie uma nova e exclua a antiga.
Excluir uma chave
Na tabela, clique em Excluir na linha da chave e confirme. A exclusão não pode ser desfeita, e as integrações que usam essa chave deixam de funcionar.
Perdeu sua chave?
Não é possível visualizar a chave novamente. Para recuperar o acesso:
Crie uma nova chave seguindo o passo a passo acima.
Atualize a integração com a chave nova.
Exclua a chave antiga.