I webhook non arrivano
Ha creato una regola di avviso con il canale Webhook, ma il suo server non riceve nulla. Ecco quando SilentShield invia un webhook e che cosa può fermarlo lungo il percorso.
Quando SilentShield invia un webhook
I webhook vengono inviati solo dalle regole di avviso di una chiave API il cui canale è Webhook. Una volta al minuto SilentShield controlla ogni regola attiva. Se la sua condizione è soddisfatta nella finestra temporale, invia una richiesta POST all’URL del webhook salvato nella pagina “Impostazioni notifiche”.
Cause
La regola non è mai scattata
Nella pagina “Regole di avviso” della chiave, la colonna “Ultimo scatto” indica quando una regola è scattata l’ultima volta. Se riporta “mai”, la condizione non è ancora stata soddisfatta e non è stato inviato nulla. Confronti soglia e operatore con i dati delle sue analisi.
La regola attende la sua finestra temporale
Una regola scatta al massimo una volta per finestra temporale (5m, 15m, 1h, 24h). Dopo viene controllata di nuovo solo quando la finestra è trascorsa: una regola con 24h invia al massimo una volta al giorno.
Non è salvato alcun URL del webhook
La regola sceglie solo il canale; l’indirizzo vero e proprio si salva nella pagina “Impostazioni notifiche”. Senza indirizzo la regola scatta, ma non viene inviato nulla. Può salvare un indirizzo solo con un piano che include le integrazioni webhook.
L’indirizzo non è raggiungibile da Internet
SilentShield consegna solo a indirizzi pubblici. Destinazioni locali e interne come localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 o 172.16.0.0/12 vengono rifiutate al salvataggio e di nuovo alla connessione, anche dopo un reindirizzamento. Per i test in locale usi un tunnel con un indirizzo HTTPS pubblico.
Il suo server risponde troppo lentamente
Ogni tentativo attende al massimo 5 secondi la risposta completa. Risponda subito con uno stato 2xx ed elabori il messaggio in seguito, per esempio in una coda.
Il suo server risponde con un errore o un reindirizzamento
Contano come consegnati solo i codici di stato da 200 a 299. Dopo un 5xx, 408 o 429, o se la connessione non riesce, SilentShield riprova dopo 2 e dopo 8 secondi, poi rinuncia. Gli altri codici 4xx come 401, 403 o 404 non vengono ripetuti; un firewall o una protezione anti-bot davanti al suo endpoint risponde spesso con 403. Dopo un reindirizzamento 301, 302 o 303 la richiesta prosegue come GET senza corpo, quindi indichi l’indirizzo finale.
La verifica della firma non riesce sul suo server
Se ha salvato un segreto, ogni richiesta porta l’intestazione X-Signature-256: sha256= seguito dall’HMAC-SHA256 del corpo in esadecimale. Lo calcoli sul corpo grezzo esattamente com’è arrivato, prima di analizzare il JSON; un corpo analizzato e riscritto ha un’altra firma. Senza segreto l’intestazione manca.
Che cosa arriva al suo server
Una consegna si presenta così. X-Event-ID resta uguale in tutti i tentativi di una stessa consegna; lo usi per riconoscere i duplicati.
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"
}Verificare la firma
Esempio in Node.js; rawBody è il corpo della richiesta non modificato:
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")Come configurare regole e canali: Regole di avviso