Оферта за нови клиенти−20 %20 % отстъпка за първите 3 месеца при месечно плащанеВижте тарифите
SilentShield

Webhook-ите не пристигат

Създали сте правило за известие с канал Webhook, но сървърът Ви не получава нищо. Ето кога SilentShield изпраща webhook и какво може да го спре по пътя.

Кога SilentShield изпраща webhook

Webhook-и изпращат само правилата за известия на API ключ, чийто канал е Webhook. Веднъж в минута SilentShield проверява всяко активно правило. Ако условието му е изпълнено в рамките на времевия прозорец, се изпраща една POST заявка към webhook URL адреса, запазен на страницата „Настройки за известия“.

Причини

Правилото никога не се е задействало

На страницата „Правила за известия“ на ключа колоната „Последно задействане“ показва кога правилото се е задействало за последно. Ако там пише „никога“, условието още не е изпълнено и нищо не е изпратено. Сравнете прага и оператора с данните в анализа си.

Правилото изчаква своя времеви прозорец

Правилото се задейства най-много веднъж за времеви прозорец (5m, 15m, 1h, 24h). След това се проверява отново едва когато прозорецът изтече: правило с 24h изпраща най-много веднъж на ден.

Няма запазен webhook URL адрес

Правилото само избира канала; самият адрес се запазва на страницата „Настройки за известия“. Без адрес правилото се задейства, но нищо не се изпраща. Адрес можете да запазите само с план, който включва webhook интеграции.

Адресът не е достъпен от интернет

SilentShield доставя само до публични адреси. Локални и вътрешни цели като localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 или 172.16.0.0/12 се отхвърлят при запазване и отново при свързване, включително след пренасочване. За локални тестове използвайте тунел с публичен HTTPS адрес.

Сървърът Ви отговаря твърде бавно

Всеки опит чака най-много 5 секунди за пълния отговор. Отговорете веднага със статус 2xx и обработете съобщението след това, например в опашка.

Сървърът Ви отговаря с грешка или пренасочване

За доставени се смятат само статус кодове от 200 до 299. След 5xx, 408 или 429 или ако връзката се провали, SilentShield опитва отново след 2 и след 8 секунди и след това се отказва. Други 4xx кодове като 401, 403 или 404 не се повтарят; защитна стена или защита от ботове пред крайната Ви точка често отговаря с 403. След пренасочване с 301, 302 или 303 заявката продължава като GET без тяло, затова въведете крайния адрес.

Проверката на подписа на сървъра Ви е неуспешна

Ако сте запазили тайна, всяка заявка носи заглавката X-Signature-256: sha256=, последвано от HMAC-SHA256 на тялото в шестнадесетичен запис. Изчислете го върху суровото тяло точно както е пристигнало, преди да анализирате JSON; тяло, което е анализирано и записано наново, има различен подпис. Без тайна заглавката липсва.

Какво пристига на сървъра Ви

Една доставка изглежда така. X-Event-ID остава същият при всички опити на една доставка; по него разпознавате дубликати.

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

Проверка на подписа

Пример в Node.js; rawBody е непромененото тяло на заявката:

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

Как да настроите правила и канали: Правила за известия