CORS エラー
ブラウザーのコンソールに、SilentShield へのリクエストが CORS ポリシーによってブロックされたと表示されています。例:Access to fetch at 'https://api.silentshield.io/…' from origin 'https://your-site.example' has been blocked by CORS policy。原因と対処方法は次のとおりです。
SilentShield の応答
API は、どの Web サイトからのリクエストにも、ブラウザーが必要とする CORS ヘッダーを付けて応答します。403 や 429 などのエラー応答も同様です。他の Web サイトからの Cookie は一切受け付けません。ウィジェットは API キーで自身を識別します。
原因
応答に CORS ヘッダーがない
その場合、応答は SilentShield の API からではなく、途中にあるもの(ファイアウォール、プロキシ、ブラウザー拡張機能、502 や 504 などのゲートウェイエラー)から来ています。開発者ツールの[ネットワーク]タブでリクエストを開き、ステータスと応答ヘッダーを確認してください。ステータスが (failed) または 0 の場合、リクエストは当社に届いていません。
リクエストが Cookie を送信している
コードが credentials: 'include'(fetch)または withCredentials: true(XMLHttpRequest、axios)でリクエストを送信しています。API は他の Web サイトに対してこれを許可しないため、ブラウザーは応答を破棄します。このオプションを削除してください。API に必要なのは API キーだけです。
独自のリクエストヘッダー
このようなリクエストの前に、ブラウザーは OPTIONS リクエスト(プリフライト)でヘッダーが許可されているかを確認します。下の一覧にないヘッダーはこの確認を通過できず、リクエストは送信されません。追加のデータはリクエスト本文で送信してください。
応答ヘッダーを読み取れない
応答ヘッダーのうち、ブラウザーの JavaScript が読み取れるのは Content-Length だけです。そのため、クォータのヘッダー(X-Quota-…)はサーバー側でしか確認できません。ブラウザーはエラーを表示せず、値は単に null になります。
client.js がブロックされる(403 または ERR_BLOCKED_BY_ORB)
リクエストに Origin も Referer も含まれていなかったため(例:Referrer-Policy: no-referrer の場合)、ドメインの確認でサイトを識別できませんでした。ダッシュボードのスニペットと同じく、script タグに referrerpolicy="origin" を追加してください。
検証をブラウザーで行っている
/v1/verify はサーバー側で呼び出してください。ブラウザーでは誰でも API キーを読み取れ、ボットは検証を単に飛ばすことができます。フォームを behavior_nonce フィールドごとサーバーに送信し、そこで検証してください。
許可されているリクエストヘッダー
ブラウザーが SilentShield の API に送信できるヘッダーは次のとおりです:
Origin
Content-Type
Accept
Authorization
X-API-Key
X-Page-URL
X-Page-Path
X-Requested-With
Stripe-Signature
X-SilentShield-ZeroPIIドメイン自体がキーに登録されていませんか? ドメイン不一致