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")Как да настроите правила и канали: Правила за известия