SolveHub
日本語

CAPTCHA の種類 · awswaf

AWS WAF CAPTCHA 解決 API：aws-waf-token を REST で取得

SolveHub API で AWS WAF のチャレンジと CAPTCHA を解決：チャレンジスクリプト URL、任意の captcha スクリプトとプロキシを送信し aws-waf-token を取得。フィールド、cURL 例、エラー。

許可された QA 自動化とブラウザー連携向けです。テスト権限のあるサイトと業務フローでのみ使用してください。

このタスクを作成するには、下記の JSON を POST /v1/tasks に Authorization: Bearer <API_KEY>、Content-Type: application/json、Idempotency-Key 付きで送信します。事前にリアルタイム料金で利用可能か確認し、作成から照会までの流れはクイックスタートを参照してください。

保護対象ページの websiteURL と、チャレンジスクリプトの完全なアドレス WafScriptUrl（大文字・小文字に注意）は必須です。HTTP プロキシは任意です。このタイプではカスタムの useragent フィールドは受け付けません。スクリプト URL は実際の AWS WAF チャレンジページから取得してください。

リクエストフィールド

外側の type と task は必須です。以下の task.* パスはすべて task オブジェクト内にあります。フィールド名は大文字と小文字を区別します。長さの制限は UTF-8 のバイト数で計算されます。

フィールド 型 必須 制限 説明
type 文字列 はい awswaf 固定 プラットフォームのタスクタイプ。
task JSON オブジェクト はい ≤ 7 MiB このタイプのタスクパラメータ。
task.type 文字列 いいえ 指定する場合は awswaf であること 旧リクエスト形式との互換用です。新規の連携では省略できます。
task.websiteURL HTTP(S) URL はい ≤ 2048 バイト 解決対象ページの完全な URL です。アカウント名やパスワードは含めないでください。
task.WafScriptUrl HTTP(S) URL はい ≤ 4096 バイト 対象ページに挿入されている AWS WAF チャレンジスクリプトの完全な URL です。フィールド名は大文字と小文字を区別します。
task.proxyType 文字列 いいえ http のみ プロキシのプロトコルです。指定する場合は http である必要があります。
task.proxyAddress 文字列 いいえ ≤ 256 バイト プロキシの IP アドレスまたはホスト名です。proxyPort と併せて指定する必要があります。
task.proxyPort 文字列 いいえ 1–5 バイト、値は 1–65535 プロキシのポートです。引用符で囲んだ数字の文字列で指定する必要があります。
task.proxyLogin 文字列 いいえ ≤ 256 バイト プロキシに認証が必要な場合のユーザー名です。アドレスとポートを指定せずに単独で指定することはできません。
task.proxyPassword 文字列 いいえ ≤ 256 バイト プロキシに認証が必要な場合のパスワードです。アドレスとポートを指定せずに単独で指定することはできません。

作成リクエストの例

{
  "type": "awswaf",
  "task": {
    "websiteURL": "https://example.com/protected",
    "WafScriptUrl": "https://example.com/challenge.js"
  }
}

cURL での呼び出し

例の API キー、サイト情報、プロキシを実際の値に置き換えてください。Idempotency-Key は同一の業務リクエストに対して同じ値を維持してください。

curl -sS -X POST 'https://www.tiam.codes/v1/tasks' \
  -H 'Authorization: Bearer sh_REPLACE_ME' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-awswaf-0001' \
  --data-binary @- <<'JSON'
{
  "type": "awswaf",
  "task": {
    "websiteURL": "https://example.com/protected",
    "WafScriptUrl": "https://example.com/challenge.js"
  }
}
JSON

作成レスポンスと照会

作成に成功すると HTTP 202 が返され、status の初期値は通常 queued です。taskId を保存し、約 2–3 秒ごとに GET /v1/tasks/{taskId} を呼び出して照会してください。このタイプの処理のソフトタイムリミットは 180 秒 です。ソフトタイムリミットを超えると uncertain になる場合があります。受理済みのタスクの結果は引き続き確認できるため、クライアントは新しい冪等キー（Idempotency-Key）で安易に再作成しないでください。

結果フィールド

solution は status=completed の場合にのみ読み取ってください。下表は主なフィールドの一覧です。実際のフィールドは当該タスクのレスポンスに従ってください。

フィールド 型 読み取り方法
solution.value 文字列、任意 検証トークンが直接返される場合があります。
solution.cookies オブジェクト、任意 aws-waf-token Cookie が含まれる場合があります。実際のレスポンスに従ってください。
solution.useragent 文字列、任意 カスタムプロキシを使用する場合は、同じ送信元 IP と併せて再利用してください。

完了後、solution.value または solution.cookies["aws-waf-token"] からトークンを取得し、対象業務の要件に従って aws-waf-token Cookie として送信してください。結果の例：{"value":"EXAMPLE_TOKEN","cookies":{"aws-waf-token":"EXAMPLE_TOKEN"},"useragent":"Mozilla/5.0 ..."}。プロキシを指定した場合、後続のリクエストでは同じ送信元 IP と solution.useragent を使用してください。

失敗とトラブルシューティング

実際のチャレンジスクリプト URL を指定する必要があり、フィールド名は正確に WafScriptUrl としてください。カスタムの useragent リクエストフィールドはサポートされていません。

作成リクエストでよく発生するエラーは 400 INVALID_TASK、402 INSUFFICIENT_BALANCE、429 TASK_LIMIT_EXCEEDED、503 TYPE_UNAVAILABLE です。作成済みのタスクが失敗した場合の公開エラーコードは TASK_FAILED または TASK_TIMEOUT で、uncertain は TASK_UNCERTAIN に対応します。詳しくは プラットフォーム API リファレンス を参照してください。

処理時間はタスク作成の受理確認後に起算し、待ち行列の時間は差し引きません。ノードの現在のタイムアウトは約100秒、プラットフォームのソフト期限は通信と結果確認を含め180秒です。

関連ドキュメント

cURL で始めるアカウント作成

最終更新: