Les webhooks

Une alerte par site, signée avec le secret de votre webhook.

Le corps

une alerte
{
  "id": "…",
  "genre": "faille",
  "le": "2026-10-21T13:41:00.000Z",
  "titre": "…",
  "sonde": "snd_…",
  "faille": "CVE-…",
  "severite": "elevee",
  "exploitee": true,
  "lien": "https://app.manicou.dev/…"
}

Les genres

panne, retour, echeance, faille, a_verifier, ordre_sans_effet, corrigee, rappel, stack_ancienne, preuve_perdue, essai, protection.

La gravité et l’exploitation

severite dit l’impact de la faille, critique, elevee, moyenne ou faible. exploitee dit si elle est exploitée en ce moment, d’après la liste de la CISA ou sa source. Triez d’abord sur exploitee, comme Manicou. Une alerte qui ne parle d’aucune faille, une panne par exemple, a null pour les deux.

Le secret

Chaque webhook a le sien, whsec_ puis 32 octets en base64, affiché une seule fois quand vous l’ajoutez. Un nouveau secret se tire dans ses réglages.

La signature

Au format Standard Webhooks, signature v1, le HMAC-SHA256 de id.horodatage.corps avec le secret décodé du base64. webhook-id reste le même à chaque essai.

les en-têtes
webhook-id: …
webhook-timestamp: 1792590180
webhook-signature: v1,…

La vérification de l’adresse

Avant la première alerte, Manicou envoie un défi signé, l’en-tête webhook-challenge. Répondez 2xx avec webhook-challenge-response, v1, puis le HMAC-SHA256 du défi avec la clé HMAC-SHA256(secret, wev-v1), en base64. C’est l’extension endpoint verification de Standard Webhooks, et sans elle le webhook ne reçoit rien.

le défi et sa réponse
webhook-challenge: …

webhook-challenge-response: v1,…

Les essais

Tant que votre adresse ne répond pas 2xx, Manicou réessaie après 1, 5 et 30 minutes, 2 heures puis 6 heures. Six essais de dix secondes chacun, sans suivre de redirection.

Slack, Discord et Teams

Ils reçoivent le même contenu, au format de leurs webhooks entrants.