Google Cloud Armor の reCAPTCHA トークン属性

このドキュメントでは、Google Cloud Armor のセキュリティ ポリシーの構成時に使用できる reCAPTCHA アクション トークンの属性と reCAPTCHA セッション トークンの属性について説明します。

reCAPTCHA アクション トークンの属性

次の表に、Google Cloud Armor の reCAPTCHA アクション トークンの属性を示します。

属性名 データ型 説明
score float reCAPTCHA トークンからのスコア。有効なスコアの範囲は 0.0 ～ 1.0 です。 スコア 1.0 は、インタラクションのリスクが低く、正当である可能性が非常に高いことを示します。一方で 0.0 は、インタラクションのリスクが高く、不正行為の可能性があることを示します。詳細については、スコアの解釈をご覧ください。
captcha_status 文字列 reCAPTCHA アクション トークンからの CAPTCHA ステータス。次の 3 つのステータスが考えられます。
  • NONE: ユーザーを評価する際に課題が含まれていなかった。
  • PASS: 課題が含まれ、ユーザーが正しく解決した。
  • FAIL: 課題が含まれ、ユーザーが解決に失敗した。
action_name 文字列 action_name は、grecaptcha.enterprise.execute() の呼び出し時にユーザー インタラクションに指定したアクション パラメータです。詳細については、アクション名をご覧ください。
key 文字列 key は、このリクエストで作成、使用した reCAPTCHA キー（アクション トークン キー）です。詳細については、reCAPTCHA キーの概要をご覧ください。

reCAPTCHA セッション トークンの属性

次の表に、Google Cloud Armor の reCAPTCHA セッション トークンの属性を示します。

属性名 データ型 説明
Score float reCAPTCHA トークンからのスコア。有効なスコアの範囲は 0.0 ～ 1.0 です。 スコア 1.0 は、インタラクションのリスクが低く、正当である可能性が非常に高いことを示します。一方で 0.0 は、インタラクションのリスクが高く、不正行為の可能性があることを示します。詳細については、スコアの解釈をご覧ください。
key 文字列 key は、このリクエストで作成、使用した reCAPTCHA キー（セッション トークン キー）です。詳細については、reCAPTCHA キーの概要をご覧ください。

次のステップ