Akce pro nové zákazníky−20 %Sleva 20 % na první 3 měsíce při měsíční platběZobrazit tarify
SilentShield

Webhooky nepřicházejí

Vytvořili jste pravidlo upozornění s kanálem Webhook, ale váš server nic nedostává. Zde je, kdy SilentShield webhook odesílá a co ho může cestou zastavit.

Kdy SilentShield odesílá webhook

Webhooky odesílají pouze pravidla upozornění API klíče, jejichž kanálem je Webhook. Jednou za minutu SilentShield zkontroluje každé aktivní pravidlo. Je-li jeho podmínka v časovém okně splněna, odešle jeden požadavek POST na webhook URL uloženou na stránce „Nastavení oznámení“.

Příčiny

Pravidlo se ještě nikdy nespustilo

Na stránce „Pravidla upozornění“ klíče ukazuje sloupec „Naposledy spuštěno“, kdy se pravidlo naposledy spustilo. Je-li tam „nikdy“, podmínka ještě nebyla splněna a nic se neodeslalo. Porovnejte práh a operátor s čísly ve své analytice.

Pravidlo čeká na své časové okno

Pravidlo se spustí nejvýše jednou za časové okno (5m, 15m, 1h, 24h). Poté se znovu kontroluje až po uplynutí okna: pravidlo s 24h odešle nejvýše jednou denně.

Není uložena žádná webhook URL

Pravidlo jen vybírá kanál; samotnou adresu ukládáte na stránce „Nastavení oznámení“. Bez adresy se pravidlo spustí, ale nic se neodešle. Adresu můžete uložit jen v tarifu, který zahrnuje webhookové integrace.

Adresa není dostupná z internetu

SilentShield doručuje jen na veřejné adresy. Místní a interní cíle jako localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 nebo 172.16.0.0/12 se odmítnou při uložení a znovu při připojení, i po přesměrování. Pro místní testy použijte tunel s veřejnou adresou HTTPS.

Váš server odpovídá příliš pomalu

Každý pokus čeká na úplnou odpověď nejvýše 5 s. Odpovězte hned stavem 2xx a zprávu zpracujte až potom, například ve frontě.

Váš server odpovídá chybou nebo přesměrováním

Za doručené platí jen stavové kódy 200 až 299. Po 5xx, 408 nebo 429 nebo při selhání spojení to SilentShield zkusí znovu po 2 s a po 8 s a pak to vzdá. Jiné kódy 4xx jako 401, 403 nebo 404 se neopakují; firewall nebo ochrana proti botům před vaším koncovým bodem často odpovídá kódem 403. Po přesměrování 301, 302 nebo 303 pokračuje požadavek jako GET bez těla, proto zadejte konečnou adresu.

Kontrola podpisu na vašem serveru selhává

Pokud jste uložili tajný klíč, nese každý požadavek hlavičku X-Signature-256: sha256= a za ním HMAC-SHA256 těla v šestnáctkovém zápisu. Počítejte ho z nezměněného těla přesně tak, jak přišlo, ještě před parsováním JSON; tělo, které bylo naparsováno a znovu zapsáno, má jiný podpis. Bez tajného klíče hlavička chybí.

Co dorazí na váš server

Doručení vypadá takto. X-Event-ID zůstává stejné u všech pokusů jednoho doručení; podle něj pozná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

Příklad v Node.js; rawBody je nezměněné tělo požadavku:

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")

Jak nastavit pravidla a kanály: Pravidla upozornění