複数の reCAPTCHA アクション用にプロファイルを設定する

サイトプロファイルで、ホスト名、キャプチャアクション、reCAPTCHAタイプの組み合わせごとに1つのプロファイルを設定してください。この例では、両方のプロファイルでaccounts.example.comとEnterprise v3を使用します。

1. 1.

   ログイン用プロファイルを追加する

   「サイトを追加」を選択します。ログインアクションが実行されるHTTPSのページURLを入力し、Enterprise v3を選択して、キャプチャアクションをloginに設定してください。フォームでは、ナビゲーションURL、サイトキー、Refererの値も任意で指定できます。「サイトを追加」で送信します。

2. 2.

   チェックアウト用プロファイルを追加する

   同じホスト名のチェックアウトページについても同じ操作を行い、Enterprise v3のまま、キャプチャアクションをcheckoutに設定してください。

3. 3.

   両方のプロファイルがアクティブであることを確認する

   解決を行う前に、ワークスペースでアクティブなプロファイルを利用できる必要があります。キャプチャが失敗した場合は、再試行する前に表示された理由を確認してください。ホスト名とアクションを指定したタスクを送信しても、不足しているプロファイルは作成されません。

以下の各オブジェクトを、個別のPOST /v1/tasksリクエストとして送信してください。Authorization: BearerでワークスペースのAPIキーを使って認証し、そのキーはサーバー上で保持してください。

[
  {
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "login-flow-001"
  },
  {
    "site": "accounts.example.com",
    "action": "checkout",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "checkout-flow-001"
  }
]

ホスト名とプロキシのプレースホルダーを、対象のホスト名とプロキシURLに置き換えてください。各リクエストにはproxyを1つ指定します。proxyCandidatesを併せて追加しないでください。省略されたrecaptchaTypeのデフォルトはenterprise-v3です。これらのreCAPTCHAリクエストにtypeやurlフィールドを追加しないでください。

2つのrequestId値は、別々の論理タスクを識別します。新しい解決には新しいIDを使用してください。タスク作成がタイムアウトした場合は、同じリクエストで同じIDを再利用して既存のタスクを復旧してください。異なる入力でIDを再利用すると競合します。

ホスト名とreCAPTCHAタイプが一致する場合、実行アクションの完全一致によってプロファイルが選択されます。loginはログイン用プロファイルを、checkoutはチェックアウト用プロファイルを選択します。

異なる実行アクションには、一意に特定できるキャプチャ済みの対象が必要です。対象の候補が複数ある場合、solvethreeが任意のプロファイルを選ぶとは考えないでください。可能であれば、設定済みのキャプチャアクションを使用してください。選択が曖昧だと報告された場合は、タスクのホスト名、reCAPTCHAタイプ、アクションをコンソールのプロファイルと比較し、実際のコンソールやAPIのレスポンスを使って不一致を診断してください。

アクションごとに固有のサイトキーを用意することは、ルーティングのルールではありません。サイトキーでアクションを区別しようとせず、ホスト名、キャプチャアクション、reCAPTCHAタイプに基づいてプロファイルを設定してください。