Integracja JavaScript

Zintegruj SilentShield z dowolną witryną za pomocą czystego JavaScript lub skorzystaj z naszych dedykowanych przewodników dla React, Vue i Angular.

1. Dodaj tag skryptu

Dodaj ten tag skryptu do swojego kodu HTML, najlepiej przed zamykającym tagiem </body>:

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

2. Zainicjalizuj widget

Ręczna inicjalizacja nie jest potrzebna — client.js inicjalizuje się sam i pobiera konfigurację widżetu (motyw, język, odznakę) z ustawień panelu:

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

Opcje konfiguracji

apiKey

Klucz API (wymagany)

lang

Kod języka lub 'auto' dla automatycznego wykrywania przeglądarki (domyślnie: 'auto'). Obsługuje 25 języków.

thresholdSuspicious

Wynik poniżej tego progu uruchamia wyzwanie (domyślnie: 0.6)

thresholdBlock

Wynik poniżej tego progu blokuje żądanie (domyślnie: 0.3)

telemetry

Włącz śledzenie zachowań (domyślnie: true)

captchaUI

Wyświetlaj interfejs CAPTCHA w razie potrzeby (domyślnie: true)

fallbackCaptcha

Włącz matematyczną CAPTCHA jako rozwiązanie awaryjne (domyślnie: true)

showBrandingBadge

Wyświetlaj znaczek „Chronione przez SilentShield" (domyślnie: true)

zeroPii

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

debugOverlay

Wyświetlaj nakładkę debugowania (domyślnie: false)

onVerdict

Funkcja zwrotna wywoływana po otrzymaniu werdyktu

Odczytywanie nonce

Po przesłaniu formularza nonce jest dostępny jako ukryte pole:

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