Como receber eventos de webhook

Last updated: October 20, 2026

Em vez de consultar a API em busca de novidades, você pode fazer com que a Strike avise seus sistemas no momento em que algo acontece. As assinaturas de webhooks são gerenciadas em Settings → Webhooks.

O que você precisa

  • Uma URL nos seus próprios sistemas que possa receber os eventos da Strike.

  • A lista de eventos que você quer receber nela.

  • Uma API key da sua organização, que é a quem a assinatura pertence. Para mais detalhes, consulte Como criar e gerenciar API keys.

Os webhooks são a forma mais rápida de reagir a um achado: seu ticket pode estar aberto antes que alguém entre na plataforma.

Eventos que você pode assinar

  • Uma execução começa e uma execução termina. O evento de finalização inclui a distribuição dos achados por severidade.

  • Uma execução falha.

  • Uma Threat Emulation muda de status.

  • O resumo é publicado para uma execução concluída.

  • Uma vulnerabilidade é confirmada. Traz o achado completo, assim você pode abrir um ticket sem pedir mais nada.

  • Um Project muda de status.

Os payloads de webhook seguem as mesmas regras de visibilidade da plataforma e da API: sua equipe nunca recebe uma notificação sobre um achado que não pode ver.

Como configurar um

  1. Acesse Settings → Webhooks e crie uma assinatura.

  2. Informe a URL que vai receber os eventos e escolha os eventos que você quer.

  3. Copie o signing secret. Assim como uma API key, ele é exibido uma única vez.

  4. Envie um evento de teste para confirmar que seu endpoint o recebe.

Comece pelos eventos sobre os quais você vai agir. Você pode adicionar mais depois sem mexer nos que já funcionam.

Quando uma entrega falha

  • As entregas com falha são reenviadas automaticamente, com intervalos crescentes, durante cerca de uma hora.

  • Depois de dez falhas consecutivas, a assinatura é desativada e o dono da key é notificado por email.

  • Reative-a em Settings → Webhooks quando seu endpoint estiver funcionando.

O log de atividade de entregas mostra as últimas tentativas e o resultado de cada uma. É o lugar por onde começar quando um evento que você esperava nunca chegou.

Segurança

  • Cada entrega vem assinada, para que sua equipe possa verificar que ela veio da Strike antes de agir sobre ela.

  • O signing secret pode ser rotacionado a qualquer momento na assinatura.

  • Cada entrega traz um identificador único, assim uma nova tentativa nunca é processada duas vezes.