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.
Enable the reCAPTCHA Enterprise API
In the Google Cloud console, go to the reCAPTCHA Enterprise API page.
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.
- Click Enable.
- To set your Google Cloud project in the gcloud session, run the
gcloud config set projectcommand. Replace PROJECT_ID with your Google Cloud project ID.
gcloud config set project PROJECT_ID
- To enable the reCAPTCHA Enterprise API, run the
gcloud services enablecommand:
gcloud services enable recaptchaenterprise.googleapis.com
- To verify that the reCAPTCHA Enterprise API is enabled, run the
gcloud services listcommand:
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:
In the Google Cloud console, go to the Credentials page.
ClickCreate credentials, and then select API key.
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.
- Decide what type of reCAPTCHA (site) key to use and create a reCAPTCHA key.
Install score-based or checkbox site keys on web pages.
Integrate reCAPTCHA Enterprise with Android apps or iOS apps.
Interpret an assessment and take an appropriate action for your site based on the score.