Webhooks kommer ikke frem
Du har oprettet en alarmregel med kanalen Webhook, men din server modtager intet. Her kan du se, hvornår SilentShield sender et webhook, og hvad der kan stoppe det undervejs.
Hvornår SilentShield sender et webhook
Webhooks sendes kun af alarmregler for en API-nøgle, hvis kanal er Webhook. Én gang i minuttet tjekker SilentShield hver aktiv regel. Er betingelsen opfyldt i tidsvinduet, sendes én POST-anmodning til den webhook-URL, der er gemt på siden »Notifikationsindstillinger«.
Årsager
Reglen er aldrig udløst
På siden »Alarmregler« for nøglen viser kolonnen »Senest udløst«, hvornår en regel sidst blev udløst. Står der »aldrig«, er betingelsen endnu ikke opfyldt, og intet er sendt. Sammenlign tærsklen med tallene i din analyse.
Reglen venter på sit tidsvindue
En regel udløses højst én gang pr. tidsvindue (5m, 15m, 1h, 24h). Derefter tjekkes den først igen, når vinduet er udløbet: en regel med 24h sender højst én gang om dagen.
Der er ikke gemt nogen webhook-URL
Reglen vælger kun kanalen; selve adressen gemmer du på siden »Notifikationsindstillinger«. Uden adresse udløses reglen, men intet sendes. Du kan kun gemme en adresse med en plan, der omfatter webhook-integrationer.
Adressen kan ikke nås fra internettet
SilentShield leverer kun til offentlige adresser. Lokale og interne mål som localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 eller 172.16.0.0/12 afvises, når du gemmer, og igen ved forbindelsen, også efter en omdirigering. Til lokale test kan du bruge en tunnel med en offentlig HTTPS-adresse.
Din server svarer for langsomt
Hvert forsøg venter højst 5 sekunder på det fulde svar. Svar straks med en 2xx-status, og behandl beskeden bagefter, for eksempel i en kø.
Din server svarer med en fejl eller en omdirigering
Kun statuskoder fra 200 til 299 tæller som leveret. Efter 5xx, 408 eller 429, eller hvis forbindelsen fejler, prøver SilentShield igen efter 2 og efter 8 sekunder og giver derefter op. Andre 4xx-koder som 401, 403 eller 404 gentages ikke; en firewall eller en botbeskyttelse foran dit endpoint svarer ofte med 403. Efter en omdirigering med 301, 302 eller 303 fortsætter anmodningen som GET uden indhold, så angiv den endelige adresse.
Signaturtjekket på din server fejler
Har du gemt en hemmelighed, bærer hver anmodning headeren X-Signature-256: sha256= efterfulgt af HMAC-SHA256 af indholdet i hexadecimal. Beregn den over det rå indhold præcis, som det ankommer, før JSON fortolkes; indhold, der er fortolket og skrevet igen, har en anden signatur. Uden hemmelighed mangler headeren.
Hvad der kommer frem til din server
En levering ser sådan ud. X-Event-ID er den samme ved alle forsøg på én levering; brug den til at genkende dubletter.
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"
}Tjek signaturen
Eksempel i Node.js; rawBody er det uændrede indhold i anmodningen:
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")Sådan opretter du regler og kanaler: Alarmregler