Oferta dla nowych klientów−20 %20 % zniżki przez pierwsze 3 miesiące przy płatności miesięcznejZobacz plany
SilentShield

Webhooki nie docierają

Utworzono regułę alertu z kanałem Webhook, ale serwer nic nie otrzymuje. Tutaj opisano, kiedy SilentShield wysyła webhook i co może go zatrzymać po drodze.

Kiedy SilentShield wysyła webhook

Webhooki wysyłają tylko reguły alertów klucza API, których kanałem jest Webhook. Raz na minutę SilentShield sprawdza każdą aktywną regułę. Jeśli jej warunek jest spełniony w oknie czasowym, wysyła jedno żądanie POST na adres URL webhooka zapisany na stronie „Ustawienia powiadomień”.

Przyczyny

Reguła nigdy się nie uruchomiła

Na stronie „Reguły alertów” klucza kolumna „Ostatnie uruchomienie” pokazuje, kiedy reguła uruchomiła się ostatnio. Jeśli widnieje tam „nigdy”, warunek nie został jeszcze spełniony i nic nie wysłano. Warto porównać próg i operator z liczbami w analityce.

Reguła czeka na upływ okna czasowego

Reguła uruchamia się najwyżej raz na okno czasowe (5m, 15m, 1h, 24h). Potem jest sprawdzana ponownie dopiero po upływie okna: reguła z 24h wysyła najwyżej raz dziennie.

Nie zapisano adresu URL webhooka

Reguła wybiera tylko kanał; sam adres zapisuje się na stronie „Ustawienia powiadomień”. Bez adresu reguła się uruchamia, ale nic nie jest wysyłane. Adres można zapisać tylko w planie, który obejmuje integracje webhook.

Adres jest nieosiągalny z internetu

SilentShield dostarcza tylko na adresy publiczne. Lokalne i wewnętrzne cele, takie jak localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 lub 172.16.0.0/12, są odrzucane przy zapisie i ponownie przy łączeniu, także po przekierowaniu. Do testów lokalnych należy użyć tunelu z publicznym adresem HTTPS.

Serwer odpowiada zbyt wolno

Każda próba czeka na pełną odpowiedź najwyżej 5 s. Należy od razu odpowiedzieć statusem 2xx, a wiadomość przetworzyć później, na przykład w kolejce.

Serwer odpowiada błędem lub przekierowaniem

Za dostarczone uznawane są tylko kody statusu od 200 do 299. Po 5xx, 408 lub 429 albo gdy połączenie się nie powiedzie, SilentShield ponawia próbę po 2 s i po 8 s, a potem rezygnuje. Inne kody 4xx, takie jak 401, 403 lub 404, nie są ponawiane; zapora lub ochrona przed botami przed punktem końcowym często odpowiada kodem 403. Po przekierowaniu 301, 302 lub 303 żądanie jest kontynuowane jako GET bez treści, dlatego należy podać docelowy adres.

Weryfikacja podpisu na serwerze kończy się błędem

Jeśli zapisano sekret, każde żądanie zawiera nagłówek X-Signature-256: sha256=, a po nim HMAC-SHA256 treści w zapisie szesnastkowym. Należy go obliczać z surowej treści dokładnie w takiej postaci, w jakiej dotarła, przed parsowaniem JSON; treść sparsowana i zapisana ponownie ma inny podpis. Bez sekretu nagłówka nie ma.

Co dociera na serwer

Dostawa wygląda tak. X-Event-ID pozostaje taki sam we wszystkich próbach jednej dostawy; po nim można rozpoznać duplikaty.

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

Weryfikacja podpisu

Przykład w Node.js; rawBody to niezmieniona treść żądania:

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

Jak skonfigurować reguły i kanały: Reguły alertów