Prepare your environment for reCAPTCHA Enterprise

This document shows you how to prepare your environment to set up reCAPTCHA Enterprise.

Before you begin

To get started with reCAPTCHA Enterprise, do the following:

  1. Sign up to create a Google account in the Google Cloud console.

  2. 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


  1. In the Google Cloud 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.


  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 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
  3. To enable the reCAPTCHA Enterprise API, run the gcloud services enable command:
             gcloud services enable
  4. 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.

Configure roles and permissions

To get the permissions that you need to set up reCAPTCHA Enterprise, ask your administrator to grant you the following IAM roles on the project:

For more information about granting roles, see Manage access.

You might also be able to get the required permissions through custom roles or other predefined roles.

For more information about the access control for reCAPTCHA Enterprise, see Access control with IAM.

What's next