Pasiūlymas naujiems klientams−20 %20 % nuolaida pirmiems 3 mėnesiams mokant kas mėnesįŽiūrėti planus
SilentShield

Webhookai neatkeliauja

Sukūrėte įspėjimo taisyklę su kanalu Webhook, bet Jūsų serveris nieko negauna. Čia rasite, kada SilentShield siunčia webhooką ir kas jį gali sustabdyti pakeliui.

Kada SilentShield siunčia webhooką

Webhookus siunčia tik tos API rakto įspėjimų taisyklės, kurių kanalas yra Webhook. Kartą per minutę SilentShield patikrina kiekvieną aktyvią taisyklę. Jei jos sąlyga laiko lange įvykdyta, išsiunčiama viena POST užklausa į webhook URL, išsaugotą puslapyje „Pranešimų nustatymai“.

Priežastys

Taisyklė dar niekada nesuveikė

Rakto puslapyje „Įspėjimų taisyklės“ stulpelis „Paskutinį kartą suveikė“ rodo, kada taisyklė paskutinį kartą suveikė. Jei ten parašyta „niekada“, sąlyga dar nebuvo įvykdyta ir niekas nebuvo išsiųsta. Palyginkite slenkstį ir operatorių su savo analitikos skaičiais.

Taisyklė laukia, kol baigsis laiko langas

Taisyklė suveikia daugiausia kartą per laiko langą (5m, 15m, 1h, 24h). Po to ji vėl tikrinama tik tada, kai langas praeina: 24h taisyklė siunčia daugiausia kartą per dieną.

Neišsaugotas joks webhook URL

Taisyklė tik pasirenka kanalą; patį adresą išsaugote puslapyje „Pranešimų nustatymai“. Be adreso taisyklė suveikia, bet niekas neišsiunčiama. Adresą galite išsaugoti tik su planu, į kurį įeina webhook integracijos.

Adresas nepasiekiamas iš interneto

SilentShield pristato tik viešais adresais. Vietinės ir vidinės paskirties vietos, pavyzdžiui, localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 arba 172.16.0.0/12, atmetamos išsaugant ir dar kartą jungiantis, taip pat po peradresavimo. Vietiniams bandymams naudokite tunelį su viešu HTTPS adresu.

Jūsų serveris atsako per lėtai

Kiekvienas bandymas laukia viso atsakymo ne ilgiau kaip 5 s. Iš karto atsakykite 2xx būsena, o pranešimą apdorokite vėliau, pavyzdžiui, eilėje.

Jūsų serveris atsako klaida arba peradresavimu

Pristatytais laikomi tik būsenos kodai nuo 200 iki 299. Po 5xx, 408 ar 429 arba jei ryšys nepavyksta, SilentShield bando dar kartą po 2 s ir po 8 s, o tada liaujasi. Kiti 4xx kodai, pavyzdžiui, 401, 403 ar 404, nekartojami; ugniasienė ar apsauga nuo robotų prieš Jūsų galinį tašką dažnai atsako 403. Po peradresavimo 301, 302 ar 303 užklausa tęsiama kaip GET be turinio, todėl įveskite galutinį adresą.

Parašo patikra Jūsų serveryje nepavyksta

Jei išsaugojote slaptą raktą, kiekviena užklausa turi antraštę X-Signature-256: sha256= ir po jo turinio HMAC-SHA256 šešioliktainiu pavidalu. Skaičiuokite jį iš neapdoroto turinio tiksliai tokio, koks atkeliauja, prieš analizuodami JSON; išanalizuoto ir iš naujo įrašyto turinio parašas kitoks. Be slapto rakto antraštės nėra.

Kas atkeliauja į Jūsų serverį

Pristatymas atrodo taip. X-Event-ID visuose vieno pristatymo bandymuose išlieka toks pat; pagal jį atpažinsite dublikatus.

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

Parašo tikrinimas

Pavyzdys su Node.js; rawBody yra nepakeistas užklausos turinys:

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

Kaip nustatyti taisykles ir kanalus: Įspėjimų taisyklės