Cómo recibir alertas de CVE por webhook en tu sistema y verificar la firma (HMAC)
Recibe las CVE de tu stack en un POST en JSON firmado con HMAC-SHA256, directo en el SIEM, el SOAR o el sistema de tickets, con el mismo identificador en cada intento para no procesar dos veces.
Lo que necesitas
- Una cuenta de Vexday con el plan SOC o MSSP y las tecnologías registradas en Alertas.
- Una dirección https pública en tu sistema, en el puerto 443 u 8443, que acepte POST en JSON.
Paso a paso
Registra el endpoint
En Alertas, en la sección Destinos, elige Endpoint JSON, pega la URL de tu sistema y haz clic en Registrar. Una dirección de red interna, una IP privada o un puerto distinto de 443 y 8443 se rechaza.
Guarda el secreto
En la tarjeta del endpoint, haz clic en Mostrar y copia el secreto en tu sistema. Con él verificas la firma; Generar nuevo secreto invalida el anterior al momento.
Verifica la firma
Cada POST trae el encabezado X-Vexday-Signature. Recalcula el HMAC-SHA256 de "t.cuerpo" con el secreto, sobre los bytes crudos del cuerpo, antes de leer el JSON, compara en tiempo constante y rechaza un t con más de cinco minutos de diferencia.
X-Vexday-Event: cve.alerts X-Vexday-Delivery: 4bf933c7-c07a-4a45-a1b0-8729d2eebc8e X-Vexday-Signature: t=1762178700,v1=<HMAC-SHA256 hex>
El código de verificación en Python y en Node, con el ejemplo del JSON →Responde rápido e ignora lo repetido
Responde con un código 2xx en cuanto recibas y procesa después. El X-Vexday-Delivery es el mismo en todos los intentos: ignora la entrega que ya procesaste. Sin 2xx, Vexday reintenta a lo largo de algunas horas, y un 410 apaga el endpoint.
Prueba
Haz clic en Probar: el endpoint recibe un evento ping firmado, y el panel muestra qué respondió y en cuánto tiempo. En Entregas queda el historial de cada intento.