Webhooks komen niet aan
U hebt een waarschuwingsregel met het kanaal Webhook aangemaakt, maar uw server ontvangt niets. Hier leest u wanneer SilentShield een webhook verstuurt en wat die onderweg kan tegenhouden.
Wanneer SilentShield een webhook verstuurt
Webhooks worden alleen verstuurd door waarschuwingsregels van een API-sleutel waarvan het kanaal Webhook is. Eén keer per minuut controleert SilentShield elke actieve regel. Is de voorwaarde binnen het tijdvenster vervuld, dan gaat er één POST-verzoek naar de webhook-URL die is opgeslagen op de pagina “Meldingsinstellingen”.
Oorzaken
De regel is nog nooit geactiveerd
Op de pagina “Waarschuwingsregels” van de sleutel toont de kolom “Laatst geactiveerd” wanneer een regel voor het laatst is geactiveerd. Staat daar “nooit”, dan is de voorwaarde nog niet vervuld en is er niets verstuurd. Vergelijk drempel en operator met de cijfers in uw analyse.
De regel wacht zijn tijdvenster af
Een regel wordt per tijdvenster (5m, 15m, 1h, 24h) hoogstens één keer geactiveerd. Daarna wordt hij pas opnieuw gecontroleerd als het venster voorbij is: een regel met 24h verstuurt hoogstens één keer per dag.
Er is geen webhook-URL opgeslagen
De regel kiest alleen het kanaal; het adres zelf slaat u op op de pagina “Meldingsinstellingen”. Zonder adres wordt de regel geactiveerd, maar wordt er niets verstuurd. Een adres opslaan kan alleen met een abonnement dat webhookintegraties omvat.
Het adres is niet bereikbaar vanaf internet
SilentShield levert alleen af op openbare adressen. Lokale en interne doelen zoals localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 of 172.16.0.0/12 worden bij het opslaan geweigerd en opnieuw bij het verbinden, ook na een doorverwijzing. Gebruik voor lokale tests een tunnel met een openbaar HTTPS-adres.
Uw server antwoordt te traag
Elke poging wacht hoogstens 5 seconden op het volledige antwoord. Antwoord meteen met een 2xx-status en verwerk het bericht daarna, bijvoorbeeld in een wachtrij.
Uw server antwoordt met een fout of een doorverwijzing
Alleen statuscodes van 200 tot en met 299 gelden als afgeleverd. Na 5xx, 408 of 429, of als de verbinding mislukt, probeert SilentShield het na 2 en na 8 seconden opnieuw en geeft het daarna op. Andere 4xx-codes zoals 401, 403 of 404 worden niet herhaald; een firewall of botbescherming vóór uw endpoint antwoordt vaak met 403. Na een doorverwijzing met 301, 302 of 303 gaat het verzoek verder als GET zonder body, dus vul het definitieve adres in.
De handtekeningcontrole op uw server mislukt
Als u een geheim hebt opgeslagen, draagt elk verzoek de header X-Signature-256: sha256= gevolgd door de HMAC-SHA256 van de body in hexadecimale notatie. Bereken die over de ruwe body precies zoals die binnenkomt, vóór het parsen van de JSON; een geparste en opnieuw geschreven body heeft een andere handtekening. Zonder geheim ontbreekt de header.
Wat er bij uw server binnenkomt
Een aflevering ziet er zo uit. X-Event-ID blijft bij alle pogingen van één aflevering gelijk; daaraan herkent u dubbele afleveringen.
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"
}Handtekening controleren
Voorbeeld in Node.js; rawBody is de ongewijzigde body van het verzoek:
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")Zo stelt u regels en kanalen in: Waarschuwingsregels