Integrazione JavaScript

Integri SilentShield in qualsiasi sito web utilizzando JavaScript puro, oppure utilizzi le nostre guide specifiche per React, Vue e Angular.

1. Aggiungere il tag script

Aggiunga questo tag script al Suo HTML, idealmente prima del tag di chiusura </body>:

<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>

2. Inizializzare il Widget

Chiami SilentShield.init() dopo il caricamento del DOM:

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);
    }
  });
});

Opzioni di configurazione

apiKey

API Key (obbligatoria)

lang

Codice lingua o 'auto' per il rilevamento del browser (predefinito: 'auto'). Supporta 25 lingue.

thresholdSuspicious

Un punteggio inferiore a questo valore attiva una sfida (predefinito: 0.6)

thresholdBlock

Un punteggio inferiore a questo valore blocca la richiesta (predefinito: 0.3)

telemetry

Abilita il tracciamento del comportamento (predefinito: true)

captchaUI

Mostra l'interfaccia CAPTCHA quando necessario (predefinito: true)

fallbackCaptcha

Abilita il CAPTCHA matematico di riserva (predefinito: true)

showBrandingBadge

Mostra il badge 'Protetto da SilentShield' (predefinito: true)

zeroPii

Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.

debugOverlay

Mostra l'overlay di debug (predefinito: false)

onVerdict

Funzione di callback chiamata quando viene ricevuto un verdetto

Lettura del Nonce

Dopo l'invio del modulo, il Nonce è disponibile come campo nascosto:

const nonce = document.querySelector('input[name="ss_nonce"]')?.value;