Usar las funciones de reCAPTCHA después de la migración

En esta página se explica cómo modificar una integración de reCAPTCHA para usar funciones de reCAPTCHA, como la autenticación multifactor (MFA) y la protección de contraseñas, después de migrar desde reCAPTCHA clásico. Para modificar una integración de reCAPTCHA, debes instrumentar las páginas web y migrar las llamadas de backend.

Antes de empezar

Migra a reCAPTCHA.

Instrumentar las páginas web

Para instrumentar las páginas web con las secuencias de comandos y las llamadas de reCAPTCHA, sigue estos pasos:

  1. Compruebe que ha incluido la siguiente secuencia de comandos en sus páginas web: https://www.google.com/recaptcha/api.js.

  2. En tus páginas web, sustituye https://www.google.com/recaptcha/api.js por https://www.google.com/recaptcha/enterprise.js.

  3. Si invocas la API de forma programática, sustituye las siguientes llamadas:

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

Migrar las llamadas de backend

Para usar las funciones de reCAPTCHA, debes migrar las llamadas de backend a los nuevos endpoints y configurar la autenticación:

  1. Sustituye las llamadas al backend de https://www.google.com/recaptcha/api/siteverify por llamadas equivalentes a recaptchaenterprise.googleapis.com. Para consultar la URL completa y el formato de los datos POST, consulta Crear una evaluación para tu sitio web.

  2. Configura la autenticación en reCAPTCHA.

    El método de autenticación que elijas dependerá del entorno en el que se configure reCAPTCHA. La siguiente tabla te ayudará a elegir el método de autenticación adecuado y la interfaz compatible para configurar la autenticación:

    Entorno Interfaz Método de autenticación
    Google Cloud
    • REST
    • Bibliotecas de cliente
    		 Usa cuentas de servicio asociadas.
    On-premise u otro proveedor de servicios en la nube REST Usa claves de API o la federación de identidades de cargas de trabajo.

    Si quieres usar claves de API, te recomendamos que las protejas aplicando restricciones a las claves de API.
    Bibliotecas de cliente

    Utiliza lo siguiente:

Siguientes pasos