快速入门:使用 API 密钥在非 Google Cloud 环境中设置 reCAPTCHA Enterprise

本快速入门指导您在以下场景中使用 API 密钥进行身份验证时,在非 Google Cloud 环境中设置 reCAPTCHA Enterprise:

  • 您在除 Google Cloud、CRM 或 SaaS 环境中以外的环境中使用 reCAPTCHA Enterprise,不支持外部身份验证方法,例如服务帐号
  • 在您的环境中,您需要使用 v1beta1 端点来满足以下要求:

    • 您的环境需要预览版和抢先体验计划 (EAP) 功能,例如多重身份验证 (MFA) 或密码泄露检测。
    • 您的环境不需要基于角色的访问权限控制 (RBAC)。

准备工作

  1. 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  2. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能

    reCAPTCHA Enterprise 要求在项目上关联并启用结算功能才能访问 API。您可以使用信用卡或现有的 Google Cloud 项目结算 ID 来启用结算功能。如果您需要结算方面的帮助,请与 Cloud Billing 支持团队联系。

启用 reCAPTCHA Enterprise API

控制台

  1. 在 Cloud Console 中,转到 reCAPTCHA Enterprise API 页面。

    转到 reCAPTCHA Enterprise API

  2. 验证项目名称是否显示在页面顶部的项目选择器中。

    如果您没有看到项目名称,请点击项目选择器,然后选择您的项目。

  3. 点击启用

gcloud

  1. 如需在 gcloud 会话中设置 Google Cloud 项目,请运行 gcloud config set project 命令。将 PROJECT_ID 替换为您的 Google Cloud 项目 ID。
           gcloud config set project PROJECT_ID
           
  2. 如需启用 reCAPTCHA Enterprise API,请运行 gcloud services enable 命令:
             gcloud services enable recaptchaenterprise.googleapis.com
           
  3. 如需验证 reCAPTCHA Enterprise API 是否已启用,请运行 gcloud services list 命令:
             gcloud services list --enabled
           

    验证 reCAPTCHA Enterprise API 是否在已启用的 API 列表中列出。

创建 API 密钥

在 Google Cloud 项目中创建 API 密钥:

  1. 在 Cloud Console 中,转到凭据页面。

    转到“凭据”页面

  2. 点击 创建凭据,然后选择 API 密钥

  3. (可选)点击限制密钥以限制和重命名 API 密钥。

使用 API 密钥进行后端身份验证

使用您在创建评估时通过 v1beta1 端点创建的 API 密钥。

后续步骤

  1. 确定要使用的 reCAPTCHA(网站)密钥的类型创建 reCAPTCHA 密钥
  2. 在网页上安装基于得分的网站密钥或复选框网站密钥。

    将 reCAPTCHA Enterprise 与 Android 应用iOS 应用集成。

  3. 创建评估

  4. 解读评估,并根据得分对您的网站采取适当的措施。