Escopos, expiracao, rotacionar e revogar tokens
Controle o que cada chave de API pode fazer: limite permissoes com escopos, defina uma data de expiracao, rotacione ou revogue quando nao precisar mais.
Veja este passo no vídeo · Escopos: o que a chave pode fazer
Depois de saber criar uma chave de API, o proximo passo e gerenciar o ciclo de vida dela com seguranca: conceder apenas as permissoes necessarias, deixar expirar, rotacionar periodicamente e revogar quando deixar de usar.
Escopos (limites de permissao)
Os escopos definem o que a chave pode fazer. No editor eles aparecem agrupados:
- Contatos:
read:contacts,write:contacts - Mensagens:
read:messages,write:messages(enviar mensagens) - Canais:
read:channels - CRM:
read:crm,write:crm - Projetos:
read:projects,write:projects - Webhooks:
manage:webhooks - Acesso total:
admin(todos os escopos)
Se voce nao marcar nenhum escopo, a chave fica com acesso total (equivale a
*). Por seguranca, marque apenas as permissoes de que a integracao precisa — o principio do menor privilegio.
Expiracao
Em Expira em voce pode definir data e hora. Nesse momento a chave deixa de autenticar automaticamente. Se deixar em branco, a chave nao expira ate voce exclui-la. Recomendamos expiracao para credenciais de terceiros ou de teste.
Rotacionar uma chave (Regenerar)
Rotacionar significa substituir o segredo mantendo a mesma configuracao (nome, escopos, workspace, expiracao).
- Abra API Keys e clique em Editar na chave.
- Clique em Regenerar.
- A chave antiga e revogada e uma nova e emitida. Copie o novo valor na janela "Copie e salve agora" (exibida apenas uma vez).
- Atualize a integracao com o novo token.
Importante: ao regenerar, a chave anterior para de funcionar imediatamente. Planeje a troca para nao interromper o servico.
Revogar (excluir)
O Omnifox nao tem um estado "inativa": revogar = excluir.
- Na lista API Keys, localize a chave.
- Clique em Excluir e confirme.
A chave deixa de autenticar na hora e nao pode ser recuperada.
Boas praticas
- Rotacione as chaves de producao periodicamente (por exemplo, a cada 90 dias).
- Revogue imediatamente qualquer chave que suspeite estar comprometida.
- Uma chave por integracao, com escopos minimos e um nome claro.
Se nao funcionar
- Minha integracao parou apos regenerar: ela ainda usa o token antigo. Carregue o novo valor.
- Nao vejo o botao Regenerar/Excluir: voce precisa da permissao Gerenciar chaves de API.
Artigos relacionados
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.