A webhookok nem érkeznek meg
Létrehozott egy riasztási szabályt Webhook csatornával, de a szervere semmit sem kap. Itt megtudja, mikor küld a SilentShield webhookot, és mi állíthatja meg útközben.
Mikor küld a SilentShield webhookot
Webhookot csak egy API-kulcs olyan riasztási szabályai küldenek, amelyek csatornája Webhook. A SilentShield percenként egyszer ellenőriz minden aktív szabályt. Ha a feltétel az időablakon belül teljesül, egy POST kérést küld a „Értesítési beállítások” oldalon mentett webhook URL-re.
Okok
A szabály még soha nem aktiválódott
A kulcs „Riasztási szabályok” oldalán a „Utoljára aktiválva” oszlop mutatja, mikor aktiválódott utoljára egy szabály. Ha ott „soha” áll, a feltétel még nem teljesült, és semmi sem lett elküldve. Vesse össze a küszöbértéket és az operátort az analitikája számaival.
A szabály kivárja az időablakát
Egy szabály időablakonként (5m, 15m, 1h, 24h) legfeljebb egyszer aktiválódik. Ezután csak az ablak leteltével ellenőrzi újra a rendszer: egy 24h-s szabály legfeljebb naponta egyszer küld.
Nincs mentett webhook URL
A szabály csak a csatornát választja ki; magát a címet a „Értesítési beállítások” oldalon menti. Cím nélkül a szabály aktiválódik, de semmi sem megy ki. Címet csak olyan csomaggal menthet, amely tartalmazza a webhook-integrációkat.
A cím nem érhető el az internetről
A SilentShield csak nyilvános címekre kézbesít. A helyi és belső célokat, például localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 vagy 172.16.0.0/12, mentéskor és csatlakozáskor újra elutasítja, átirányítás után is. Helyi tesztekhez használjon nyilvános HTTPS-címmel rendelkező tunnelt.
A szervere túl lassan válaszol
Minden kísérlet legfeljebb 5 másodpercig vár a teljes válaszra. Válaszoljon azonnal 2xx állapottal, és az üzenetet utána dolgozza fel, például egy várólistában.
A szervere hibával vagy átirányítással válaszol
Kézbesítettnek csak a 200 és 299 közötti állapotkódok számítanak. 5xx, 408 vagy 429 után, illetve ha a kapcsolat sikertelen, a SilentShield 2 és 8 másodperc múlva újra próbálkozik, majd feladja. Más 4xx kódokat, például 401, 403 vagy 404, nem ismétel; a végpontja előtti tűzfal vagy botvédelem gyakran 403-mal válaszol. 301, 302 vagy 303 átirányítás után a kérés GET kérésként, törzs nélkül folytatódik, ezért a végleges címet adja meg.
Az aláírás ellenőrzése a szerverén sikertelen
Ha mentett titkos kulcsot, minden kérés tartalmazza az X-Signature-256 fejlécet: sha256=, utána a törzs HMAC-SHA256 értéke hexadecimálisan. Ezt a nyers törzsből számolja ki, pontosan úgy, ahogy megérkezik, a JSON feldolgozása előtt; a feldolgozott és újraírt törzs aláírása más. Titkos kulcs nélkül a fejléc hiányzik.
Mi érkezik a szerverére
Egy kézbesítés így néz ki. Az X-Event-ID egy kézbesítés minden kísérleténél ugyanaz marad; erről ismeri fel az ismétlődéseket.
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"
}Az aláírás ellenőrzése
Példa Node.js-ben; a rawBody a kérés változatlan törzse:
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")A szabályok és csatornák beállítása: Riasztási szabályok