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.

Jun 26, 2026

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).

  1. Abra API Keys e clique em Editar na chave.
  2. Clique em Regenerar.
  3. A chave antiga e revogada e uma nova e emitida. Copie o novo valor na janela "Copie e salve agora" (exibida apenas uma vez).
  4. 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.

  1. Na lista API Keys, localize a chave.
  2. 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp