Alertas

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.

  • Para quemPara desenvolvedores, SOC e MSSP que levam os alertas a um sistema próprio.
  • PlanoPlanos SOC e MSSP
  • Tempocerca de 20 min

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

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

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

  3. 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 →
  4. 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.

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

Deu errado?

A URL não é aceitaUse https, a porta 443 ou a 8443, um endereço público e nenhum usuário ou senha na URL. Rede interna e IP privado são recusados para proteger os dois lados.
A assinatura não confereCalcule sobre os bytes crus do corpo, antes de qualquer leitura do JSON, e use o segredo daquele endpoint (cada um tem o seu). Confira também o relógio do servidor: um t com mais de cinco minutos de diferença é recusado.
O endpoint foi desligadoTrês dias só de falhas desligam o endpoint, e o dono recebe um e-mail; um 410 desliga na hora. Corrija o receptor e clique em Religar.
Chegou o mesmo alerta duas vezesÉ uma nova tentativa, com o mesmo X-Vexday-Delivery. Guarde os identificadores já processados e ignore os repetidos.

Perguntas frequentes

Que eventos chegam?

cve.alerts, com as CVEs que saem na hora; cve.digest, o resumo diário; e ping, o teste. O tipo vem no corpo e no cabeçalho X-Vexday-Event.

O JSON pode mudar?

O corpo tem a versão do formato (api_version), e campo novo entra sem mudar a versão. O seu receptor deve ignorar o campo que não conhece.

Posso mandar os alertas para o Jira?

Sim. O guia do n8n tem um fluxo pronto que confere a assinatura e mantém um ticket por CVE e por cliente.

Continue