Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Crea claves de reCAPTCHA para sitios web

Puedes crear claves de reCAPTCHA para verificar las interacciones de los usuarios en tus páginas web.

Las claves de reCAPTCHA representan cómo se configura reCAPTCHA para un sitio web. La configuración incluye opciones importantes, como mostrar o no desafíos de CAPTCHA.

Antes de comenzar

Prepara tu entorno para Google Cloud Fraud Defense.
Asegúrate de tener el siguiente rol de Identity and Access Management: Administrador de reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).
Elige el tipo de clave que mejor se adapte a tu caso de uso.

Crea una clave de reCAPTCHA

No hay límite en la cantidad de claves de reCAPTCHA que puedes crear para un proyecto de Google Cloud . Lo mejor es crear una clave de reCAPTCHA por sitio web.

Te recomendamos que crees claves de reCAPTCHA independientes para los entornos de etapa de pruebas y de producción. De lo contrario, corres el riesgo de contaminar el análisis de riesgos de reCAPTCHA con datos de tu entorno de pruebas.

Consola de Cloud

En la consola de Google Cloud , ve a la página Google Cloud Fraud Defense.

Ir a Google Cloud Fraud Defense
Verifica que el nombre de tu proyecto aparezca en el selector de recursos en la parte superior de la página.

Si no ves el nombre de tu proyecto, haz clic en el selector de recursos y, luego, selecciona tu proyecto.
Selecciona la pestaña Keys.
Haz clic en Crear clave.
En el campo Nombre visible, ingresa un nombre visible para la clave.
En Tipo de aplicación, selecciona Web.
Aparecerá la sección Lista de dominios.
Para proteger la clave de reCAPTCHA de tu dominio y subdominios, asegúrate de que el botón de activación Inhabilitar la verificación de dominio esté desactivado.
Inhabilitar la verificación del dominio es un riesgo de seguridad, ya que no hay restricciones en el sitio, por lo que cualquier persona puede acceder a tu clave de reCAPTCHA y usarla.
Ingresa el nombre de dominio de tu sitio web:
1. En la sección Lista de dominios, haz clic en Agregar un dominio.
2. En el campo Dominio, ingresa el nombre de tu dominio.
3. Opcional: Para agregar un dominio adicional, haz clic en Agregar un dominio y, luego, ingresa el nombre de otro dominio en el campo Dominio. Puedes agregar hasta un máximo de 250 dominios.
  
  En el caso de los sitios web, la clave de reCAPTCHA es única para los dominios y subdominios que especifiques. Puedes especificar más de un dominio si publicas tu sitio web desde varios dominios. Si especificas un dominio (por ejemplo, examplepetstore.com), no es necesario que especifiques sus subdominios (por ejemplo, subdomain.examplepetstore.com). Los cambios en la lista de dominios pueden tardar hasta 30 minutos en aplicarse.
  
  Para usar una clave en más de 250 dominios, haz clic en el botón de activación Inhabilitar la verificación del dominio. Luego, Google Cloud Fraud Defense ignorará la lista de dominios. Debes realizar la verificación del dominio por tu cuenta examinando el campo tokenProperties.hostname en las evaluaciones que crees.
Según el tipo de clave de reCAPTCHA que quieras crear para tu sitio web, realiza la acción correspondiente:

Crea claves de reCAPTCHA basadas en puntuación

Si quieres permitir que la clave basada en puntuación funcione con Accelerated Mobile Pages (AMP) con el componente amp-recaptcha-input, activa el botón de activación Permitir que esta clave funcione con páginas de AMP.
En el caso de tu entorno que no es de producción, si quieres especificar una puntuación que deseas que devuelva la clave cuando se creen evaluaciones para ella, haz lo siguiente:
1. Haz clic en Paso siguiente (opcional).
2. En el paso Configuración adicional, haz clic en el botón de activación ¿Estás creando esta clave solo con fines de prueba?
3. Usa el control deslizante Establecer puntuación para especificar una puntuación entre 0 y 1.0.
Haz clic en Crear clave.

