--- title: CAPTCHA node description: Adds CAPTCHA support. component: auth-node-ref version: 7.4 page_id: auth-node-ref::captcha canonical_url: https://docs.pingidentity.com/auth-node-ref/latest/captcha.html llms_txt: https://docs.pingidentity.com/auth-node-ref/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md keywords: ["Nodes & Trees", "Journeys", "Authentication", "CAPTCHA"] page_aliases: ["auth-node-captcha.adoc"] superseded_by: https://docs.pingidentity.com/auth-node-ref/latest/captcha.html section_ids: compatibility: Compatibility outcomes: Outcomes properties: Properties example: Example --- # CAPTCHA node Adds CAPTCHA support. This node verifies the response token received from the CAPTCHA provider and creates a CAPTCHA callback for the UI to interact with. By default, the node is configured for Google's reCAPTCHA v2. ## Compatibility | Product | Compatible? | | ------------------------------------------ | --------------------- | | PingOne Advanced Identity Cloud | [icon: check, set=fa] | | ForgeRock Access Management (self-managed) | [icon: check, set=fa] | | Ping Identity Platform (self-managed) | [icon: check, set=fa] | ## Outcomes * `True` *(success)* * `False` *(failure)* ## Properties | Property | Usage | | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | CAPTCHA Site Key *(required)* | The CAPTCHA site key supplied by the CAPTCHA provider when you sign up for access to the API. | | CAPTCHA Secret Key *(required)* | The CAPTCHA secret key supplied by the CAPTCHA provider when you sign up for access to the API. | | CAPTCHA Verification URL *(required)* | The URL used to verify the CAPTCHA submission.Possible values are:- Google: `https://www.google.com/recaptcha/api/siteverify` - hCaptcha: `https://hcaptcha.com/siteverify` | | CAPTCHA API URL *(required)* | The URL of the JavaScript that loads the CAPTCHA widget.Possible values are:- Google: `https://www.google.com/recaptcha/api.js` - hCaptcha: `https://hcaptcha.com/1/api.js` | | Class of CAPTCHA HTML Element | The class of the HTML element required by the CAPTCHA widget.Possible values are:- Google: `g-recaptcha` - hCaptcha: `h-captcha` | | ReCaptcha V3 node | If you're using Google reCAPTCHA, specify whether it's v2 or v3. Turn on for v3. | | Score Threshold | If you're using Google reCAPTCHA v3, or hCaptcha, enter a score threshold.The CAPTCHA provider returns a score for each user request, based on observed interaction with your site. CAPTCHA "learns" by observing real site traffic, so scores in a staging environment or in a production deployment that has just been implemented might not be very accurate.A score of 1.0 is likely a good user interaction, while 0.0 is likely to be a bot.The threshold you set here determines whether to allow or deny access, based on the score returned by the CAPTCHA provider.Start with a threshold of 0.5.For more information about score thresholds, refer to the [Google documentation](https://developers.google.com/recaptcha/docs/v3#interpreting_the_score). | ## Example ![The CAPTCHA node in context](_images/trees-node-captcha-example-platform.png)