Τα webhook δεν φτάνουν
Δημιουργήσατε έναν κανόνα ειδοποίησης με κανάλι Webhook, αλλά ο διακομιστής σας δεν λαμβάνει τίποτα. Δείτε πότε το SilentShield στέλνει webhook και τι μπορεί να το σταματήσει στη διαδρομή.
Πότε το SilentShield στέλνει webhook
Webhook στέλνουν μόνο οι κανόνες ειδοποίησης ενός κλειδιού API με κανάλι Webhook. Μία φορά το λεπτό το SilentShield ελέγχει κάθε ενεργό κανόνα. Αν η συνθήκη του ισχύει μέσα στο χρονικό παράθυρο, στέλνεται ένα αίτημα POST στη διεύθυνση URL του webhook που είναι αποθηκευμένη στη σελίδα «Ρυθμίσεις ειδοποιήσεων».
Αιτίες
Ο κανόνας δεν έχει ενεργοποιηθεί ποτέ
Στη σελίδα «Κανόνες ειδοποίησης» του κλειδιού, η στήλη «Τελευταία ενεργοποίηση» δείχνει πότε ενεργοποιήθηκε τελευταία φορά ένας κανόνας. Αν γράφει «ποτέ», η συνθήκη δεν έχει ισχύσει ακόμη και δεν στάλθηκε τίποτα. Συγκρίνετε το όριο και τον τελεστή με τα στοιχεία στα αναλυτικά σας.
Ο κανόνας περιμένει το χρονικό του παράθυρο
Ένας κανόνας ενεργοποιείται το πολύ μία φορά ανά χρονικό παράθυρο (5m, 15m, 1h, 24h). Μετά ελέγχεται ξανά μόνο όταν λήξει το παράθυρο: ένας κανόνας με 24h στέλνει το πολύ μία φορά την ημέρα.
Δεν έχει αποθηκευτεί διεύθυνση URL webhook
Ο κανόνας επιλέγει μόνο το κανάλι· την ίδια τη διεύθυνση την αποθηκεύετε στη σελίδα «Ρυθμίσεις ειδοποιήσεων». Χωρίς διεύθυνση ο κανόνας ενεργοποιείται, αλλά δεν στέλνεται τίποτα. Διεύθυνση μπορείτε να αποθηκεύσετε μόνο με πρόγραμμα που περιλαμβάνει ενσωματώσεις webhook.
Η διεύθυνση δεν είναι προσβάσιμη από το διαδίκτυο
Το SilentShield παραδίδει μόνο σε δημόσιες διευθύνσεις. Τοπικοί και εσωτερικοί προορισμοί όπως localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 ή 172.16.0.0/12 απορρίπτονται κατά την αποθήκευση και ξανά κατά τη σύνδεση, και μετά από ανακατεύθυνση. Για τοπικές δοκιμές χρησιμοποιήστε ένα tunnel με δημόσια διεύθυνση HTTPS.
Ο διακομιστής σας απαντά πολύ αργά
Κάθε προσπάθεια περιμένει το πολύ 5 δευτερόλεπτα για την πλήρη απάντηση. Απαντήστε αμέσως με κατάσταση 2xx και επεξεργαστείτε το μήνυμα μετά, για παράδειγμα σε μια ουρά.
Ο διακομιστής σας απαντά με σφάλμα ή ανακατεύθυνση
Μόνο οι κωδικοί κατάστασης 200 έως 299 μετρούν ως επιτυχής παράδοση. Μετά από 5xx, 408 ή 429, ή αν η σύνδεση αποτύχει, το SilentShield δοκιμάζει ξανά μετά από 2 και μετά από 8 δευτερόλεπτα και έπειτα σταματά. Άλλοι κωδικοί 4xx όπως 401, 403 ή 404 δεν επαναλαμβάνονται· ένα τείχος προστασίας ή μια προστασία από bot μπροστά από το endpoint σας απαντά συχνά με 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")Πώς ρυθμίζετε κανόνες και κανάλια: Κανόνες ειδοποιήσεων