JavaScriptインテグレーション

バニラJavaScriptを使用してSilentShieldをウェブサイトに統合するか、React、Vue、Angular向けのフレームワーク別ガイドをご利用ください。

1. スクリプトタグを追加する

このスクリプトタグをHTMLに追加してください。閉じタグ</body>の前に配置することを推奨します：

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

2. ウィジェットを初期化する

DOMが読み込まれた後にSilentShield.init()を呼び出してください：

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);
    }
  });
});

設定オプション

apiKey

APIキー（必須）

lang

言語コードまたはブラウザ自動検出の場合は'auto'（デフォルト：'auto'）。25言語に対応しています。

thresholdSuspicious

このスコアを下回るとチャレンジが発動します（デフォルト：0.6）

thresholdBlock

このスコアを下回るとリクエストがブロックされます（デフォルト：0.3）

telemetry

行動トラッキングを有効にします（デフォルト：true）

captchaUI

必要に応じてCAPTCHA UIを表示します（デフォルト：true）

fallbackCaptcha

数学CAPTCHAフォールバックを有効にします（デフォルト：true）

showBrandingBadge

「Protected by SilentShield」バッジを表示します（デフォルト：true）

zeroPii

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

debugOverlay

デバッグオーバーレイを表示します（デフォルト：false）

onVerdict

判定結果を受信した際に呼び出されるコールバック関数

Nonceの取得

フォーム送信後、Nonceは隠しフィールドとして利用可能です：

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