Soluciona problemas de la integración de Identity Platform con la API de reCAPTCHA Enterprise

En este documento, se proporciona orientación para solucionar posibles problemas que podrían surgir cuando se usa la integración de Identity Platform con la API de reCAPTCHA Enterprise, incluidas las funciones de protección contra bots de reCAPTCHA y reCAPTCHA SMS defense.

Solución de problemas de integración

Es posible que tus usuarios tengan problemas debido a errores cuando se incorporan con la integración de Identity Platform en la API de reCAPTCHA Enterprise. Estos son algunos de los motivos comunes:

  • Es posible que hayas omitido un paso en la integración de Identity Platform con la configuración de la API de reCAPTCHA Enterprise. Por ejemplo, no configurar la cuenta de servicio o no habilitar la API de reCAPTCHA Enterprise en el proyecto. Asegúrate de haber completado todos los requisitos de integración. Para obtener instrucciones de configuración, consulta Integra Identity Platform en la API de reCAPTCHA Enterprise.
  • Si traes tu propia clave para usarla con reCAPTCHA, es posible que la clave de reCAPTCHA correspondiente que subiste no sea válida o haya dejado de funcionar. Verifica que la clave funcione y que Identity Platform pueda acceder a ella.
  • Es posible que los usuarios usen una versión desactualizada de tu app. Asegúrate de proporcionar una versión actualizada de tu app que use el SDK de cliente y pídeles a los usuarios que actualicen la app. Para configurar el SDK de cliente de tu app, consulta Configura el SDK de cliente.

Los usuarios no pueden autenticarse a través de los flujos compatibles con la API de reCAPTCHA Enterprise

Si tienes problemas con los flujos compatibles con la API de reCAPTCHA Enterprise, como la protección contra bots de reCAPTCHA o la defensa contra SMS de reCAPTCHA, consulta las siguientes secciones para obtener orientación específica sobre las funciones.

Solución de problemas de la protección de reCAPTCHA contra bots

En los siguientes temas, se describen los posibles problemas que puedes tener cuando usas la protección contra bots y cómo puedes resolverlos.

Los usuarios no pueden autenticarse cuando usan la protección contra bots para los proveedores de correo electrónico y contraseña o de teléfono

Si determinaste que la integración de Identity Platform con la API de reCAPTCHA Enterprise se configuró correctamente, es posible que se impida que los usuarios realicen acciones de autenticación a través de los proveedores de correo electrónico y contraseña o de teléfono según tu configuración actual. Por ejemplo, es posible que los usuarios no puedan realizar las siguientes acciones:

  • Accede, regístrate o restablece una contraseña con una dirección de correo electrónico.
  • Solicita un código por SMS para acceder con un número de teléfono.
  • Inscribirse o acceder con la autenticación de varios factores basada en SMS

Para resolver estos problemas de autenticación, prueba lo siguiente:

  • Si las solicitudes de los usuarios fallan con ERROR_CAPTCHA_CHECK_FAILED, considera una configuración más permisiva ajustando los umbrales que estableciste para managedRules. Cualquier solicitud que obtenga una puntuación inferior al umbral que establezcas se considerará un bot. Por ejemplo, si estableces un umbral de 0.6, reCAPTCHA rechazará cualquier solicitud con un valor de 0.5 o inferior. Por lo tanto, cuanto más alta sea la puntuación que establezcas, más estrictas serán las reglas.
  • Pídele al usuario que pruebe con otro dispositivo, navegador o red.
  • En el caso de los flujos de autenticación con correo electrónico y contraseña, revierte emailPasswordEnforcementState al modo AUDIT y supervisa las métricas antes de volver a habilitar el modo ENFORCE.
  • En los flujos de autenticación de teléfonos, ajusta los umbrales de puntuación de managedRules o inhabilita la protección contra bots para el proveedor de telefonía mientras solucionas problemas. Si la función reCAPTCHA SMS defense también está habilitada y quieres mantenerla activa, establece useSmsBotScore en false y deja phoneEnforcementState establecido en ENFORCE. Para inhabilitar toda la protección de reCAPTCHA para teléfonos, establece phoneEnforcementState en OFF, useSmsBotScore en false y useSmsTollFraudProtection en false.

Solución de problemas de reCAPTCHA SMS defense

En los siguientes temas, se describen los posibles problemas que podrías tener cuando uses reCAPTCHA SMS defense y cómo resolverlos.

Los usuarios no pueden autenticarse cuando usan reCAPTCHA SMS defense para el proveedor de telefonía

Si determinaste que la integración de Identity Platform con la API de reCAPTCHA Enterprise se configuró correctamente, es posible que se impida que los usuarios realicen acciones de autenticación basadas en SMS a través del proveedor de telefonía según tu configuración actual. Por ejemplo, es posible que los usuarios no puedan solicitar un código SMS para acceder con un número de teléfono o inscribirse o acceder con la autenticación de varios factores. Esto puede ocurrir si la puntuación de reCAPTCHA SMS defense que estableciste es demasiado estricta.

Para resolver este problema, considera una configuración más permisiva ajustando el umbral que estableciste para tollFraudManagedRules. Cualquier puntuación superior al umbral que establezcas se considerará fraude de cargos telefónicos por SMS. Por ejemplo, si estableces un umbral de 0.3, reCAPTCHA rechazará cualquier solicitud con un valor de 0.4 o superior. Por lo tanto, cuanto más baja sea la puntuación que establezcas, más estrictas serán las reglas.

Supervisa las métricas de reCAPTCHA que emite tu proyecto para verificar que tu app reciba tráfico de usuarios aceptable después de ajustar el umbral de puntuación.

¿Qué sigue?