Ενσωμάτωση JavaScript
Ενσωματώστε το SilentShield σε οποιονδήποτε ιστότοπο χρησιμοποιώντας καθαρό JavaScript, ή χρησιμοποιήστε τους ειδικούς οδηγούς μας για React, Vue και Angular.
1. Προσθέστε την ετικέτα Script
Προσθέστε αυτήν την ετικέτα script στο HTML σας, ιδανικά πριν από την ετικέτα κλεισίματος </body>:
HTMLhtml
<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>2. Αρχικοποιήστε το Widget
Καλέστε το SilentShield.init() μετά τη φόρτωση του DOM:
JavaScriptjavascript
document.addEventListener('DOMContentLoaded', function() {
SilentShield.init({
apiKey: 'YOUR_API_KEY',
lang: 'auto',
features: {
telemetry: true,
captchaUI: true,
fallbackCaptcha: true,
showBrandingBadge: true,
},
onVerdict: function(response) {
console.log('SilentShield verdict:', response);
}
});
});Επιλογές ρύθμισης παραμέτρων
apiKey- API κλειδί (απαιτείται)
lang- Κωδικός γλώσσας ή 'auto' για αυτόματη ανίχνευση προγράμματος περιήγησης (προεπιλογή: 'auto'). Υποστηρίζει 25 γλώσσες.
thresholdSuspicious- Βαθμολογία κάτω από αυτήν ενεργοποιεί πρόκληση (προεπιλογή: 0.6)
thresholdBlock- Βαθμολογία κάτω από αυτήν αποκλείει το αίτημα (προεπιλογή: 0.3)
telemetry- Ενεργοποίηση παρακολούθησης συμπεριφοράς (προεπιλογή: true)
captchaUI- Εμφάνιση διεπαφής CAPTCHA όταν χρειάζεται (προεπιλογή: true)
fallbackCaptcha- Ενεργοποίηση εφεδρικής μαθηματικής CAPTCHA (προεπιλογή: true)
showBrandingBadge- Εμφάνιση σήματος 'Προστατεύεται από το SilentShield' (προεπιλογή: true)
zeroPii- Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.
debugOverlay- Εμφάνιση πίνακα αποσφαλμάτωσης (προεπιλογή: false)
onVerdict- Συνάρτηση callback που καλείται όταν λαμβάνεται ετυμηγορία
Εφαρμογές μονής σελίδας (SPA)
Για SPA εφαρμογές που χρησιμοποιούν δρομολόγηση στην πλευρά του πελάτη (React Router, Vue Router κ.λπ.), το SilentShield παρακολουθεί αυτόματα τις αλλαγές στο DOM και ανιχνεύει νέες φόρμες. Δεν απαιτείται επαν-αρχικοποίηση μετά την πλοήγηση.
Ανάγνωση του Nonce
Μετά την υποβολή της φόρμας, το nonce είναι διαθέσιμο ως κρυφό πεδίο:
HTMLhtml
const nonce = document.querySelector('input[name="ss_nonce"]')?.value;