Il-webhooks ma jaslux
Ħloqt regola tal-allerta bil-kanal Webhook, iżda s-server tiegħek ma jirċievi xejn. Hawn issib meta SilentShield jibgħat webhook u x’jista’ jwaqqfu fit-triq.
Meta SilentShield jibgħat webhook
Il-webhooks jintbagħtu biss minn regoli tal-allerta ta’ ċavetta API li l-kanal tagħhom huwa Webhook. Darba kull minuta SilentShield jiċċekkja kull regola attiva. Jekk il-kundizzjoni tagħha tkun sodisfatta fit-tieqa tal-ħin, jibgħat talba POST waħda lill-URL tal-webhook maħżun fil-paġna “Issettjar tan-notifiki”.
Kawżi
Ir-regola qatt ma ħadmet
Fil-paġna “Regoli tal-allerta” taċ-ċavetta, il-kolonna “L-aħħar li ħadem” turi meta regola ħadmet l-aħħar darba. Jekk tgħid “qatt”, il-kundizzjoni għadha ma ġietx sodisfatta u ma ntbagħat xejn. Qabbel il-limitu u l-operatur man-numri fl-analitika tiegħek.
Ir-regola qed tistenna li tgħaddi t-tieqa tal-ħin tagħha
Regola taħdem l-aktar darba waħda għal kull tieqa tal-ħin (5m, 15m, 1h, 24h). Wara dan terġa’ tiġi ċċekkjata biss meta tgħaddi t-tieqa: regola b’24h tibgħat l-aktar darba kuljum.
Ebda URL tal-webhook ma huwa maħżun
Ir-regola tagħżel biss il-kanal; l-indirizz innifsu taħżnu fil-paġna “Issettjar tan-notifiki”. Mingħajr indirizz ir-regola taħdem, iżda ma jintbagħat xejn. Tista’ taħżen indirizz biss bi pjan li jinkludi l-integrazzjonijiet tal-webhook.
L-indirizz ma jintlaħaqx mill-internet
SilentShield jikkonsenja biss lil indirizzi pubbliċi. Destinazzjonijiet lokali u interni bħal localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 jew 172.16.0.0/12 jiġu miċħuda meta taħżen u għal darb’oħra meta jsir il-kollegament, anke wara redirect. Għal testijiet lokali uża tunnel b’indirizz HTTPS pubbliku.
Is-server tiegħek iwieġeb bil-mod wisq
Kull tentattiv jistenna l-aktar 5 sekondi għat-tweġiba sħiħa. Wieġeb minnufih bi status 2xx u pproċessa l-messaġġ wara, pereżempju f’kju.
Is-server tiegħek iwieġeb bi żball jew b’redirect
Jgħoddu bħala kkonsenjati biss il-kodiċijiet tal-istatus minn 200 sa 299. Wara 5xx, 408 jew 429, jew jekk il-kollegament ifalli, SilentShield jerġa’ jipprova wara 2 u wara 8 sekondi u mbagħad jieqaf. Kodiċijiet 4xx oħra bħal 401, 403 jew 404 ma jerġgħux jiġu pprovati; firewall jew protezzjoni kontra l-bots quddiem l-endpoint tiegħek spiss iwieġbu b’403. Wara redirect b’301, 302 jew 303 it-talba tkompli bħala GET mingħajr korp, għalhekk daħħal l-indirizz finali.
Il-verifika tal-firma tfalli fuq is-server tiegħek
Jekk ħżint sigriet, kull talba ġġorr l-header X-Signature-256: sha256= segwit mill-HMAC-SHA256 tal-korp f’eżadeċimali. Ikkalkulah fuq il-korp mhux ipproċessat eżatt kif jasal, qabel ma tipproċessa l-JSON; korp li ġie pproċessat u miktub mill-ġdid għandu firma oħra. Mingħajr sigriet, l-header ma jkunx hemm.
X’jasal fis-server tiegħek
Konsenja tidher hekk. X-Event-ID jibqa’ l-istess fit-tentattivi kollha tal-istess konsenja; użah biex tagħraf id-duplikati.
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"
}Iċċekkja l-firma
Eżempju f’Node.js; rawBody huwa l-korp tat-talba mhux mibdul:
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")Kif tissettja r-regoli u l-kanali: Regoli tal-Allert