La clave recién creada aparece en la página Claves de reCAPTCHA.

Crea claves de reCAPTCHA de casilla de verificación

Haz clic en Paso siguiente (opcional).
En el paso Configuración adicional, activa la opción ¿Usarás desafíos? activar o desactivar.
Selecciona la opción de Seguridad del desafío adecuada.
La opción de seguridad del desafío controla la probabilidad de que se solicite a un usuario un desafío secundario en el que se le solicita que seleccione imágenes según una categoría identificada (por ejemplo, seleccione las imágenes con una motocicleta o escaleras).

Si quieres garantizar la mejor protección antifraude, selecciona Estricto.

Si seleccionas Fácil, es menos probable que se les solicite a los usuarios que completen el desafío visual.
En el caso de tu entorno que no es de producción, si quieres especificar una puntuación que deseas que devuelva la clave cuando se creen evaluaciones para ella, haz lo siguiente:
1. Haz clic en el botón de activar o desactivar ¿Estás creando esta clave solo con fines de prueba?.
2. Usa el control deslizante Establecer puntuación para especificar una puntuación entre 0 y 1.0.
3. Selecciona la opción Tipo de desafío adecuada.
  - En el modo Automático, a veces aparece el desafío.
  - Sin CAPTCHA no muestra un desafío.
  - Desafío que no se puede resolver muestra las imágenes, pero no se supera el desafío.
4. Haz clic en Crear clave.
La clave recién creada aparece en la página Claves de reCAPTCHA.

Crea claves de reCAPTCHA de desafío basadas en políticas

Haz clic en Paso siguiente (opcional).
En el paso Configuración adicional, activa la opción ¿Usarás desafíos? activar o desactivar.
Selecciona la opción de Seguridad del desafío adecuada.
La opción de seguridad del desafío define la complejidad y la frecuencia de los desafíos de CAPTCHA que se muestran al usuario.

Si quieres garantizar la mejor protección antifraude, selecciona Estricto.

Si seleccionas Fácil, es menos probable que se les solicite a los usuarios que completen desafíos de CAPTCHA, y estos serán menos complejos.
En el caso de tu entorno que no es de producción, si quieres especificar una puntuación para que la clave la devuelva cuando se creen evaluaciones para ella, haz lo siguiente:
1. Haz clic en el botón de activar o desactivar ¿Estás creando esta clave solo con fines de prueba?.
2. Usa el control deslizante Establecer puntuación para especificar una puntuación entre 0 y 1.0.
Selecciona el umbral de puntuación para activar los desafíos de CAPTCHA, que se aplica a todas las acciones.
Haz clic en Crear clave.

La clave recién creada aparece en la página Claves de reCAPTCHA.

Consola del administrador

Ve a la consola del administrador de Google Cloud Fraud Defense.

Ir a la consola del administrador de Fraud Defense
En el campo Etiqueta, ingresa un nombre que puedas usar para identificar tu sitio.
Si quieres crear una clave basada en puntuaciones, selecciona Basado en una puntuación (v3). Si quieres crear una clave de casilla de verificación, selecciona Desafío (v2).
Para agregar un dominio, ingresa tu nombre de dominio y haz clic en .
Para agregar un dominio adicional, puedes repetir este paso. Puedes agregar hasta un máximo de 250 dominios.
Si es la primera vez que usas la consola de Google Cloud , lee las Condiciones del Servicio y selecciona la casilla de verificación.
Haz clic en Enviar.

Si es la primera vez que usas la consola de Google Cloud , se creará un proyecto de Google Cloud y se habilitarán las APIs necesarias para que puedas comenzar. Si ya tienes un proyecto de Google Cloud , las APIs necesarias están habilitadas para que comiences a usarlo.

gcloud

