Webhook formatum

A SilentShield valos ideju ertesiteseket kuldhet a szerverere webhookokon keresztul. Allitsa be a webhook URL-eket a Vezerlopult → Ertesitesek menupontban.

Adatstruktura

Minden webhook adat a kovetkezo strukturat koveti:

{"event": "bot_detected", "timestamp": "2025-01-15T10:30:00Z", "data": {"keyId": "key_abc", "domain": "example.com", "ip": "203.0.113.42", "verdict": "bot", "score": 0.15, "userAgent": "Mozilla/5.0...", "page": "/contact"}}

Esemeny tipusok

Event	Description
`bot_detected`	Akkor aktivalodiik, amikor egy kerest botkent osztalyoznak.
`bot_spike`	Akkor aktivalodiik, amikor a boteszlelesek meghaladjaak a riasztasi kuszobot a beallitott idoablakban.
`quota_warning`	Akkor aktivalodiik, amikor a kvotahasznalat eleri a 80%-ot vagy 90%-ot.
`quota_exceeded`	Akkor aktivalodiik, amikor a havi kvota tullepesre kerul.
`domain_verification_failed`	Akkor aktivalodiik, amikor a domen ujraellenorzese sikertelen.
`key_rotated`	Akkor aktivalodiik, amikor egy API-kulcs rotalasra kerul.

Alairas ellenorzes

Minden webhook tartalmaz egy X-SilentShield-Signature fejlecet HMAC-SHA256 alairassal. Ellenorizze ezt az alairast, hogy megbizonyosodjon a webhook hitelessegerol.

Szerezze meg a nyers keres torzset (szovegkent, parszolas elott)
Szerezze meg az X-SilentShield-Signature fejlec erteket
Szamitsa ki a torzs HMAC-SHA256 erteket a webhook titok kulccssal
Hasonlitsa ossze a szamitott alairast a fejlec ertekevel

const crypto = require('crypto');

function verifyWebhook(body, signature, secret) {
  const computed = crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(computed),
    Buffer.from(signature)
  );
}

Ujraprobalasi iranyelvek

Ha a vegpontja nem 2xx statuszkoddal valaszol vagy idotullepes tortenik (10 masodperc), a SilentShield legfeljebb 3-szor probalja ujra exponencialis visszalepessel (1 perc, 5 perc, 30 perc). 3 sikertelen probalkozas utan a webhook sikertelenkent van megjelolve es lathato a Vezerlopult → Ertesitesek → Sikertelen kezbesitesek menupontban.

Webhook titok

A webhook titok a webhook vegpont letrehozasakor general0dik a vezerlopulton. Megtekintheti vagy ujrageneralhatja a Vezerlopult → Ertesitesek → Webhookok → Szerkesztes menupontban.