Criar uma chave de API de evidências
Crie uma chave somente leitura com os escopos de que sua plataforma de gestão precisa, rotacione-a ou revogue-a.
Antes de começar
Você precisa ser administrador da empresa.
Passos
Entre em Configurações → API e webhooks de evidências.
Em Chaves de API, clique em Nova chave.
Digite o Nome (por exemplo, «SofIA Gestión»).
Em Escopos, marque só o que a plataforma precisa ler.
Em Restrições, escolha quando ela Vence em: 90 dias, 180 dias, 1 ano, 2 anos ou Sem vencimento.
Se quiser que a chave leia só o que uma função vê, escolha a função em Limitar ao escopo de uma função. Se não, deixe Toda a empresa.
Se quiser limitar de onde ela é usada, marque Somente de alguns IPs ou redes e adicione cada IP ou rede (por exemplo, 200.1.2.3 ou 10.0.0.0/8) com Adicionar IP ou rede.
Clique em Criar.
Copie a Chave e entregue-a à plataforma de gestão. Clique em Concluído.
A chave é mostrada uma única vez. O ARGUNIS não consegue mostrá-la de novo.
Status de uma chave
Status | O que significa |
|---|---|
vigente | Funciona |
vence em breve | Vence em menos de 30 dias |
em rotação | Já tem uma chave nova que a substitui |
vencida | Passou do vencimento |
revogada | Deixou de funcionar |
Na tabela você também vê os escopos dela, de quais IPs ela é permitida, seu último uso (com o IP) e quantos pedidos fez em 24 horas. Clique em Ver revogadas para incluir as revogadas.
Rotacionar
Clique em Rotacionar na linha da chave.
Indique por quantas horas a chave atual continua vigente em A chave atual continua válida (horas).
Confirme e copie a nova chave.
É criada uma nova chave com os mesmos escopos; a atual vence ao terminar o prazo.
Revogar
Clique em Revogar e confirme com Revogar. O pedido seguinte com essa chave vai falhar, e não é possível desfazer.