Integrazzjoni JavaScript

Integra SilentShield fi kwalunkwe websajt bl-użu ta' JavaScript purat, jew uża l-gwidi speċifiċi tagħna għal React, Vue, u Angular.

1. Żid l-Iskript Tag

Żid dan l-iskript tag mal-HTML tiegħek, idealment qabel it-tag tal-għeluq </body>:

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

2. Inizjalizza l-Widget

Ma hemmx bżonn ta' inizjalizzazzjoni manwali — client.js jinizjalizza ruħu waħdu u jtella' l-konfigurazzjoni tal-widget (tema, lingwa, badge) mis-settings tad-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.

Għażliet ta' Konfigurazzjoni

apiKey

API key (meħtieġa)

lang

Kodiċi tal-lingwa jew 'auto' għal detezzjoni awtomatika tal-browser (default: 'auto'). Jappoġġja 25 lingwa.

thresholdSuspicious

Punteġġ taħt din il-limita jattiva sfida (default: 0.6)

thresholdBlock

Punteġġ taħt din il-limita jimblokka t-talba (default: 0.3)

telemetry

Attiva t-traċċar tal-imġiba (default: true)

captchaUI

Uri l-interfaċċja CAPTCHA meta meħtieġa (default: true)

fallbackCaptcha

Attiva l-CAPTCHA matematika bħala fallback (default: true)

showBrandingBadge

Uri l-badge 'Protett minn SilentShield' (default: true)

zeroPii

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

debugOverlay

Uri l-overlay tad-debug (default: false)

onVerdict

Funzjoni ta' callback li tissejjaħ meta jinkiseb verdett

Aqra n-Nonce

Wara s-sottomissjoni tal-formola, in-nonce huwa disponibbli bħala qasam moħbi:

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