JavaScript integrácia

Integrujte SilentShield do akejkoľvek webovej stránky pomocou čistého JavaScriptu alebo použite naše špecifické návody pre React, Vue a Angular.

1. Pridajte tag Script

Pridajte tento script tag do vášho HTML, ideálne pred uzatvárací tag </body>:

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

2. Inicializujte widget

Manuálna inicializácia nie je potrebná — client.js sa inicializuje sám a načíta konfiguráciu widgetu (motív, jazyk, odznak) z nastavení v dashboarde:

// 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.

Možnosti konfigurácie

apiKey

API kľúč (povinný)

lang

Kód jazyka alebo 'auto' pre detekciu prehliadača (predvolené: 'auto'). Podporuje 25 jazykov.

thresholdSuspicious

Skóre pod touto hodnotou spustí výzvu (predvolené: 0.6)

thresholdBlock

Skóre pod touto hodnotou zablokuje požiadavku (predvolené: 0.3)

telemetry

Povoliť sledovanie správania (predvolené: true)

captchaUI

Zobraziť CAPTCHA rozhranie podľa potreby (predvolené: true)

fallbackCaptcha

Povoliť Math CAPTCHA ako záložné riešenie (predvolené: true)

showBrandingBadge

Zobraziť odznak „Chránené SilentShield" (predvolené: true)

zeroPii

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

debugOverlay

Zobraziť ladiace prekrytie (predvolené: false)

onVerdict

Callback funkcia volaná pri prijatí verdiktu

Čítanie Nonce

Po odoslaní formulára je nonce dostupný ako skryté pole:

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