Ενσωμάτωση 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;