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;