Ponuda za nove korisnike−20 %20 % popusta za prva 3 mjeseca uz mjesečno plaćanjePogledajte tarife
SilentShield

Webhookovi ne stižu

Izradili ste pravilo upozorenja s kanalom Webhook, ali Vaš poslužitelj ništa ne prima. Ovdje saznajte kada SilentShield šalje webhook i što ga može zaustaviti na putu.

Kada SilentShield šalje webhook

Webhookove šalju samo pravila upozorenja API ključa čiji je kanal Webhook. Jednom u minuti SilentShield provjerava svako aktivno pravilo. Ako je njegov uvjet ispunjen unutar vremenskog prozora, šalje se jedan POST zahtjev na webhook URL spremljen na stranici „Postavke obavijesti“.

Uzroci

Pravilo se nikada nije pokrenulo

Na stranici „Pravila upozorenja“ ključa stupac „Zadnje pokretanje“ pokazuje kada se pravilo zadnji put pokrenulo. Ako piše „nikada“, uvjet još nije ispunjen i ništa nije poslano. Usporedite prag i operator s brojkama u svojoj analitici.

Pravilo čeka svoj vremenski prozor

Pravilo se pokreće najviše jednom po vremenskom prozoru (5m, 15m, 1h, 24h). Nakon toga ponovno se provjerava tek kada prozor istekne: pravilo s 24h šalje najviše jednom dnevno.

Nije spremljen webhook URL

Pravilo samo bira kanal; samu adresu spremate na stranici „Postavke obavijesti“. Bez adrese pravilo se pokreće, ali ništa se ne šalje. Adresu možete spremiti samo u paketu koji uključuje webhook integracije.

Adresa nije dostupna s interneta

SilentShield dostavlja samo na javne adrese. Lokalna i interna odredišta poput localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 ili 172.16.0.0/12 odbijaju se pri spremanju i ponovno pri povezivanju, i nakon preusmjeravanja. Za lokalne testove upotrijebite tunel s javnom HTTPS adresom.

Vaš poslužitelj odgovara presporo

Svaki pokušaj čeka potpuni odgovor najviše 5 s. Odmah odgovorite statusom 2xx, a poruku obradite nakon toga, primjerice u redu čekanja.

Vaš poslužitelj odgovara pogreškom ili preusmjeravanjem

Dostavljenima se smatraju samo statusni kodovi od 200 do 299. Nakon 5xx, 408 ili 429 ili ako veza ne uspije, SilentShield pokušava ponovno nakon 2 s i nakon 8 s, a zatim odustaje. Ostali 4xx kodovi poput 401, 403 ili 404 ne ponavljaju se; vatrozid ili zaštita od botova ispred Vaše krajnje točke često odgovara s 403. Nakon preusmjeravanja s 301, 302 ili 303 zahtjev se nastavlja kao GET bez tijela, stoga unesite konačnu adresu.

Provjera potpisa na Vašem poslužitelju ne uspijeva

Ako ste spremili tajnu, svaki zahtjev nosi zaglavlje X-Signature-256: sha256= iza kojeg slijedi HMAC-SHA256 tijela u heksadecimalnom zapisu. Izračunajte ga nad neobrađenim tijelom točno onakvim kakvo stiže, prije raščlanjivanja JSON-a; tijelo koje je raščlanjeno i ponovno zapisano ima drugi potpis. Bez tajne zaglavlje nedostaje.

Što stiže na Vaš poslužitelj

Jedna dostava izgleda ovako. X-Event-ID ostaje isti u svim pokušajima jedne dostave; po njemu prepoznajete duplikate.

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

Provjera potpisa

Primjer u Node.js-u; rawBody je nepromijenjeno tijelo zahtjeva:

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 postaviti pravila i kanale: Pravila upozorenja