Ponudba za nove stranke−20 %20 % popusta za prve 3 mesece pri mesečnem plačiluOglejte si tarife
SilentShield

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