Webhooks kommen nicht an
Sie haben eine Alarm-Regel mit dem Kanal Webhook angelegt, aber Ihr Server erhält nichts. Hier steht, wann SilentShield einen Webhook sendet und was ihn unterwegs aufhält.
Wann SilentShield einen Webhook sendet
Webhooks senden nur Alarm-Regeln eines API-Schlüssels, deren Kanal Webhook ist. Einmal pro Minute prüft SilentShield jede aktive Regel. Ist ihre Bedingung im Zeitfenster erfüllt, geht eine POST-Anfrage an die Webhook-URL, die auf der Seite „Benachrichtigungseinstellungen“ gespeichert ist.
Ursachen
Die Regel hat noch nie ausgelöst
Auf der Seite „Alarm-Regeln“ des Schlüssels zeigt die Spalte „Zuletzt ausgelöst“, wann eine Regel zuletzt ausgelöst hat. Steht dort „nie“, war die Bedingung noch nie erfüllt, und es wurde nichts gesendet. Vergleichen Sie Schwellenwert und Operator mit den Zahlen in Ihrer Analyse.
Die Regel wartet ihr Zeitfenster ab
Eine Regel löst höchstens einmal je Zeitfenster aus (5m, 15m, 1h, 24h). Danach wird sie erst wieder geprüft, wenn das Fenster abgelaufen ist: Eine Regel mit 24h sendet höchstens einmal am Tag.
Es ist keine Webhook-URL gespeichert
Die Regel wählt nur den Kanal; die Adresse selbst speichern Sie auf der Seite „Benachrichtigungseinstellungen“. Ohne Adresse löst die Regel aus, gesendet wird aber nichts. Eine Adresse speichern können Sie nur in einem Tarif, der Webhook-Integrationen enthält.
Die Adresse ist aus dem Internet nicht erreichbar
SilentShield stellt nur an öffentliche Adressen zu. Lokale und interne Ziele wie localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 oder 172.16.0.0/12 werden beim Speichern abgewiesen und beim Verbinden noch einmal, auch nach einer Weiterleitung. Für lokale Tests nutzen Sie einen Tunnel mit öffentlicher HTTPS-Adresse.
Ihr Server antwortet zu langsam
Jeder Versuch wartet höchstens 5 Sekunden auf die vollständige Antwort. Antworten Sie sofort mit einem 2xx-Status und verarbeiten Sie die Nachricht danach, zum Beispiel in einer Warteschlange.
Ihr Server antwortet mit einem Fehler oder einer Weiterleitung
Als zugestellt gelten nur Statuscodes von 200 bis 299. Nach 5xx, 408 oder 429 oder wenn die Verbindung scheitert, versucht SilentShield es nach 2 und nach 8 Sekunden noch einmal und gibt dann auf. Andere 4xx-Codes wie 401, 403 oder 404 werden nicht wiederholt; eine Firewall oder ein Bot-Schutz vor Ihrem Endpunkt antwortet oft mit 403. Nach einer Weiterleitung mit 301, 302 oder 303 geht die Anfrage als GET ohne Inhalt weiter, tragen Sie deshalb die endgültige Adresse ein.
Die Signaturprüfung auf Ihrem Server schlägt fehl
Haben Sie ein Secret gespeichert, trägt jede Anfrage die Kopfzeile X-Signature-256: sha256= und dahinter das HMAC-SHA256 des Inhalts in Hexadezimalschreibweise. Berechnen Sie es über den Rohinhalt genau so, wie er ankommt, vor dem Parsen des JSON; ein geparster und neu geschriebener Inhalt hat eine andere Signatur. Ohne Secret fehlt die Kopfzeile.
Was bei Ihrem Server ankommt
Eine Zustellung sieht so aus. X-Event-ID bleibt bei allen Versuchen derselben Zustellung gleich; daran erkennen Sie doppelte Zustellungen.
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"
}Signatur prüfen
Beispiel in Node.js; rawBody ist der unveränderte Anfrageinhalt:
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")So richten Sie Regeln und Kanäle ein: Alert-Regeln