Webhooki ne prispejo
Ustvarili ste pravilo opozorila s kanalom Webhook, vendar vaš strežnik ne prejme ničesar. Tukaj izveste, kdaj SilentShield pošlje webhook in kaj ga lahko na poti ustavi.
Kdaj SilentShield pošlje webhook
Webhooke pošiljajo samo pravila opozoril ključa API, katerih kanal je Webhook. Enkrat na minuto SilentShield preveri vsako aktivno pravilo. Če je njegov pogoj v časovnem oknu izpolnjen, pošlje eno zahtevo POST na URL webhooka, shranjen na strani „Nastavitve obvestil“.
Vzroki
Pravilo se še nikoli ni sprožilo
Na strani „Pravila opozoril“ ključa stolpec „Zadnjič sproženo“ pokaže, kdaj se je pravilo nazadnje sprožilo. Če tam piše „nikoli“, pogoj še ni bil izpolnjen in ni bilo poslano nič. Primerjajte prag in operator s številkami v svoji analitiki.
Pravilo čaka na svoje časovno okno
Pravilo se sproži največ enkrat na časovno okno (5m, 15m, 1h, 24h). Nato se znova preveri šele, ko okno poteče: pravilo s 24h pošlje največ enkrat na dan.
Ni shranjenega URL-ja webhooka
Pravilo izbere samo kanal; sam naslov shranite na strani „Nastavitve obvestil“. Brez naslova se pravilo sproži, vendar se ne pošlje nič. Naslov lahko shranite samo s paketom, ki vključuje integracije webhook.
Naslov ni dosegljiv iz interneta
SilentShield dostavlja samo na javne naslove. Lokalni in notranji cilji, kot so localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 ali 172.16.0.0/12, so zavrnjeni ob shranjevanju in znova ob povezovanju, tudi po preusmeritvi. Za lokalne preizkuse uporabite tunel z javnim naslovom HTTPS.
Vaš strežnik odgovarja prepočasi
Vsak poskus čaka na celoten odgovor največ 5 s. Takoj odgovorite s stanjem 2xx in sporočilo obdelajte pozneje, na primer v čakalni vrsti.
Vaš strežnik odgovori z napako ali preusmeritvijo
Kot dostavljene štejejo samo statusne kode od 200 do 299. Po 5xx, 408 ali 429 ali če povezava ne uspe, SilentShield poskusi znova po 2 s in po 8 s, nato odneha. Druge kode 4xx, kot so 401, 403 ali 404, se ne ponavljajo; požarni zid ali zaščita pred boti pred vašo končno točko pogosto odgovori s 403. Po preusmeritvi 301, 302 ali 303 se zahteva nadaljuje kot GET brez telesa, zato vnesite končni naslov.
Preverjanje podpisa na vašem strežniku ne uspe
Če ste shranili skrivnost, vsaka zahteva nosi glavo X-Signature-256: sha256= in za njim HMAC-SHA256 telesa v šestnajstiškem zapisu. Izračunajte ga iz neobdelanega telesa natanko takšnega, kot prispe, pred razčlenjevanjem JSON; razčlenjeno in znova zapisano telo ima drug podpis. Brez skrivnosti glave ni.
Kaj prispe na vaš strežnik
Dostava je videti tako. X-Event-ID ostane enak pri vseh poskusih ene dostave; po njem prepoznate podvojene dostave.
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"
}Preverjanje podpisa
Primer v Node.js; rawBody je nespremenjeno telo zahteve:
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")Kako nastavite pravila in kanale: Pravila opozoril