Offerta għal klijenti ġodda−20 %20 % skont għall-ewwel 3 xhur bi ħlas kull xaharAra l-pjanijiet
SilentShield

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