Para crear claves de reCAPTCHA, usa el comando gcloud recaptcha keys create.

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

INTEGRATION_TYPE: Tipo de integración. Según el tipo de claves, especifica los siguientes valores:
- score para las claves basadas en puntuaciones.
- checkbox para las claves de casillas de verificación
- policy-based-challenge para las claves de verificación basadas en políticas.
Nota: No recomendamos usar CHECKBOX porque aumenta la fricción del usuario y no mejora significativamente la exactitud. Para obtener más información, consulta las Preguntas frecuentes.
DISPLAY_NAME: Es el nombre de la clave. Por lo general, es el nombre de un sitio.
DOMAIN_NAME: Son los dominios o subdominios de sitios web que pueden usar la clave.
Especifica varios dominios como una lista separada por comas.
Para usar una clave en más de 250 dominios, especifica --allow-all-domains para inhabilitar la verificación del dominio. Luego, Google Cloud Fraud Defense ignorará la lista de dominios. Debes realizar la verificación del dominio por tu cuenta examinando el campo tokenProperties.hostname en las evaluaciones que crees.

Inhabilitar la verificación del dominio es un riesgo de seguridad, ya que no hay restricciones en el sitio, por lo que cualquier persona puede acceder a tu clave de reCAPTCHA y usarla.

Nota: La clave de reCAPTCHA es única para los dominios y subdominios que especifiques. Puedes especificar más de un dominio si publicas tu sitio web desde varios dominios. Si especificas un dominio (por ejemplo, examplepetstore.com), no es necesario que especifiques sus subdominios (por ejemplo, subdomain.examplepetstore.com). Los cambios en la lista de dominios pueden tardar hasta 30 minutos en aplicarse.
DEFAULT_SCORE_THRESHOLD: En el caso de las claves de desafío basadas en políticas, define el umbral de desafío universal para la clave cuando no se define un umbral de puntuación personalizado.
ACTION_SCORE_THRESHOLDS: En el caso de las claves de desafío basadas en políticas, se especifica la acción y la puntuación de umbral correspondiente entre 0.0 y 1.0. Por ejemplo, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'
Nota: En las evaluaciones, solo se devuelven las puntuaciones finales que se calculan después de cualquier desafío. La puntuación inicial que calcula Fraud Defense se compara con el umbral.

Ejecuta el comando gcloud recaptcha keys create:

Linux, macOS o Cloud Shell

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME \

