Piedāvājums jaunajiem klientiem−20 %20 % atlaide pirmajiem 3 mēnešiem ar ikmēneša maksājumuSkatīt plānus
SilentShield

Webhook pieprasījumi nepienāk

Jūs izveidojāt brīdinājuma noteikumu ar kanālu Webhook, bet Jūsu serveris neko nesaņem. Šeit uzzināsiet, kad SilentShield sūta webhook un kas to var apturēt pa ceļam.

Kad SilentShield sūta webhook

Webhook sūta tikai tie API atslēgas brīdinājumu noteikumi, kuru kanāls ir Webhook. Reizi minūtē SilentShield pārbauda katru aktīvo noteikumu. Ja tā nosacījums laika logā ir izpildīts, tiek nosūtīts viens POST pieprasījums uz webhook URL, kas saglabāts lapā “Paziņojumu iestatījumi”.

Cēloņi

Noteikums vēl nekad nav nostrādājis

Atslēgas lapā “Brīdinājumu noteikumi” kolonna “Pēdējoreiz nostrādāja” rāda, kad noteikums pēdējoreiz nostrādāja. Ja tur rakstīts “nekad”, nosacījums vēl nav izpildīts un nekas nav nosūtīts. Salīdziniet slieksni un operatoru ar savas analītikas skaitļiem.

Noteikums gaida sava laika loga beigas

Noteikums nostrādā ne vairāk kā reizi vienā laika logā (5m, 15m, 1h, 24h). Pēc tam to atkal pārbauda tikai tad, kad logs ir pagājis: 24h noteikums sūta ne biežāk kā reizi dienā.

Nav saglabāts webhook URL

Noteikums tikai izvēlas kanālu; pašu adresi saglabājat lapā “Paziņojumu iestatījumi”. Bez adreses noteikums nostrādā, bet nekas netiek nosūtīts. Adresi varat saglabāt tikai ar plānu, kurā ietilpst webhook integrācijas.

Adrese nav sasniedzama no interneta

SilentShield piegādā tikai uz publiskām adresēm. Lokāli un iekšēji galamērķi, piemēram, localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 vai 172.16.0.0/12, tiek noraidīti saglabājot un vēlreiz savienojoties, arī pēc pāradresācijas. Lokāliem testiem izmantojiet tuneli ar publisku HTTPS adresi.

Jūsu serveris atbild pārāk lēni

Katrs mēģinājums gaida pilnu atbildi ne ilgāk kā 5 s. Atbildiet uzreiz ar statusu 2xx un apstrādājiet ziņojumu pēc tam, piemēram, rindā.

Jūsu serveris atbild ar kļūdu vai pāradresāciju

Par piegādātiem uzskata tikai statusa kodus no 200 līdz 299. Pēc 5xx, 408 vai 429 vai ja savienojums neizdodas, SilentShield mēģina vēlreiz pēc 2 s un pēc 8 s un tad pārtrauc. Citus 4xx kodus, piemēram, 401, 403 vai 404, neatkārto; ugunsmūris vai aizsardzība pret robotiem Jūsu galapunkta priekšā bieži atbild ar 403. Pēc pāradresācijas ar 301, 302 vai 303 pieprasījums turpinās kā GET bez satura, tāpēc ievadiet galīgo adresi.

Paraksta pārbaude Jūsu serverī neizdodas

Ja esat saglabājis noslēpumu, katram pieprasījumam ir galvene X-Signature-256: sha256= un aiz tā satura HMAC-SHA256 heksadecimālā pierakstā. Aprēķiniet to no neapstrādātā satura tieši tāda, kāds tas pienāk, pirms JSON parsēšanas; parsētam un no jauna ierakstītam saturam ir cits paraksts. Bez noslēpuma galvenes nav.

Kas pienāk Jūsu serverī

Piegāde izskatās šādi. X-Event-ID visos vienas piegādes mēģinājumos paliek tāds pats; pēc tā atpazīsiet dublikātus.

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

Paraksta pārbaude

Piemērs ar Node.js; rawBody ir nemainīts pieprasījuma saturs:

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

Kā iestatīt noteikumus un kanālus: Brīdinājumu noteikumi