Set up reCAPTCHA Enterprise on non-Google Cloud environments by using API keys

This quickstart guides you how to set up reCAPTCHA Enterprise on a cloud other than Google Cloud, on-premises, CRM, or SaaS environment that does not support external authentication methods such as service accounts. In this setup, you use API keys for authentication.

Before you begin

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the reCAPTCHA Enterprise API

Console

  1. In the console, go to the reCAPTCHA Enterprise API page.

    Go to reCAPTCHA Enterprise API

  2. Verify that the name of your project appears in the project selector at the top of the page.

    If you don't see the name of your project, click the project selector, then select your project.

  3. Click Enable.

gcloud

  1. To set your Google Cloud project in the gcloud session, run the gcloud config set project command. Replace PROJECT_ID with your Google Cloud project ID.
           gcloud config set project PROJECT_ID
           
  2. To enable the reCAPTCHA Enterprise API, run the gcloud services enable command:
             gcloud services enable recaptchaenterprise.googleapis.com
           
  3. To verify that the reCAPTCHA Enterprise API is enabled, run the gcloud services list command:
             gcloud services list --enabled
           

    Verify that the reCAPTCHA Enterprise API is listed in the list of enabled APIs.

Create an API key

Create an API key in your Google Cloud project:

  1. In the console, go to the Credentials page.

    Go to Credentials

  2. Click Create credentials, and then select API key.

  3. Optionally, click Restrict key to restrict and rename the API key.

Use the API Key for backend authentication

Use the API Key that you created with the v1 endpoint when creating an assessment.

What's next

  1. Decide what type of reCAPTCHA (site) key to use and create a reCAPTCHA key.
  2. Install score-based or checkbox site keys on web pages.

    OR

    Integrate reCAPTCHA Enterprise with Android apps or iOS apps.

  3. Create an assessment.

  4. Interpret an assessment and take an appropriate action for your site based on the score.