Esta página se ha traducido con Cloud Translation API.
Switch to English

Crea una clave

En esta página se explica cómo crear una clave de reCAPTCHA.

Las claves, también conocidas como claves de sitios, representan una configuración de un sitio o una app. La configuración incluye opciones importantes, como si se muestran o no los desafíos de CAPTCHA.

Las claves reCAPTCHA no deben confundirse con claves de API, que se usan para la autenticación en lugar de la configuración. reCAPTCHA Enterprise no admite claves de API para la autenticación y, en su lugar, usa cuentas de servicio para autenticar las solicitudes realizadas por las aplicaciones.

Antes de comenzar

Configura tu proyecto de GCP y autenticación

Crea una clave

La forma más sencilla de crear una clave es a través de Cloud Console. Como alternativa, puedes usar la API de clave o el SDK de gcloud como se muestra a continuación.

LÍNEA DE CMD Y REST

Antes de usar cualquiera de los datos de solicitud siguientes, realiza los siguientes reemplazos:

  • project-id: Es el ID del proyecto de GCP.
  • display-name: nombre visible para la clave
  • domain: dominios o subdominios de sitios web autorizados para usar la clave

Método HTTP y URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/project-id/keys

Cuerpo JSON de la solicitud:

{
  "displayName": "display-name",
  "webSettings": {
    "allowedDomains": "domain",
    "integrationType": "SCORE"
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://recaptchaenterprise.googleapis.com/v1/projects/project-id/keys

PowerShell

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/project-id/keys" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "display-name",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      domain
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

gcloud

Ejecuta el comando gcloud alpha recaptcha keys create, como se muestra en el siguiente ejemplo:

gcloud alpha recaptcha keys create \
  --web \
  --display-name="My Key" \
  --integration-type=score \
  --domains=example.com \

¿Qué sigue?