This article provides instructions on how to create a reCAPTCHA v2 key in the Google Cloud Console and then configure the key for use within Okta.

• CAPTCHA integration
• reCAPTCHA v2
• Okta Identity Engine

To generate the necessary keys, a reCAPTCHA v2 key must be created in the Google Cloud Console. For more details, refer to the Google Cloud Documentation.

1. In the Google Cloud Console, select or create a Google Cloud project to associate with the reCAPTCHA key.
2. Navigate to the APIs & Services section and select Library.
3. Search for the reCAPTCHA Enterprise API and enable it for the selected project.
    
4.  Go to the reCAPTCHA section, which is often found under Security or by searching for "reCAPTCHA".
5. Click on Create key.
     

6. In the Create key window, configure the required settings.

   1. Enter a descriptive Display name for the key.

   2. Select the Application type.

   3. Select Add a domain and enter the domain where reCAPTCHA v2 will be used (for example, the Okta default domain or a custom domain). Multiple domains can be added.

   4. Click Create key.
       
      

      NOTE: The reCAPTCHA site key is also referred to as the ID. For reCAPTCHA v2, a secret key is also required for server-side verification. To find the secret key, select Use Legacy Key within the Integration tab of the key's details.

          
      
      

To configure the reCAPTCHA v2 service in Okta:

1. In the Admin Console, go to Security > General.

2. In the CAPTCHA Integration section, configure the following settings:

   • Type: Select reCAPTCHA v2.

   • Site key: Paste the site key (ID) from the Google Cloud reCAPTCHA Admin console.

   • Secret key: Paste the secret key obtained via Use Legacy Key from the Google Cloud reCAPTCHA Admin console.

3. In the Enable CAPTCHA for section, select the types of authentication for which to use CAPTCHA.

4. Click Save.

Related References

• For more information on Okta's CAPTCHA integration settings, see the Okta CAPTCHA Integration Documentation.