Ajánlat új ügyfeleknek−20 %20 % kedvezmény az első 3 hónapra havi fizetés eseténCsomagok megtekintése
SilentShield

A webhookok nem érkeznek meg

Létrehozott egy riasztási szabályt Webhook csatornával, de a szervere semmit sem kap. Itt megtudja, mikor küld a SilentShield webhookot, és mi állíthatja meg útközben.

Mikor küld a SilentShield webhookot

Webhookot csak egy API-kulcs olyan riasztási szabályai küldenek, amelyek csatornája Webhook. A SilentShield percenként egyszer ellenőriz minden aktív szabályt. Ha a feltétel az időablakon belül teljesül, egy POST kérést küld a „Értesítési beállítások” oldalon mentett webhook URL-re.

Okok

A szabály még soha nem aktiválódott

A kulcs „Riasztási szabályok” oldalán a „Utoljára aktiválva” oszlop mutatja, mikor aktiválódott utoljára egy szabály. Ha ott „soha” áll, a feltétel még nem teljesült, és semmi sem lett elküldve. Vesse össze a küszöbértéket és az operátort az analitikája számaival.

A szabály kivárja az időablakát

Egy szabály időablakonként (5m, 15m, 1h, 24h) legfeljebb egyszer aktiválódik. Ezután csak az ablak leteltével ellenőrzi újra a rendszer: egy 24h-s szabály legfeljebb naponta egyszer küld.

Nincs mentett webhook URL

A szabály csak a csatornát választja ki; magát a címet a „Értesítési beállítások” oldalon menti. Cím nélkül a szabály aktiválódik, de semmi sem megy ki. Címet csak olyan csomaggal menthet, amely tartalmazza a webhook-integrációkat.

A cím nem érhető el az internetről

A SilentShield csak nyilvános címekre kézbesít. A helyi és belső célokat, például localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 vagy 172.16.0.0/12, mentéskor és csatlakozáskor újra elutasítja, átirányítás után is. Helyi tesztekhez használjon nyilvános HTTPS-címmel rendelkező tunnelt.

A szervere túl lassan válaszol

Minden kísérlet legfeljebb 5 másodpercig vár a teljes válaszra. Válaszoljon azonnal 2xx állapottal, és az üzenetet utána dolgozza fel, például egy várólistában.

A szervere hibával vagy átirányítással válaszol

Kézbesítettnek csak a 200 és 299 közötti állapotkódok számítanak. 5xx, 408 vagy 429 után, illetve ha a kapcsolat sikertelen, a SilentShield 2 és 8 másodperc múlva újra próbálkozik, majd feladja. Más 4xx kódokat, például 401, 403 vagy 404, nem ismétel; a végpontja előtti tűzfal vagy botvédelem gyakran 403-mal válaszol. 301, 302 vagy 303 átirányítás után a kérés GET kérésként, törzs nélkül folytatódik, ezért a végleges címet adja meg.

Az aláírás ellenőrzése a szerverén sikertelen

Ha mentett titkos kulcsot, minden kérés tartalmazza az X-Signature-256 fejlécet: sha256=, utána a törzs HMAC-SHA256 értéke hexadecimálisan. Ezt a nyers törzsből számolja ki, pontosan úgy, ahogy megérkezik, a JSON feldolgozása előtt; a feldolgozott és újraírt törzs aláírása más. Titkos kulcs nélkül a fejléc hiányzik.

Mi érkezik a szerverére

Egy kézbesítés így néz ki. Az X-Event-ID egy kézbesítés minden kísérleténél ugyanaz marad; erről ismeri fel az ismétlődéseket.

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

Az aláírás ellenőrzése

Példa Node.js-ben; a rawBody a kérés változatlan törzse:

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

A szabályok és csatornák beállítása: Riasztási szabályok