Resolver problemas de integração do reCAPTCHA

Este documento lista problemas comuns de integração do reCAPTCHA que desenvolvedores podem encontrar ao usar o reCAPTCHA no ambiente deles.

Chave de site inválida

Se você encontrar o erro Invalid site key, a chave do site do reCAPTCHA não será mais válida. Crie uma nova chave e instale-a nas suas páginas da Web.

Falha na migração de chaves

As chaves do 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 isso, 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 espaço de trabalho restringiu a criação de novos projetos do Google Cloud.

    Para ativar o serviço 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: bloqueou um frame com origem "https://www.google.com" de acessar um frame com origem "&ltyour domain&gt"

Isso geralmente acontece se o elemento HTML do widget reCAPTCHA for removido programaticamente algum tempo depois que o usuário final clicar na caixa de seleção. Recomendamos usar a função JavaScript grecaptcha.enterprise.reset() para redefinir o widget reCAPTCHA.

O host local não está na lista de domínios com suporte

Os domínios de host local não são compatíveis por padrão. Se você quiser continuar oferecendo suporte a eles para desenvolvimento, adicione-os à lista de domínios aceitos para sua chave do site. Acesse o consoleGoogle Cloud para atualizar sua lista de domínios aceitos. Recomendamos usar chaves separadas para desenvolvimento e produção e permitir apenas 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 reCAPTCHA não consegue realizar uma operação execute. Na maioria dos casos, isso ocorre devido a uma falha ou um tempo limite de rede do lado do cliente. É preciso repetir execute() usando o JavaScript.