reCAPTCHA v2、v3、Enterprise：必要な種類を見極める
まずページが v2 と v3 のどちらを使用しているかを特定し、次に Enterprise を使用しているかを確認します。Enterprise にはチェックボックス型とスコアベース型のキーがあり、名前だけではどちらのフローか判断できません。solvethree は標準の v3 と Enterprise v3 に対応していますが、v2 には対応していません。
このページの内容
ページから実際にわかること
| 見つかったもの | わかること |
|---|---|
| reCAPTCHA のチェックボックスウィジェット | チェックボックス型のフローであり、スコアベースの v3 である証拠ではありません。従来のライブラリと Enterprise ライブラリのどちらを使用しているか確認してください。 |
| チェックボックスがない | これだけでは判断できません。v2 は非表示の場合もあるため、目に見える表示がないページでも v3 とは断定できません。 |
| 名前付きアクションによるスコアベースの実行 | v3 であることを示す手がかりです。実行時に使用されるライブラリとキー設定を確認してください。 |
| api.js | 従来の reCAPTCHA ライブラリです。ファイル名だけでは v2 と v3 を区別できません。 |
| enterprise.js | Enterprise ライブラリです。キーの種類とフローを特定する必要があり、これだけでは v3 と断定できません。 |
<!-- Classic script: investigate whether the page uses v2 or v3. -->
<script src="https://www.google.com/recaptcha/api.js?render=PUBLIC_SITE_KEY"></script>
<!-- Enterprise script: investigate which Enterprise key type is in use. -->
<script src="https://www.google.com/recaptcha/enterprise.js?render=PUBLIC_SITE_KEY"></script>これらのスクリプトタグは識別用の例であり、ソルバーへのリクエストではありません。スクリプトのファイル名だけでタスクを選ばず、保護対象の操作で使用されるコードを確認してください。トークン文字列だけでは、どのフローで生成されたかはわかりません。
ホスト名とアクションを確認する
スコアベースの連携では、完了させたい操作で使用されるアクションを見つけてください。ボタンのラベルから推測したり、別のページのアクションを流用したりしないでください。ウェブサイトはバックエンドで期待するアクションを確認できるため、別の操作用のトークンで代用することはできません。
対象のホスト名と環境も確認してください。連携を管理している場合は、キー設定を確認すると、ページ上の曖昧な手がかりを解消できます。公開サイトキーはウェブサイトの連携を識別するものであり、ウェブサイトの検証用シークレットや solvethree API キーではありません。
ページのアクションがわからない場合は、reCAPTCHA アクションの確認方法を参照してください。
対応するタスクを選ぶ
| 確認済みの連携 | 対処方法 |
|---|---|
| スコアベースの reCAPTCHA Enterprise | reCAPTCHA v3 Enterprise タスクを使用してください。recaptchaType のデフォルトは enterprise-v3 ですが、明示的に指定することもできます。 |
| 従来のスコアベースの reCAPTCHA v3 | ゲートウェイは recaptchaType を v3 に設定したリクエストを受け付けます。Enterprise のデフォルトに頼らず、明示的に指定してください。 |
| Enterprise のチェックボックス型フローを含む、チェックボックス型または非表示型の reCAPTCHA v2 | solvethree では非対応です。recaptchaType を変更しても、v2 のフローが v3 に変わるわけではありません。 |
| Enterprise スクリプトはあるが、フローがまだ不明 | タスクを作成する前に、キーの種類と実行フローを確認してください。 |
種類がわかったら、最初の解決を実行する前に、そのサイトプロファイルを設定してください。
続いて、サイトプロファイルの設定と reCAPTCHA API 連携を参照してください。
参照元とAPIリファレンス
最初のタスクを実行しましょう。
$5のワークスペースクレジットで始められます。