Resolver problemas de integração do reCAPTCHA

Neste documento, listamos problemas comuns de integração do reCAPTCHA que os desenvolvedores podem encontrar ao usar o reCAPTCHA no ambiente deles.

Chave do site ou tipo de chave inválido

Se você receber o erro Invalid site key ou Invalid key type, verifique o seguinte:

Falha na migração de chaves

As chaves de site podem não ser migradas em um dos seguintes cenários:

  • Você excedeu o número de projetos que você ou sua organização podem criar.

    Para resolver esse problema, reutilize um projeto atual, peça um aumento na cota de criação de projetos ou aguarde a conclusão da migração automatizada.

  • Sua organização do Workspace restringiu a criação de novos projetos do Google Cloud.

    Para ativar o serviço do Google Cloud no Google Admin Console, entre em contato com seu administrador. Para mais informações, consulte Ativar ou desativar o Google Cloud para os usuários.

SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt"

Isso geralmente ocorre se o elemento HTML do widget reCAPTCHA é removido de forma programática algum tempo depois que o usuário final clica na caixa de seleção. Recomendamos usar a função JavaScript grecaptcha.enterprise.reset() para redefinir o widget do reCAPTCHA.

O localhost não está na lista de domínios compatíveis

Os domínios localhost não são compatíveis por padrão. Se você quiser continuar oferecendo suporte para desenvolvimento, adicione-os à lista de domínios compatíveis com sua chave do site. Acesse o console doGoogle Cloud para atualizar sua lista de domínios compatíveis. Recomendamos que você use chaves separadas para desenvolvimento e produção e permita apenas o localhost na chave do site de desenvolvimento.

O reCAPTCHA retornou BROWSER_ERROR ao criar uma avaliação

Os tokens BROWSER_ERROR ocorrem quando o script do reCAPTCHA não pode executar uma operação execute. Na maioria dos casos, isso ocorre devido a uma falha ou tempo limite de rede do lado do cliente. Tente novamente execute() usando o JavaScript.