Concilia la terminología de la Consola del administrador y la consola de Google Cloud

En este documento, se describe cómo identificar la versión de tu clave de reCAPTCHA (v2 o v3), asignar la terminología heredada de la consola del administrador de reCAPTCHA a la consola deGoogle Cloud y recuperar las claves de sitio y las claves secretas que requieren las plataformas de sistemas de administración de contenido (CMS) y los complementos de terceros, como las integraciones de WordPress o Shopify.

Asigna la terminología heredada a la consola de Google Cloud

Si administras tus claves solo en la consola del administrador de reCAPTCHA, estás usando reCAPTCHA clásico. Si administras tus claves en la página Google Cloud Fraud Defense de la consola de Google Cloud , estás usando Fraud Defense. Ambas consolas admiten claves de sitio web v2 y v3.

Muchas plataformas y complementos de CMS hacen referencia a las claves de reCAPTCHA con números de versión heredados, como v2 Checkbox, v2 Invisible y v3. La consola deGoogle Cloud usa descriptores basados en la plataforma en lugar de números de versión.

En la siguiente tabla, se asigna la terminología heredada de CMS y de la Consola del administrador a la terminología de la consola deGoogle Cloud :

Terminología del CMS o de la Consola del administrador Google Cloud console (Platform details) Editar clave (campo Tipo) Mecanismo de verificación y compatibilidad con CMS
Basado en una puntuación (v3) Website • score Website • Score Verificación sin fricciones basada en puntuaciones Se usa para los complementos de CMS que requieren reCAPTCHA v3.
Desafío (v2) Website • checkbox Website • Checkbox challenge Requiere que el usuario seleccione la casilla de verificación "No soy un robot". Se usa para los complementos de CMS que requieren la casilla de verificación de reCAPTCHA v2.
Invisible (v2) Website • invisible Website • Invisible integration Analiza el riesgo en segundo plano y puede mostrar un desafío. Se usa para complementos de CMS que requieren reCAPTCHA v2 invisible.
N/A Website • policy-based challenge Website • Policy-based challenge Activa desafíos según un umbral de puntuación configurado. Requiere una integración personalizada de CreateAssessment.
N/A iOS iOS app Clave móvil de iOS sin desafío.
N/A Android Android app Llave móvil de Android sin desafío.

Visualiza la versión de tu clave en la consola de Google Cloud

Para ver la versión de tu clave en la consola de Google Cloud , haz lo siguiente:

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

    Ir a Fraud Defense

  2. Selecciona la pestaña Keys.

  3. Si tus claves están en la vista de Tarjetas, cambia a la vista de Tabla.

  4. Consulta la columna Detalles de la plataforma para obtener tu clave. Por ejemplo, Website • score corresponde a v3, y Website • checkbox corresponde a v2 Checkbox.

  5. Es opcional. En la vista de Tarjetas, haz clic en Detalles de la clave en una tarjeta de clave y, luego, selecciona Editar clave. En el campo Tipo, se muestra la configuración de la clave, como Website • Score para v3 o Website • Checkbox challenge para v2 Checkbox.

Busca la clave de sitio y la clave secreta

Los complementos de terceros y las plataformas de CMS suelen requerir una clave de sitio y una clave secreta para la integración de reCAPTCHA:

  • Clave de sitio: En la consola de Google Cloud , el ID de clave corresponde a la clave de sitio.
  • Clave secreta: La consola de Google Cloud no muestra la clave secreta de forma predeterminada, ya que la autenticación de Google Cloud suele usar claves de API o roles de Identity and Access Management. Sin embargo, puedes recuperar la clave secreta heredada para los complementos que la requieran. Algunas bibliotecas o documentación de terceros pueden referirse a la clave secreta heredada como una clave privada.

Recupera la clave secreta en la consola de Google Cloud

Para recuperar la clave de sitio y la clave secreta, haz lo siguiente:

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

    Ir a Fraud Defense

  2. Selecciona la pestaña Keys.

  3. En la sección Claves de reCAPTCHA, ve a la clave para la que necesitas la clave secreta:

    • Si estás en la vista Tarjetas, haz clic en Detalles de la clave en la tarjeta de la clave. El ID de clave se muestra en la parte superior de la página.
    • Si estás en la vista Tabla, el ID de clave se puede ver en la tabla. Haz clic en la clave para ir a su página de detalles.

  4. Copia el ID de clave que se muestra en la parte superior de la página. Este valor es tu clave de sitio.

  5. Ve a la pestaña Integración.

  6. Según el estado de la clave, realiza una de las siguientes acciones:

    • Si la clave está configurada para el uso heredado, haz clic en Usar clave heredada.
    • Si la clave no está integrada en un servicio heredado, haz clic en Realizar la integración con un servicio o complemento de terceros.

  7. Aparecerá un diálogo con tu clave secreta. Copia este valor de forma segura. Trata este secreto como datos sensibles.

    Como alternativa, en la página Detalles de la clave, haz clic en Editar clave y, luego, en Revelar junto al campo Clave secreta.

Integración con WordPress, Shopify o con otras plataformas de CMS

Si usas un creador de sitios web, una plataforma de comercio electrónico o un complemento de CMS, la plataforma o el complemento cargan la secuencia de comandos de reCAPTCHA y verifican los tokens de usuario automáticamente. No necesitas instalar bibliotecas cliente de reCAPTCHA ni escribir código de backend personalizado.

Para configurar reCAPTCHA en un CMS o un complemento de terceros, haz lo siguiente:

  1. Verifica la versión de reCAPTCHA que requiere tu CMS o complemento: Abre la configuración de integración de reCAPTCHA en tu CMS o complemento, y verifica qué tipo de clave admite (por lo general, reCAPTCHA v3 o casilla de verificación de reCAPTCHA v2).

  2. Selecciona o crea una clave de coincidencia:

    • Si ya tienes una clave, consulta su versión para confirmar que coincida con la versión seleccionada en tu complemento (Website • score para v3 o Website • checkbox para v2 Checkbox).
    • Si necesitas una clave nueva, crea una para tu sitio web que coincida con la versión requerida y agrega el dominio de tu sitio web (por ejemplo, example.com) a la lista de dominios de la clave.

  3. Copia la clave de sitio y la clave secreta heredada: Sigue los pasos que se indican en Recupera la clave secreta en la consola deGoogle Cloud para obtener el ID de clave (clave de sitio) y la clave secreta.

  4. Ingresa las claves en la configuración de tu CMS o complemento:

    • Pega el ID de clave en el campo Clave de sitio.
    • Pega la clave secreta en el campo Clave secreta (o Clave privada) y, luego, guarda la configuración.

Integra sitios web personalizados con evaluaciones

El método CreateAssessment proporciona un análisis de riesgos detallado y códigos de motivo, y permite acceder a las funciones avanzadas de Fraud Defense. Puedes llamar al método CreateAssessment con las bibliotecas cliente de reCAPTCHA o la API de REST.

Para obtener más información, consulta Crea una evaluación para tu sitio web.

Método SiteVerify heredado

Aunque recomendamos el método CreateAssessment para integraciones nuevas y personalizadas, algunos sistemas existentes o complementos de terceros aún dependen del método heredado SiteVerify. Este método requiere una clave secreta asociada con tu clave de reCAPTCHA.

Si necesitas integrarte con un sistema que requiere la API de SiteVerify heredada, consulta Verifica los tokens de respuesta del usuario con SiteVerify heredado.

¿Qué sigue?