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