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 paramanagedRules. Todas as solicitações com pontuação abaixo do limite definido serão consideradas bots. Por exemplo, se você definir um limite de0.6, o reCAPTCHA vai falhar em qualquer solicitação com0.5ou 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
emailPasswordEnforcementStatepara o modoAUDITe monitore as métricas antes de reativar o modoENFORCE. - Para fluxos de autenticação de smartphone, ajuste os limites de pontuação do
managedRulesou 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, definauseSmsBotScorecomofalsee deixephoneEnforcementStatedefinido comoENFORCE. Para desativar toda a proteção do reCAPTCHA para smartphones, definaphoneEnforcementStatecomoOFF,useSmsBotScorecomofalseeuseSmsTollFraudProtectioncomofalse.
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
- Saiba mais sobre como monitorar as métricas do reCAPTCHA.