Ofertă pentru clienți noi−20 %20 % reducere în primele 3 luni cu plata lunarăVedeți planurile
SilentShield

Webhookurile nu ajung

Ați creat o regulă de alertă cu canalul Webhook, dar serverul dumneavoastră nu primește nimic. Iată când trimite SilentShield un webhook și ce îl poate opri pe drum.

Când trimite SilentShield un webhook

Webhookuri trimit doar regulile de alertă ale unei chei API al căror canal este Webhook. O dată pe minut, SilentShield verifică fiecare regulă activă. Dacă condiția ei este îndeplinită în fereastra de timp, trimite o singură cerere POST către URL-ul webhookului salvat pe pagina „Setări de notificare”.

Cauze

Regula nu s-a declanșat niciodată

Pe pagina „Reguli de alertă” a cheii, coloana „Ultima declanșare” arată când s-a declanșat ultima dată o regulă. Dacă scrie „niciodată”, condiția nu a fost încă îndeplinită și nu s-a trimis nimic. Comparați pragul și operatorul cu cifrele din analiza dumneavoastră.

Regula își așteaptă fereastra de timp

O regulă se declanșează cel mult o dată pe fereastră de timp (5m, 15m, 1h, 24h). După aceea este verificată din nou abia când fereastra a trecut: o regulă cu 24h trimite cel mult o dată pe zi.

Nu este salvat niciun URL de webhook

Regula alege doar canalul; adresa propriu-zisă o salvați pe pagina „Setări de notificare”. Fără adresă, regula se declanșează, dar nu se trimite nimic. Puteți salva o adresă doar cu un plan care include integrări webhook.

Adresa nu este accesibilă din internet

SilentShield livrează doar către adrese publice. Destinațiile locale și interne precum localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 sau 172.16.0.0/12 sunt respinse la salvare și din nou la conectare, inclusiv după o redirecționare. Pentru teste locale, folosiți un tunel cu o adresă HTTPS publică.

Serverul dumneavoastră răspunde prea încet

Fiecare încercare așteaptă cel mult 5 secunde răspunsul complet. Răspundeți imediat cu un status 2xx și procesați mesajul după aceea, de exemplu într-o coadă.

Serverul dumneavoastră răspunde cu o eroare sau o redirecționare

Doar codurile de status de la 200 la 299 contează ca livrate. După 5xx, 408 sau 429 ori dacă conexiunea eșuează, SilentShield reîncearcă după 2 și după 8 secunde, apoi renunță. Alte coduri 4xx precum 401, 403 sau 404 nu sunt reîncercate; un firewall sau o protecție anti-bot din fața endpointului dumneavoastră răspunde adesea cu 403. După o redirecționare 301, 302 sau 303, cererea continuă ca GET fără corp, așa că introduceți adresa finală.

Verificarea semnăturii eșuează pe serverul dumneavoastră

Dacă ați salvat un secret, fiecare cerere poartă antetul X-Signature-256: sha256= urmat de HMAC-SHA256 al corpului în hexazecimal. Calculați-l pe corpul brut exact așa cum sosește, înainte de a analiza JSON-ul; un corp analizat și scris din nou are altă semnătură. Fără secret, antetul lipsește.

Ce ajunge la serverul dumneavoastră

O livrare arată astfel. X-Event-ID rămâne același la toate încercările unei livrări; după el recunoașteți duplicatele.

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

Verificarea semnăturii

Exemplu în Node.js; rawBody este corpul nemodificat al cererii:

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

Cum configurați regulile și canalele: Reguli de alertă