This document lists the reCAPTCHA action-tokens attributes and reCAPTCHA
session-tokens attributes that you can use when configuring security policies
for Cloud Armor.

## reCAPTCHA action-tokens attributes

The following table lists the reCAPTCHA action-tokens attributes
for Cloud Armor:

| Attribute name | Data type | Description |
|---|---|---|
| `score` | float | The score from a reCAPTCHA token. A valid score ranges from 0.0 to 1.0. The score 1.0 indicates that the interaction poses low risk and is likely legitimate, whereas 0.0 indicates that the interaction poses high risk and might be fraudulent. For more information, see [Interpreting scores](https://docs.cloud.google.com/recaptcha/docs/interpret-assessment#interpret_scores). |
| `captcha_status` | string | The CAPTCHA status from a reCAPTCHA token. The following are the three possible statuses: - `NONE`: Challenges were not involved when assessing the user. - `PASS`: Challenges were involved, and the user solved them correctly. - `FAIL`: Challenges were involved, and the user failed to solve them. |
| `action` | string | `action` is the action parameter that you specified for a user interaction when calling `grecaptcha.enterprise.execute()`. For more information, see [Action names](https://docs.cloud.google.com/recaptcha/docs/actions-website.md.txt). > [!NOTE] > **Important:** Make sure to verify that the `action` attribute matches the `action` parameter that you specified when calling `grecaptcha.enterprise.execute()`. If there is a mismatch, it indicates that an attacker is attempting to falsify actions. |
| `key` | string | `key` is the reCAPTCHA key (action-token key) that you created and used in this request. For more information, see [reCAPTCHA keys overview](https://docs.cloud.google.com/recaptcha/docs/keys.md.txt). |

## reCAPTCHA session-tokens attributes

The following table lists the reCAPTCHA session-tokens attributes for
Cloud Armor:

| Attribute name | Data type | Description |
|---|---|---|
| `Score` | float | The score from a reCAPTCHA token. A valid score ranges from 0.0 to 1.0. The score 1.0 indicates that the interaction poses low risk and is likely legitimate, whereas 0.0 indicates that the interaction poses high risk and might be fraudulent. For more information, see [Interpreting scores](https://docs.cloud.google.com/recaptcha/docs/interpret-assessment#interpret_scores). |
| `key` | string | `key` is the reCAPTCHA key (session-token key) that you created and used in this request. For more information, see [reCAPTCHA keys overview](https://docs.cloud.google.com/recaptcha/docs/keys.md.txt). |

## What's next

- Learn about the [features of reCAPTCHA for Cloud Armor](https://docs.cloud.google.com/recaptcha/docs/features-ca.md.txt).
- [Integrate reCAPTCHA for
  Cloud Armor](https://docs.cloud.google.com/recaptcha/docs/implement-waf-ca).