Erbjudande till nya kunder−20 %20 % rabatt de första 3 månaderna vid månadsbetalningSe priser
SilentShield

Webhooks kommer inte fram

Du har skapat en varningsregel med kanalen Webhook, men din server tar inte emot något. Här ser du när SilentShield skickar en webhook och vad som kan stoppa den på vägen.

När SilentShield skickar en webhook

Webhooks skickas bara av varningsregler för en API-nyckel vars kanal är Webhook. En gång i minuten kontrollerar SilentShield varje aktiv regel. Är villkoret uppfyllt inom tidsfönstret skickas en POST-begäran till webhook-URL:en som är sparad på sidan ”Meddelandeinställningar”.

Orsaker

Regeln har aldrig utlösts

På sidan ”Varningsregler” för nyckeln visar kolumnen ”Senast utlöst” när en regel senast utlöstes. Står det ”aldrig” har villkoret ännu inte uppfyllts och ingenting har skickats. Jämför tröskelvärdet med siffrorna i din analys.

Regeln väntar ut sitt tidsfönster

En regel utlöses högst en gång per tidsfönster (5m, 15m, 1h, 24h). Därefter kontrolleras den igen först när fönstret har passerat: en regel med 24h skickar högst en gång om dagen.

Ingen webhook-URL är sparad

Regeln väljer bara kanalen; själva adressen sparar du på sidan ”Meddelandeinställningar”. Utan adress utlöses regeln, men ingenting skickas. Du kan bara spara en adress med en plan som omfattar webhook-integrationer.

Adressen går inte att nå från internet

SilentShield levererar bara till offentliga adresser. Lokala och interna mål som localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 eller 172.16.0.0/12 avvisas när du sparar och igen vid anslutningen, även efter en omdirigering. För lokala tester använder du en tunnel med en offentlig HTTPS-adress.

Din server svarar för långsamt

Varje försök väntar högst 5 sekunder på hela svaret. Svara direkt med en 2xx-status och bearbeta meddelandet efteråt, till exempel i en kö.

Din server svarar med ett fel eller en omdirigering

Bara statuskoder från 200 till 299 räknas som levererade. Efter 5xx, 408 eller 429, eller om anslutningen misslyckas, försöker SilentShield igen efter 2 och efter 8 sekunder och ger sedan upp. Andra 4xx-koder som 401, 403 eller 404 upprepas inte; en brandvägg eller ett botskydd framför din endpoint svarar ofta med 403. Efter en omdirigering med 301, 302 eller 303 fortsätter begäran som GET utan innehåll, så ange den slutliga adressen.

Signaturkontrollen på din server misslyckas

Har du sparat en hemlighet bär varje begäran headern X-Signature-256: sha256= följt av HMAC-SHA256 av innehållet i hexadecimal form. Beräkna den över det råa innehållet exakt som det kommer fram, innan JSON tolkas; innehåll som har tolkats och skrivits om har en annan signatur. Utan hemlighet saknas headern.

Vad som kommer fram till din server

En leverans ser ut så här. X-Event-ID är detsamma för alla försök i en leverans; använd det för att känna igen dubbletter.

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"
}

Kontrollera signaturen

Exempel i Node.js; rawBody är begärans oförändrade innehåll:

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å ställer du in regler och kanaler: Varningsregler