Integrare JavaScript

Integrați SilentShield în orice site web folosind JavaScript simplu sau folosiți ghidurile noastre specifice pentru React, Vue și Angular.

1. Adăugați tagul Script

Adăugați acest tag script în HTML-ul dumneavoastră, ideal înainte de tagul de închidere </body>:

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

2. Inițializați widgetul

Nu este necesară inițializarea manuală — client.js se inițializează singur și încarcă configurația widgetului (temă, limbă, insignă) din setările din 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.

Opțiuni de configurare

apiKey

Cheie API (obligatorie)

lang

Cod de limbă sau 'auto' pentru detectarea browserului (implicit: 'auto'). Suportă 25 de limbi.

thresholdSuspicious

Scorul sub acest prag declanșează o provocare (implicit: 0.6)

thresholdBlock

Scorul sub acest prag blochează cererea (implicit: 0.3)

telemetry

Activează urmărirea comportamentului (implicit: true)

captchaUI

Afișează interfața CAPTCHA când este necesar (implicit: true)

fallbackCaptcha

Activează Math CAPTCHA ca alternativă (implicit: true)

showBrandingBadge

Afișează insigna „Protejat de SilentShield" (implicit: true)

zeroPii

Dezactivează amprentarea browserului pentru confidențialitate maximă (implicit: false). Vedeți Funcționalități → Mod Zero-PII.

debugOverlay

Afișează overlay-ul de depanare (implicit: false)

onVerdict

Funcție callback apelată la primirea unui verdict

Citirea Nonce-ului

După trimiterea formularului, nonce-ul este disponibil ca un câmp ascuns:

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