JavaScript integráció

Integrálja a SilentShieldet bármely weboldalba hagyományos JavaScript használatával, vagy kövesse keretrendszer-specifikus útmutatóinkat a React, Vue és Angular számára.

1. Adja hozzá a script címkét

Adja hozzá ezt a script címkét a HTML-hez, ideális esetben a záró </body> címke elé:

HTMLhtml
<script src="https://api.silentshield.io/client.js?key=YOUR_API_KEY" defer></script>

2. Inicializálja a widgetet

Hívja meg a SilentShield.init() függvényt a DOM betöltése után:

JavaScriptjavascript
document.addEventListener('DOMContentLoaded', function() {
  SilentShield.init({
    apiKey: 'YOUR_API_KEY',
    lang: 'auto',
    features: {
      telemetry: true,
      captchaUI: true,
      fallbackCaptcha: true,
      showBrandingBadge: true,
    },
    onVerdict: function(response) {
      console.log('SilentShield verdict:', response);
    }
  });
});

Beállítási lehetőségek

apiKey
API-kulcs (kötelező)
lang
Nyelvi kód vagy 'auto' a böngésző automatikus felismeréséhez (alapértelmezett: 'auto'). 25 nyelvet támogat.
thresholdSuspicious
Ez alatti pontszám kihívást vált ki (alapértelmezett: 0.6)
thresholdBlock
Ez alatti pontszám blokkolja a kérést (alapértelmezett: 0.3)
telemetry
Viselkedéskövetés engedélyezése (alapértelmezett: true)
captchaUI
CAPTCHA felhasználói felület megjelenítése szükség esetén (alapértelmezett: true)
fallbackCaptcha
Matematikai CAPTCHA tartalék megoldás engedélyezése (alapértelmezett: true)
showBrandingBadge
»A SilentShield védi« jelvény megjelenítése (alapértelmezett: true)
zeroPii
Disable browser fingerprinting for maximum privacy (default: false). See Features → Zero-PII Mode.
debugOverlay
Hibakeresési réteg megjelenítése (alapértelmezett: false)
onVerdict
Visszahívási függvény, amely az ítélet beérkezésekor hívódik meg

Egyoldalas alkalmazások (SPA)

Kliensoldali útválasztást használó SPA alkalmazások esetén (React Router, Vue Router stb.) a SilentShield automatikusan figyeli a DOM változásokat és felismeri az új űrlapokat. Navigáció után nincs szükség újrainicializálásra.

A nonce kiolvasása

Az űrlap beküldése után a nonce rejtett mezőként érhető el:

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