Webhooky neprichádzajú
Vytvorili ste pravidlo upozornenia s kanálom Webhook, ale váš server nič nedostáva. Tu zistíte, kedy SilentShield webhook posiela a čo ho môže cestou zastaviť.
Kedy SilentShield posiela webhook
Webhooky posielajú iba pravidlá upozornení API kľúča, ktorých kanálom je Webhook. Raz za minútu SilentShield skontroluje každé aktívne pravidlo. Ak je jeho podmienka v časovom okne splnená, pošle jednu požiadavku POST na webhook URL uloženú na stránke „Nastavenia upozornení“.
Príčiny
Pravidlo sa ešte nikdy nespustilo
Na stránke „Pravidlá upozornení“ kľúča ukazuje stĺpec „Naposledy spustené“, kedy sa pravidlo naposledy spustilo. Ak je tam „nikdy“, podmienka ešte nebola splnená a nič sa neodoslalo. Porovnajte prah a operátor s číslami vo svojej analytike.
Pravidlo čaká na svoje časové okno
Pravidlo sa spustí najviac raz za časové okno (5m, 15m, 1h, 24h). Potom sa znova kontroluje až po uplynutí okna: pravidlo s 24h pošle najviac raz denne.
Nie je uložená žiadna webhook URL
Pravidlo iba vyberá kanál; samotnú adresu ukladáte na stránke „Nastavenia upozornení“. Bez adresy sa pravidlo spustí, ale nič sa neodošle. Adresu môžete uložiť iba v tarife, ktorý zahŕňa webhookové integrácie.
Adresa nie je verejne dostupná
SilentShield doručuje iba na verejné adresy. Lokálne a interné ciele ako localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 alebo 172.16.0.0/12 sa odmietnu pri uložení a znova pri pripojení, aj po presmerovaní. Na lokálne testy použite tunel s verejnou adresou HTTPS.
Váš server odpovedá príliš pomaly
Každý pokus čaká na úplnú odpoveď najviac 5 s. Odpovedzte hneď stavom 2xx a správu spracujte až potom, napríklad vo fronte.
Váš server odpovedá chybou alebo presmerovaním
Za doručené sa považujú iba stavové kódy 200 až 299. Po 5xx, 408 alebo 429 alebo pri zlyhaní spojenia to SilentShield skúsi znova po 2 s a po 8 s a potom to vzdá. Iné kódy 4xx ako 401, 403 alebo 404 sa neopakujú; firewall alebo ochrana pred botmi pred vaším koncovým bodom často odpovedá kódom 403. Po presmerovaní 301, 302 alebo 303 pokračuje požiadavka ako GET bez tela, preto zadajte konečnú adresu.
Kontrola podpisu na vašom serveri zlyháva
Ak ste uložili tajný kľúč, každá požiadavka nesie hlavičku X-Signature-256: sha256= a za ním HMAC-SHA256 tela v šestnástkovom zápise. Počítajte ho z nespracovaného tela presne tak, ako prišlo, ešte pred parsovaním JSON; telo, ktoré bolo sparsované a znova zapísané, má iný podpis. Bez tajného kľúča hlavička chýba.
Čo príde na váš server
Doručenie vyzerá takto. X-Event-ID zostáva rovnaké pri všetkých pokusoch jedného doručenia; podľa neho rozpoznáte duplicity.
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"
}Kontrola podpisu
Príklad v Node.js; rawBody je nezmenené telo požiadavky:
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")Ako nastaviť pravidlá a kanály: Pravidlá upozornení