Solução de problemas da integração do Identity Platform com a API reCAPTCHA Enterprise

Este documento fornece orientações para a solução de problemas que podem surgir ao usar a integração do Identity Platform com a API reCAPTCHA Enterprise, incluindo os recursos de proteção contra bots do reCAPTCHA e de Defesa de SMS do reCAPTCHA.

Solução de problemas de integração

Seus usuários podem estar enfrentando problemas devido a erros ao integrar com a integração do Identity Platform com a API reCAPTCHA Enterprise. Alguns motivos comuns podem incluir o seguinte:

  • Talvez você tenha pulado uma etapa na configuração da integração do Identity Platform com a API reCAPTCHA Enterprise. Por exemplo, negligenciar a configuração da conta de serviço ou ativar a API reCAPTCHA Enterprise no projeto. Verifique se você concluiu todos os requisitos de integração. Para instruções de configuração, consulte Integrar o Identity Platform à API reCAPTCHA Enterprise.
  • Se você estiver trazendo sua própria chave para usar com o reCAPTCHA, a chave correspondente que você enviou pode não ser válida ou pode ter parado de funcionar. Verifique se a chave está funcionando e se pode ser acessada pelo Identity Platform.
  • Os usuários podem estar usando uma versão desatualizada do app. Forneça uma versão atualizada do app que use o SDK do cliente e peça aos usuários que atualizem o app. Para configurar o SDK do cliente para seu app, consulte Configurar o SDK do cliente.

Os usuários não podem se autenticar usando fluxos compatíveis com a API reCAPTCHA Enterprise

Se você estiver com problemas nos fluxos compatíveis com a API reCAPTCHA Enterprise, como a proteção contra bots do reCAPTCHA ou a defesa de SMS do reCAPTCHA, consulte as seções a seguir para orientações específicas sobre os recursos.

Solução de problemas da proteção contra bots do reCAPTCHA

Os tópicos a seguir descrevem possíveis problemas que você pode enfrentar ao usar a proteção contra bots e como resolvê-los.

Os usuários não conseguem se autenticar ao usar a proteção contra bots para os provedores de e-mail/senha ou telefone

Se você determinou que a integração do Identity Platform com a API reCAPTCHA Enterprise foi configurada corretamente, os usuários podem ser impedidos de realizar ações de autenticação por meio dos provedores de e-mail/senha ou de telefone com base na sua configuração atual. Por exemplo, os usuários podem não conseguir realizar as seguintes ações:

  • Fazer login, se inscrever ou redefinir uma senha usando um endereço de e-mail.
  • Solicite um código SMS para fazer login com um número de telefone.
  • Registrar ou fazer login com a autenticação multifator baseada em SMS.

Para resolver esses problemas de autenticação, tente o seguinte:

  • Se as solicitações do usuário estiverem falhando com ERROR_CAPTCHA_CHECK_FAILED, considere uma configuração mais permissiva ajustando os limites definidos para managedRules. Todas as solicitações com pontuação abaixo do limite definido serão consideradas bots. Por exemplo, se você definir um limite de 0.6, o reCAPTCHA vai falhar em qualquer solicitação com 0.5 ou menos. Portanto, quanto maior a pontuação definida, mais rígidas serão as regras.
  • Peça para o usuário tentar um dispositivo, navegador ou rede diferente.
  • Para fluxos de autenticação de e-mail e senha, reverta emailPasswordEnforcementState para o modo AUDIT e monitore as métricas antes de reativar o modo ENFORCE.
  • Para fluxos de autenticação de smartphone, ajuste os limites de pontuação do managedRules ou desative a proteção contra bots para o provedor de smartphone durante a solução de problemas. Se a defesa de SMS do reCAPTCHA também estiver ativada e você quiser mantê-la ativa, defina useSmsBotScore como false e deixe phoneEnforcementState definido como ENFORCE. Para desativar toda a proteção do reCAPTCHA para smartphones, defina phoneEnforcementState como OFF, useSmsBotScore como false e useSmsTollFraudProtection como false.

Solução de problemas da Defesa de SMS do reCAPTCHA

Os tópicos a seguir descrevem possíveis problemas que você pode enfrentar ao usar a defesa de SMS do reCAPTCHA e como resolvê-los.

Os usuários não conseguem se autenticar ao usar a Defesa de SMS do reCAPTCHA para o provedor de telefonia

Se você determinou que a integração do Identity Platform com a API reCAPTCHA Enterprise foi configurada corretamente, os usuários podem ser impedidos de realizar ações de autenticação baseadas em SMS pelo provedor de telefonia com base na sua configuração atual. Por exemplo, os usuários podem não conseguir solicitar um código SMS para fazer login com um número de telefone ou se inscrever ou fazer login com a autenticação multifator. Isso pode acontecer se a pontuação da Defesa de SMS do reCAPTCHA que você definiu for muito rigorosa.

Para resolver isso, considere uma configuração mais permissiva ajustando o limite definido para tollFraudManagedRules. Qualquer pontuação acima do limite definido será considerada fraude de cobrança por SMS. Por exemplo, se você definir um limite de 0.3, o reCAPTCHA vai falhar em qualquer solicitação com 0.4 ou mais. Portanto, quanto menor a pontuação definida, mais rígidas serão as regras.

Monitore as métricas do reCAPTCHA emitidas pelo projeto para verificar se o app está recebendo tráfego de usuários aceitável após o ajuste do limite de pontuação.

A seguir