Tilbud til nye kunder−20 %20 % rabat de første 3 måneder ved månedlig betalingSe priser
SilentShield

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