Skip to main content
Cada fonte de alerta tem duas credenciais, geradas no momento da criação.

​
A URL

O idDaFonte é o identificador da fonte. A URL sozinha não autentica nada — sem o token, a requisição é recusada.

​
O token

Enviado no header:
O token é exibido uma única vez, na criação da fonte. O aciona.me guarda apenas um hash — não é possível recuperá-lo depois. Se você o perder, rotacione a credencial.

​
Escopo do token

O token vale apenas para aquela fonte. Um token vazado compromete uma origem de alertas, não a organização inteira — por isso vale a pena criar uma fonte por ferramenta e ambiente.

​
Onde guardar

Trate como qualquer credencial de produção:
  • Cofre de segredos ou secret manager (AWS Secrets Manager, SSM Parameter Store, Vault).
  • Campo de header seguro da própria ferramenta, quando ela oferecer (New Relic e Datadog mascaram headers customizados).
  • Nunca em repositório, dashboard compartilhado ou canal de chat.

​
Rotacionar o token

Rotacionar gera um token novo e invalida o anterior imediatamente. A ação está disponível para os papéis owner e admin.
1

Rotacione no painel

Em Fontes de alerta, na coluna Ações da tabela, clique em Rotacionar token na linha da fonte.
2

Confirme digitando o nome da fonte

O botão de confirmação só é habilitado quando você digita o nome exato da fonte. A comparação diferencia maiúsculas, minúsculas e acentos.
3

Copie o token novo na hora

O token aparece logo abaixo do formulário de criação, com botão de copiar. Ele é exibido uma única vez.
4

Atualize a ferramenta externa

Substitua o header X-Aciona-Token na configuração da ferramenta.
5

Envie um alerta de teste

Confirme que a resposta voltou a ser 202.
Entre a rotação e a atualização da ferramenta, os alertas daquela origem são recusados com 401. Faça a troca em uma janela em que você possa validar imediatamente.
A coluna Última rotação mostra quando o token foi rotacionado pela última vez e por quem. Quando a pessoa que rotacionou não faz mais parte da organização, a coluna exibe apenas a data e o rótulo autor indisponível.
Há um limite de rotações por hora para cada fonte. Se ele for atingido, a rotação é recusada e o token atual continua válido — nada muda até uma nova tentativa bem-sucedida.

​
Ativar e desativar a fonte

Uma fonte inativa recusa alertas com 403, sem perder o histórico já ingerido. É a forma correta de silenciar temporariamente uma origem barulhenta — melhor do que apagar a fonte, que quebra a configuração da ferramenta externa.

​
Limites de payload

O corpo da requisição tem limite de tamanho (por padrão, 1 MB). Payloads acima disso são recusados com 413. Se sua ferramenta envia payloads muito grandes, reduza os campos enviados no template.

Códigos de resposta do webhook