Alertas

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.

  • Para quiénPara desarrolladores, SOC y MSSP que llevan las alertas a un sistema propio.
  • PlanPlanes SOC y MSSP
  • Tiempounos 20 min

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

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

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

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

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

¿Algo salió mal?

La URL no se aceptaUsa https, el puerto 443 u 8443, una dirección pública y ningún usuario ni contraseña en la URL. La red interna y la IP privada se rechazan para proteger a ambos lados.
La firma no coincideCalcula sobre los bytes crudos del cuerpo, antes de cualquier lectura del JSON, y usa el secreto de ese endpoint (cada uno tiene el suyo). Revisa también el reloj del servidor: un t con más de cinco minutos de diferencia se rechaza.
El endpoint se apagóTres días solo de fallas apagan el endpoint, y el dueño recibe un correo; un 410 lo apaga al momento. Corrige el receptor y haz clic en Reactivar.
Llegó la misma alerta dos vecesEs un nuevo intento, con el mismo X-Vexday-Delivery. Guarda los identificadores ya procesados e ignora los repetidos.

Preguntas frecuentes

¿Qué eventos llegan?

cve.alerts, con las CVE que salen al momento; cve.digest, el resumen diario; y ping, la prueba. El tipo viene en el cuerpo y en el encabezado X-Vexday-Event.

¿El JSON puede cambiar?

El cuerpo tiene la versión del formato (api_version), y un campo nuevo entra sin cambiar la versión. Tu receptor debe ignorar el campo que no conoce.

¿Puedo enviar las alertas a Jira?

Sí. La guía de n8n tiene un flujo listo que verifica la firma y mantiene un ticket por CVE y por cliente.

Sigue