Pakkumine uutele klientidele−20 %20 % allahindlust esimesed 3 kuud igakuise maksegaVaadake pakette
SilentShield

Webhookid ei jõua kohale

Olete loonud hoiatusreegli kanaliga Webhook, kuid teie server ei saa midagi. Siit näete, millal SilentShield webhooki saadab ja mis võib selle teel peatada.

Millal SilentShield webhooki saadab

Webhooke saadavad ainult API-võtme hoiatusreeglid, mille kanal on Webhook. Kord minutis kontrollib SilentShield iga aktiivset reeglit. Kui selle tingimus on ajaaknas täidetud, saadetakse üks POST-päring webhooki URL-ile, mis on salvestatud lehel „Teavituste seaded“.

Põhjused

Reegel pole kunagi käivitunud

Võtme lehel „Hoiatusreeglid“ näitab veerg „Viimati käivitunud“, millal reegel viimati käivitus. Kui seal on „mitte kunagi“, pole tingimus veel täitunud ja midagi pole saadetud. Võrrelge läve ja operaatorit oma analüütika numbritega.

Reegel ootab oma ajaakna lõppu

Reegel käivitub ühe ajaakna jooksul (5m, 15m, 1h, 24h) kõige rohkem korra. Pärast seda kontrollitakse seda uuesti alles siis, kui aken on möödas: 24h reegel saadab kõige rohkem kord päevas.

Webhooki URL-i pole salvestatud

Reegel valib ainult kanali; aadressi enda salvestate lehel „Teavituste seaded“. Ilma aadressita reegel käivitub, kuid midagi ei saadeta. Aadressi saate salvestada ainult paketiga, mis sisaldab webhooki integratsioone.

Aadress pole internetist kättesaadav

SilentShield saadab ainult avalikele aadressidele. Kohalikud ja sisemised sihtkohad, nagu localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 või 172.16.0.0/12, lükatakse salvestamisel tagasi ja ühendamisel uuesti, ka pärast ümbersuunamist. Kohalikeks testideks kasutage avaliku HTTPS-aadressiga tunnelit.

Teie server vastab liiga aeglaselt

Iga katse ootab täielikku vastust kõige rohkem 5 sekundit. Vastake kohe olekuga 2xx ja töödelge sõnumit hiljem, näiteks järjekorras.

Teie server vastab vea või ümbersuunamisega

Kohaletoimetatuks loetakse ainult olekukoodid 200 kuni 299. Pärast vastust 5xx, 408 või 429 või kui ühendus ebaõnnestub, proovib SilentShield uuesti 2 ja 8 sekundi pärast ning loobub siis. Muid 4xx-koode, nagu 401, 403 või 404, ei korrata; tulemüür või robotikaitse teie lõpp-punkti ees vastab sageli koodiga 403. Pärast ümbersuunamist koodiga 301, 302 või 303 jätkub päring GET-päringuna ilma sisuta, seega sisestage lõplik aadress.

Allkirja kontroll teie serveris ebaõnnestub

Kui olete salvestanud saladuse, kannab iga päring päist X-Signature-256: sha256= ja selle järel sisu HMAC-SHA256 kuueteistkümnendkujul. Arvutage see töötlemata sisust täpselt sellisena, nagu see saabub, enne JSON-i parsimist; parsitud ja uuesti kirjutatud sisul on teine allkiri. Ilma saladuseta päis puudub.

Mis teie serverisse jõuab

Üks saadetis näeb välja selline. X-Event-ID jääb ühe saadetise kõigil katsetel samaks; selle järgi tunnete ära duplikaadid.

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

Allkirja kontrollimine

Näide Node.js-is; rawBody on päringu muutmata sisu:

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

Kuidas reegleid ja kanaleid seadistada: Teavitusreeglid