Como receber alertas de CVE por webhook no seu sistema e conferir a assinatura (HMAC)
Receba as CVEs da sua stack num POST em JSON assinado com HMAC-SHA256, direto no SIEM, no SOAR ou no sistema de tickets, com o mesmo identificador em cada tentativa para não processar duas vezes.
O que você precisa
- Uma conta do Vexday com o plano SOC ou MSSP e as tecnologias cadastradas em Alertas.
- Um endereço https público no seu sistema, na porta 443 ou 8443, que aceite POST em JSON.
Passo a passo
Cadastre o endpoint
Em Alertas, na seção Destinos, escolha Endpoint JSON, cole a URL do seu sistema e clique em Cadastrar. Endereço de rede interna, IP privado ou porta fora da 443 e da 8443 é recusado.
Guarde o segredo
No cartão do endpoint, clique em Mostrar e copie o segredo para o seu sistema. É com ele que você confere a assinatura; Gerar novo segredo invalida o anterior na hora.
Confira a assinatura
Cada POST traz o cabeçalho X-Vexday-Signature. Recalcule o HMAC-SHA256 de "t.corpo" com o segredo, sobre os bytes crus do corpo, antes de ler o JSON, compare em tempo constante e recuse um t com mais de cinco minutos de diferença.
X-Vexday-Event: cve.alerts X-Vexday-Delivery: 4bf933c7-c07a-4a45-a1b0-8729d2eebc8e X-Vexday-Signature: t=1762178700,v1=<HMAC-SHA256 hex>
O código de verificação em Python e em Node, com o exemplo do JSON →Responda rápido e ignore o repetido
Responda com um código 2xx assim que receber e processe depois. O X-Vexday-Delivery é o mesmo em todas as tentativas: ignore a entrega que já processou. Sem 2xx, o Vexday tenta de novo ao longo de algumas horas, e um 410 desliga o endpoint.
Teste
Clique em Testar: o endpoint recebe um evento ping assinado, e o painel mostra o que ele respondeu e em quanto tempo. Em Entregas fica o histórico de cada tentativa.