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?k=YOUR_API_KEY" crossorigin="anonymous" defer></script>

2. Inizializzare il Widget

Non serve alcuna inizializzazione manuale — client.js si inizializza da solo e carica la configurazione del widget (tema, lingua, badge) dalle impostazioni della dashboard:

// No init call needed — client.js bootstraps itself as soon as it loads
// and pulls your widget configuration (theme, language, badge) from the
// dashboard: App → API keys → [your key] → Widget.

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="behavior_nonce"]')?.value;