Windows (PowerShell)

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME `

Windows (cmd.exe)

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME ^

La respuesta contiene la clave de reCAPTCHA recién creada.

REST

Para obtener información de referencia de la API sobre los tipos de claves y de integración, consulta Clave y Tipo de integración.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

INTEGRATION_TYPE: Tipo de integración. Según el tipo de claves, especifica los siguientes valores:
- SCORE para las claves basadas en puntuaciones.
- CHECKBOX para las claves de casillas de verificación
- POLICY_BASED_CHALLENGE para las claves de verificación basadas en políticas.
Nota: No recomendamos usar CHECKBOX porque aumenta la fricción del usuario y no mejora significativamente la exactitud. Para obtener más información, consulta las Preguntas frecuentes.
DISPLAY_NAME: Es el nombre de la clave. Por lo general, es el nombre de un sitio.
DOMAIN_NAME: Son los dominios o subdominios de sitios web que pueden usar la clave.
Especifica varios dominios como una lista separada por comas.
Para usar una clave en más de 250 dominios, especifica --allow-all-domains para inhabilitar la verificación del dominio. Luego, Google Cloud Fraud Defense ignorará la lista de dominios. Debes realizar la verificación del dominio por tu cuenta examinando el campo tokenProperties.hostname en las evaluaciones que crees.

Inhabilitar la verificación del dominio es un riesgo de seguridad, ya que no hay restricciones en el sitio, por lo que cualquier persona puede acceder a tu clave de reCAPTCHA y usarla.

Nota: La clave de reCAPTCHA es única para los dominios y subdominios que especifiques. Puedes especificar más de un dominio si publicas tu sitio web desde varios dominios. Si especificas un dominio (por ejemplo, examplepetstore.com), no es necesario que especifiques sus subdominios (por ejemplo, subdomain.examplepetstore.com). Los cambios en la lista de dominios pueden tardar hasta 30 minutos en aplicarse.
DEFAULT_SCORE_THRESHOLD: En el caso de las claves de desafío basadas en políticas, define el umbral de desafío universal para la clave cuando no se define un umbral de puntuación personalizado.
ACTION_SCORE_THRESHOLDS: En el caso de las claves de desafío basadas en políticas, se especifica la acción y la puntuación de umbral correspondiente entre 0.0 y 1.0. Por ejemplo, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'
Nota: En las evaluaciones, solo se devuelven las puntuaciones finales que se calculan después de cualquier desafío. La puntuación inicial que calcula Fraud Defense se compara con el umbral.
DEFAULT_SCORE_THRESHOLD: En el caso de las claves de desafío basadas en políticas, define el umbral de desafío universal para la clave cuando no se define un umbral de puntuación personalizado. Esta función se encuentra en versión preliminar.
ACTION_SCORE_THRESHOLDS: En el caso de las claves de desafío basadas en políticas, se especifica la acción y la puntuación de umbral correspondiente entre 0.0 y 1.0. Por ejemplo, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}' Esta función se encuentra en versión preliminar.
Nota: En las evaluaciones, solo se devuelven las puntuaciones finales que se calculan después de cualquier desafío. La puntuación inicial que calcula reCAPTCHA se compara con el umbral.

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": "DOMAINS",
    "integrationType": "INTEGRATION_TYPE"
  }
}

Para enviar tu solicitud, elige una de estas opciones:

curl

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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 print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"

PowerShell

Nota: En el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

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

$cred = gcloud auth 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": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

Busca una clave secreta de reCAPTCHA heredada (opcional)

Si deseas realizar la integración en una aplicación de terceros o un complemento del sistema de administración de contenido (CMS) (como WordPress o Shopify) que no use la API de reCAPTCHA Enterprise, necesitas una clave que coincida con la versión que admite el complemento (v2 o v3) y la clave secreta heredada de la clave. Para obtener más información sobre cómo verificar la versión de la clave y configurar los complementos de CMS, consulta Concilia la terminología de la Consola del administrador y de la consola de Google Cloud .

Para cada clave de sitio que creas, reCAPTCHA genera una clave secreta de reCAPTCHA heredada (clave secreta heredada), que puedes usar con tu aplicación de terceros.

Si necesitas la clave secreta para una clave de reCAPTCHA clásica, migra la clave a reCAPTCHA en Google Cloud y busca la clave secreta heredada.

Para encontrar la clave secreta heredada, haz lo siguiente:

En la consola de Google Cloud , ve a la página Fraud Defense.

Ir a Fraud Defense
Selecciona la pestaña Keys.
En la sección Claves de reCAPTCHA, busca la clave de reCAPTCHA que creaste y haz clic en ella.
En la página Detalles de la clave, ve a la pestaña Integración y, luego, haz clic en Usar clave heredada o Realizar la integración con un servicio o complemento de terceros. Se abrirá un diálogo con tu clave secreta heredada.

Crea claves de reCAPTCHA para sitios web Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Crea una clave de reCAPTCHA

Consola de Cloud

Crea claves de reCAPTCHA basadas en puntuación

Crea claves de reCAPTCHA de casilla de verificación

Crea claves de reCAPTCHA de desafío basadas en políticas

Consola del administrador

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl

PowerShell

Busca una clave secreta de reCAPTCHA heredada (opcional)

¿Qué sigue?

Crea claves de reCAPTCHA para sitios web