Webhookit eivät saavu perille
Olet luonut hälytyssäännön kanavalla Webhook, mutta palvelimesi ei saa mitään. Tässä näet, milloin SilentShield lähettää webhookin ja mikä voi pysäyttää sen matkalla.
Milloin SilentShield lähettää webhookin
Webhookeja lähettävät vain sellaiset API-avaimen hälytyssäännöt, joiden kanava on Webhook. Kerran minuutissa SilentShield tarkistaa jokaisen aktiivisen säännön. Jos sen ehto täyttyy aikaikkunan sisällä, se lähettää yhden POST-pyynnön webhook-URL-osoitteeseen, joka on tallennettu sivulla ”Ilmoitusasetukset”.
Syyt
Sääntö ei ole koskaan lauennut
Avaimen sivulla ”Hälytyssäännöt” sarake ”Viimeksi laukesi” näyttää, milloin sääntö laukesi viimeksi. Jos siinä lukee ”ei koskaan”, ehto ei ole vielä täyttynyt eikä mitään ole lähetetty. Vertaa kynnysarvoa ja operaattoria analytiikkasi lukuihin.
Sääntö odottaa aikaikkunansa loppua
Sääntö laukeaa enintään kerran aikaikkunaa kohden (5m, 15m, 1h, 24h). Sen jälkeen se tarkistetaan uudelleen vasta, kun ikkuna on kulunut: 24h-sääntö lähettää enintään kerran päivässä.
Webhook-URL-osoitetta ei ole tallennettu
Sääntö valitsee vain kanavan; itse osoitteen tallennat sivulla ”Ilmoitusasetukset”. Ilman osoitetta sääntö laukeaa, mutta mitään ei lähetetä. Osoitteen voit tallentaa vain paketilla, johon sisältyvät webhook-integraatiot.
Osoite ei ole tavoitettavissa internetistä
SilentShield toimittaa vain julkisiin osoitteisiin. Paikalliset ja sisäiset kohteet, kuten localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 tai 172.16.0.0/12, hylätään tallennettaessa ja uudelleen yhdistettäessä, myös uudelleenohjauksen jälkeen. Käytä paikallisissa testeissä tunnelia, jolla on julkinen HTTPS-osoite.
Palvelimesi vastaa liian hitaasti
Jokainen yritys odottaa täydellistä vastausta enintään 5 sekuntia. Vastaa heti tilakoodilla 2xx ja käsittele viesti vasta sen jälkeen, esimerkiksi jonossa.
Palvelimesi vastaa virheellä tai uudelleenohjauksella
Toimitetuksi lasketaan vain tilakoodit 200–299. Vastauksen 5xx, 408 tai 429 jälkeen tai jos yhteys epäonnistuu, SilentShield yrittää uudelleen 2 ja 8 sekunnin kuluttua ja luovuttaa sitten. Muita 4xx-koodeja, kuten 401, 403 tai 404, ei yritetä uudelleen; päätepisteesi edessä oleva palomuuri tai bottisuojaus vastaa usein koodilla 403. Uudelleenohjauksen 301, 302 tai 303 jälkeen pyyntö jatkuu GET-pyyntönä ilman runkoa, joten anna lopullinen osoite.
Allekirjoituksen tarkistus epäonnistuu palvelimellasi
Jos olet tallentanut salaisuuden, jokaisessa pyynnössä on otsake X-Signature-256: sha256= ja sen perässä rungon HMAC-SHA256 heksadesimaalimuodossa. Laske se käsittelemättömästä rungosta täsmälleen sellaisena kuin se saapuu, ennen JSONin jäsentämistä; jäsennetyllä ja uudelleen kirjoitetulla rungolla on eri allekirjoitus. Ilman salaisuutta otsake puuttuu.
Mitä palvelimellesi saapuu
Toimitus näyttää tältä. X-Event-ID pysyy samana saman toimituksen kaikissa yrityksissä; sen avulla tunnistat kaksoiskappaleet.
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"
}Allekirjoituksen tarkistaminen
Esimerkki Node.js:llä; rawBody on pyynnön muuttamaton runko:
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")Näin määrität säännöt ja kanavat: Hälytyssäännöt