Les webhooks n’arrivent pas
Vous avez créé une règle d’alerte avec le canal Webhook, mais votre serveur ne reçoit rien. Voici quand SilentShield envoie un webhook et ce qui peut l’arrêter en chemin.
Quand SilentShield envoie un webhook
Seules les règles d’alerte d’une clé API dont le canal est Webhook envoient des webhooks. Une fois par minute, SilentShield vérifie chaque règle active. Si sa condition est remplie dans la fenêtre de temps, il envoie une requête POST à l’URL de webhook enregistrée sur la page « Paramètres de notification ».
Causes
La règle ne s’est jamais déclenchée
Sur la page « Règles d'alerte » de la clé, la colonne « Dernier déclenchement » indique quand une règle s’est déclenchée pour la dernière fois. Si elle affiche « jamais », la condition n’a pas encore été remplie et rien n’a été envoyé. Comparez le seuil et l’opérateur avec les chiffres de vos analyses.
La règle attend la fin de sa fenêtre de temps
Une règle se déclenche au plus une fois par fenêtre de temps (5m, 15m, 1h, 24h). Ensuite, elle n’est de nouveau vérifiée qu’une fois cette fenêtre écoulée : une règle de 24h envoie au plus une fois par jour.
Aucune URL de webhook n’est enregistrée
La règle choisit seulement le canal ; l’adresse elle-même s’enregistre sur la page « Paramètres de notification ». Sans adresse, la règle se déclenche, mais rien n’est envoyé. Vous ne pouvez enregistrer une adresse qu’avec une offre qui inclut les intégrations webhook.
L’adresse n’est pas joignable depuis Internet
SilentShield ne livre qu’à des adresses publiques. Les cibles locales et internes comme localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 ou 172.16.0.0/12 sont refusées à l’enregistrement, puis à nouveau à la connexion, y compris après une redirection. Pour des tests locaux, utilisez un tunnel avec une adresse HTTPS publique.
Votre serveur répond trop lentement
Chaque tentative attend au plus 5 secondes la réponse complète. Répondez immédiatement avec un statut 2xx et traitez le message ensuite, par exemple dans une file d’attente.
Votre serveur répond par une erreur ou une redirection
Seuls les codes de statut 200 à 299 comptent comme livrés. Après un 5xx, 408 ou 429, ou si la connexion échoue, SilentShield réessaie après 2 puis après 8 secondes, puis abandonne. Les autres codes 4xx comme 401, 403 ou 404 ne sont pas réessayés ; un pare-feu ou une protection anti-bots placé devant votre endpoint répond souvent par 403. Après une redirection 301, 302 ou 303, la requête continue en GET sans corps : indiquez donc l’adresse finale.
La vérification de la signature échoue sur votre serveur
Si vous avez enregistré un secret, chaque requête porte l’en-tête X-Signature-256 : sha256= suivi du HMAC-SHA256 du corps en hexadécimal. Calculez-le sur le corps brut, exactement tel qu’il arrive, avant d’analyser le JSON ; un corps analysé puis resérialisé a une autre signature. Sans secret, l’en-tête est absent.
Ce qui arrive sur votre serveur
Une livraison ressemble à ceci. X-Event-ID reste identique pour toutes les tentatives d’une même livraison ; utilisez-le pour repérer les doublons.
POST /your-webhook HTTP/1.1
Content-Type: application/json
X-Event-ID: 8b1f2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d
X-Signature-256: sha256=<hex>
{
"event_id": "8b1f2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
"alert_rule_id": "2a7c9e1b-3d4f-4b6a-8c0e-1f2a3b4c5d6e",
"alert_name": "bot-rate",
"api_key_id": "5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f",
"metric": "bot_rate",
"operator": "gt",
"threshold": 0.3,
"value": 0.42,
"fired_at": "2026-11-16T10:30:00Z"
}Vérifier la signature
Exemple en Node.js ; rawBody est le corps de la requête non modifié :
const crypto = require("crypto");
function isValidSignature(rawBody, header, secret) {
const expected = "sha256=" +
crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
const received = header || "";
return received.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
}
// header = req.get("X-Signature-256")Configurer les règles et les canaux : Règles d'alerte