ボットから、あなたのサイトを守る。
SHOHS Shield は、フォームやログイン画面へのボットアクセスを判別する SHOHS の認証サービスです。「私はロボットではありません」チェックボックス型と、操作なしでスコアを返す自動判定型に対応。導入はスクリプトを1行読み込むだけ、検証はサーバーから API を叩くだけで完了します。
2つのタイプ
チェックボックス型(v2)
おなじみのチェックボックスを表示します。行動シグナルと Proof-of-Work で判定し、怪しい場合だけ画像チャレンジ(該当する画像の選択)を出します。
スコア型(v3)
ユーザー操作は不要。ページ上の行動から 0.0〜1.0 のスコアを返し、許可するかどうかはサイト側の基準で決められます。アクション名ごとに判定できます。
導入方法
1. SHOHS Cloud Console でプロジェクトを開き、「SHOHS Shield」からサイトを登録してサイトキーとシークレットキーを取得します。
2. フォームのあるページにウィジェットを設置します。
<script src="https://shield.apis.shohs.net/api.js" async defer></script> <div class="sh-shield" data-sitekey="あなたのサイトキー"></div>
3. フォーム送信時、サーバー側でトークンを検証します。
POST https://shield.apis.shohs.net/api/siteverify
secret=あなたのシークレットキー
response=フォームの shohs-shield-response の値
→ {"success": true, "challenge_ts": "...", "hostname": "example.com"}
スコア型(v3)は shohsShield.execute(sitekey, {action: 'login'}) でトークンを取得し、同じ検証 API に送ると score と action が返ります。トークンは発行から2分間・1回だけ有効です。
仕様メモ
- 検証 API のリクエスト/レスポンス形式は reCAPTCHA の siteverify と互換の形にしてあります(既存の組み込みからの移行が容易です)。
- サイトキーごとに許可ドメインを登録でき、登録外のドメインではウィジェットが動作しません。
- 検証の成否は Cloud Console の SHOHS Shield 画面で統計を確認できます。
- 詳しい導入手順は 開発者ドキュメント(SHOHS Shield) にまとめています。
よくある質問
SHOHS Shield とは何ですか?
フォームやログイン画面へのボットアクセスを判別する SHOHS の認証サービスです。Google reCAPTCHA と同じ仕組みで、「私はロボットではありません」チェックボックス型(v2)と、ユーザー操作なしでスコアを返すスコア型(v3)に対応します。
reCAPTCHA から移行できますか?
はい。検証 API(siteverify)のリクエスト・レスポンス形式が reCAPTCHA と互換の形になっているため、設置コードと検証先 URL、キーを差し替えるだけで移行できます。
料金はかかりますか?
SHOHS アカウントがあれば、SHOHS Cloud Console から無料でサイトキーとシークレットキーを発行して利用できます。
画像チャレンジは毎回表示されますか?
いいえ。行動シグナルと Proof-of-Work による判定で怪しい場合にだけ表示されます。通常のユーザーはチェックを入れるだけで通過します。
どのドメインでも使えますか?
サイトキーごとに利用するドメインを Cloud Console で登録します。登録されていないドメインではウィジェットは動作しません(localhost は開発用に常に許可されます)。