Les webhooks
Une alerte par site, signée avec le secret de votre webhook.
Le corps
{
"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.
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.
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.