En este documento, se describen las diferencias en la terminología y la administración de claves entre la Consola del administrador de reCAPTCHA heredada y la consola de Google Cloud . También se explica cómo recuperar las claves de sitio y las claves secretas de reCAPTCHA que requieren los complementos de terceros, como las integraciones de WordPress.
Asigna la terminología heredada a la consola de Google Cloud
Muchos complementos de sistemas de administración de contenido (CMS) hacen referencia a los tipos de reCAPTCHA con convenciones de nomenclatura heredadas, como v2 Checkbox, v2 Invisible y v3. La consola de Google Cloud utiliza descriptores basados en la plataforma, en lugar de números de versión.
En la siguiente tabla, se asigna la terminología heredada a la terminología de la consola de Google Cloud :
| Terminología de la Consola del administrador | Terminología de la consola deGoogle Cloud | Mecanismo de verificación |
|---|---|---|
| Basado en una puntuación (v3) | Sitio web • puntuación | Verificación sin complicaciones basada en una puntuación. |
| Desafío (v2) | Sitio web • casilla de verificación | Requiere que el usuario haga clic en un desafío de "No soy un robot". |
| N/A | Sitio web • Verificación basada en políticas | Desafío configurado según el umbral definido por el usuario. |
| N/A | iOS | Es una llave para dispositivos móviles iOS sin desafío. |
| N/A | Android | Es una llave móvil de Android sin desafío. |
| Invisible (v2) | Sitio web • Invisible con desafío de resguardo | Es posible que muestre desafíos de captcha después del análisis de riesgos. |
Verifica el tipo de clave en la consola de Google Cloud
Para verificar el tipo de una clave en la consola de Google Cloud , haz lo siguiente:
En la consola de Google Cloud , ve a la página Fraud Defense.
Selecciona la pestaña Keys.
Cambia de la vista Tarjetas a la vista Tabla.
Busca la columna Detalles de la plataforma para ver descriptores como
Website • score.
Como alternativa, en la vista predeterminada Tarjetas, haz clic en Detalles clave para una clave específica y, luego, selecciona Editar clave. El campo Tipo muestra la configuración.
Cómo encontrar la clave del sitio y la clave secreta
Los complementos de terceros suelen requerir una clave de sitio y una clave secreta para la integración de reCAPTCHA.
- Clave del sitio: En la consola de Google Cloud , el ID de clave corresponde a la clave del sitio.
- Clave secreta: La consola de Google Cloud no muestra la clave secreta de forma predeterminada porque 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. Es posible que algunas bibliotecas o documentación de terceros se refieran a la clave secreta heredada como una clave privada.
Recupera la clave secreta en la consola de Google Cloud
Para recuperar la clave secreta, haz lo siguiente:
En la consola de Google Cloud , ve a la página Fraud Defense.
Selecciona la pestaña Keys.
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 llave en la tarjeta de la llave. 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 muestra en la tabla. Haz clic en la clave para ir a su página de detalles.
El ID de clave que se muestra en la parte superior de la página es tu clave del sitio.
Ve a la pestaña Integración.
Según el estado de la llave, haz lo siguiente:
- Si la clave está configurada para uso heredado, haz clic en Usar clave heredada.
- Si la clave no está integrada en un servicio heredado, haz clic en Integrar con un servicio o complemento de terceros.
Aparecerá un diálogo con tu clave secreta. Copia este valor de forma segura. Trata este secreto como datos sensibles.
Integración con evaluaciones
El método CreateAssessment proporciona un análisis de riesgo detallado y códigos de motivos, y permite el acceso 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 Cómo crear una evaluación para tu sitio web.
Método SiteVerify heredado
Si bien recomendamos el método CreateAssessment para las 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 a tu clave de reCAPTCHA.
Si necesitas realizar la integración con un sistema que requiere la API de SiteVerify heredada, consulta Cómo verificar los tokens de respuesta del usuario con SiteVerify heredado.