Pular para o conteúdo principal

Chaves de webhook

Chaves de webhook ajudam sua ferramenta de recebimento a confiar que uma entrega de webhook veio de Atomicat. As chaves são segredos de longa duração, portanto, armazene-as em um gerenciador de senhas ou cofre secreto, não em capturas de tela ou registros de bate-papo.

Abra o modal​

  1. Vá para Formulário de entrega de webhook ou Quiz webhook delivery.
  2. Clique em API gerenciamento de chaves no cabeçalho.

A área principal segue o tipo de webhook que você está gerenciando. Webhooks de formulário e webhooks de teste podem usar chaves separadas.

Leia a orientação​

O produto explica que sua ferramenta de recebimento deve usar a chave para validar entregas de webhook. Uma nota secundária lembra você de manter a chave privada e alterná-la se houver suspeita de exposição.

Gerar ou girar​

  • Se nenhuma chave existir ainda, o botão principal exibirá Gerar chave API.
  • Depois que uma chave existe, o mesmo botão se torna Regenerar chave API, que invalida o segredo anterior quando o servidor aceita a rotação.
  • Um estado de carregamento mostra Gerando enquanto a chave é criada.

Copie a chave​

Quando uma chave está presente, ela aparece em um campo somente leitura com uma ação Copiar. Após a cópia, o botão mostra brevemente um estado check para que você saiba que a gravação na área de transferência foi bem-sucedida.

Práticas operacionais​

PráticaPor que é importante
Rodar dentro do cronogramaLimita o raio de explosão se uma chave vazar.
Chaves diferentes por ambienteDestinos de produção e teste não devem compartilhar segredos.
Verificar antes de processarRejeitar solicitações que não incluam a chave esperada.

Se sua configuração for personalizada, pergunte à sua equipe técnica qual cabeçalho ou regra de validação sua ferramenta de recebimento espera.

Documentos relacionados​

Perguntas frequentes​

As entregas antigas quebrarão imediatamente após a regeneração?

Qualquer nova tentativa em andamento ainda pode usar o antigo segredo até terminar. Planeje rotações durante janelas de baixo tráfego e atualize seu servidor antes ou em sincronia com a ação da UI.

A chave do webhook é igual ao meu login de usuário?

Não. Seu login identifica você como uma pessoa que usa Atomicat. As chaves de webhook ajudam sistemas externos a verificar entregas automatizadas de webhook.