Perguntas frequentes

Devo usar o reCAPTCHA Enterprise?

O reCAPTCHA Enterprise oferece até 10.000 avaliações por mês sem custo financeiro e também fornece recursos adicionais. Outros recursos, como análises em tempo real, são o melhor ponto de partida para a maioria dos desenvolvedores. Comece aqui.

Posso usar o reCAPTCHA com soluções de terceiros?

Sim, é possível usar o reCAPTCHA (versão não Enterprise) e o reCAPTCHA Enterprise. Normalmente, a solução de terceiros pede sua chave pública e sua chave secreta ou de API. Forneça sua chave secreta e chave de API apenas a terceiros confiáveis.

Como migrar da v2 ou v3 para o reCAPTCHA Enterprise?

O processo de migração leva de 5 a 10 minutos para ser concluído e não requer mudanças no código.

Devo usar o reCAPTCHA v2 ou v3?

O reCAPTCHA v3 é para proprietários de sites que querem mais dados sobre o tráfego. Para mais informações, consulte o guia para desenvolvedores do reCAPTCHA v3.

Oferecemos suporte à segurança e usabilidade da v2.

Para mais informações sobre as diferenças entre o reCAPTCHA v2 e v3, consulte a comparação de versões.

O reCAPTCHA usa cookies?

Quando executado, o reCAPTCHA define um cookie necessário (_GRECAPTCHA) para fornecer análise de risco. Se você preferir não usar o domínio www.google.com, que pode ter outros cookies definidos, use www.recaptcha.net.

Há limites diários ou de QPS no meu uso do reCAPTCHA?

Se você quiser fazer mais de 1.000 chamadas por segundo ou 1.000.000 de chamadas por mês, use o reCAPTCHA Enterprise ou preencha este formulário e aguarde a aprovação de uma exceção. Se uma chave de site exceder 1.000 QPS, algumas solicitações poderão não ser processadas. Se uma chave de site v3 exceder a cota mensal, o `site_verify` poderá falhar retornando uma pontuação estática de 0,9 e uma mensagem de erro `"Over free quota."` pelo restante do mês. Não há indicações visíveis para o usuário quando os sites da v3 estão acima da cota. Se uma chave de site v2 exceder a cota mensal, a seguinte mensagem ou uma semelhante poderá ser exibida aos usuários no widget do reCAPTCHA pelo restante do mês: "Este site está excedendo a cota do reCAPTCHA". Antes que a cota seja aplicada, os proprietários do site serão notificados por e-mail três vezes e terão pelo menos 90 dias para migrar para o reCAPTCHA Enterprise. As chaves de site são consideradas acima da cota se mais de 1.000.000 de chamadas por mês forem usadas para qualquer domínio. Isso inclui se esse volume estiver distribuído em várias chaves no mesmo domínio.

Quero ocultar o selo do reCAPTCHA. O que é permitido?

É permitido ocultar o selo, desde que você inclua a visibilidade da marca do reCAPTCHA no fluxo do usuário. Inclua o seguinte texto:

This site is protected by reCAPTCHA.

Exemplo:

Observação: se você optar por ocultar o selo, use 

.grecaptcha-badge { visibility: hidden; }

Quero executar testes automatizados com o reCAPTCHA. O que devo fazer?

Para o reCAPTCHA v3, crie uma chave separada para ambientes de teste. As pontuações podem não ser precisas, já que o reCAPTCHA v3 depende da análise do tráfego real.

Para o reCAPTCHA v2, use as seguintes chaves de teste. Você sempre vai receber No CAPTCHA, e todas as solicitações de verificação serão aprovadas.

  • Chave do site: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Chave secreta: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

O widget do reCAPTCHA vai mostrar uma mensagem de aviso para garantir que ele não seja usado para tráfego de produção.

Como posso evitar entrar no código do reCAPTCHA ao depurar meu site?

Para evitar entrar no código do reCAPTCHA ao depurar outro JavaScript no seu site, adicione o script do reCAPTCHA /recaptcha__.+\.js$ à lista de ignorados do navegador. Para instruções sobre o Chrome, consulte Ignorar uma lista personalizada de scripts. Recursos semelhantes estão disponíveis em outros navegadores.

Como posso ver mais informações sobre o tráfego do meu site?

O reCAPTCHA informa estatísticas diárias no Admin Console.

Posso usar o reCAPTCHA de maneira global?

Sim, use "www.recaptcha.net" no seu código quando "www.google.com" não estiver acessível.

  • Primeiro, substitua <script src="https://www.google.com/recaptcha/api.js"></script> por <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
  • Depois, faça o mesmo em todos os outros lugares que usam "www.google.com/recaptcha/" no seu site.

Posso personalizar o widget ou o selo do reCAPTCHA?

Sim. O reCAPTCHA oferece dois temas, claro e escuro, como mostrado abaixo. Para escolher um tema, basta definir o atributo data-theme no parâmetro grecaptcha.render.

Tema claro:

Tema escuro:

Como posso personalizar o reCAPTCHA v3?

A API JavaScript disponível para o reCAPTCHA invisível também funciona para a v3. Basta usar a API JavaScript para renderizar explicitamente o reCAPTCHA com uma chave de site v3 para acessar opções como reposicionar o selo ou mudar o tema.

Ao renderizar o reCAPTCHA v3 com esse método, defina o parâmetro size como 'invisible' e use o ID do cliente retornado por grecaptcha.render ao chamar grecaptcha.execute em vez da chave do site.

Recentemente, meu widget reCAPTCHA começou a exibir "Chave do site inválida". O que está acontecendo?

Se você estiver vendo esse erro, sua chave de site do reCAPTCHA não é mais válida. Para ativar, registre uma nova chave e siga as instruções nessa página.

Estou recebendo um SecurityError não detectado: bloqueou um frame com origem "https://www.google.com" de acessar um frame com origem "<seu domínio>". O que devo fazer?

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.reset() para redefinir o widget reCAPTCHA.

Estou usando a Política de Segurança de Conteúdo (CSP) no meu site. Como posso configurá-lo para funcionar com o reCAPTCHA?

Recomendamos usar a abordagem baseada em valor de uso único documentada com a CSP3. Inclua o valor de uso único no tag script api.js do reCAPTCHA, e nós cuidaremos do resto.

Observação: o reCAPTCHA também funciona com 'strict-dynamic' em navegadores compatíveis.

Como alternativa, adicione os seguintes valores às diretivas:

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

Estou recebendo o erro "Localhost is not in the list of supported domains". O que devo fazer?

Os domínios localhost não são compatíveis por padrão. Se você quiser continuar usando esses domínios para desenvolvimento, adicione-os à lista de domínios compatíveis com sua chave do site. Acesse o console do reCAPTCHA Enterprise ou o console do reCAPTCHA, conforme apropriado, para atualizar sua lista de domínios compatíveis. Recomendamos usar chaves separadas para desenvolvimento e produção e permitir apenas localhost na chave do site de desenvolvimento.

Somente no iOS 10, a página rola até o final quando o usuário conclui o desafio?

Esse é um bug de foco da Apple que já foi relatado. Ele afeta apenas os usuários do iOS 10 e somente em alguns sites. Se você for afetado, uma solução alternativa é mover o widget do reCAPTCHA para cima ou para baixo na página ou usar o reCAPTCHA v3.

Meu computador ou minha rede pode estar enviando consultas automáticas?

Se você foi direcionado para esta página pelo widget do reCAPTCHA, deve ter visto uma mensagem dizendo "Lamentamos, mas seu computador ou sua rede pode estar enviando consultas automáticas. Para proteger nossos usuários, não podemos processar seu pedido no momento."

Infelizmente, isso pode acontecer com bons usuários por alguns motivos:

  • Você pode estar em uma rede compartilhada que está sendo usada de forma abusiva
  • Seu provedor de acesso à Internet pode ter atribuído um endereço IP suspeito a você recentemente.
  • O site que você está tentando acessar pode estar sob um ataque pesado no momento

Para resolver problemas, consulte a página de ajuda sobre tráfego incomum ou tente de novo mais tarde.

Quais nomes de ação são válidos?

As ações podem conter apenas caracteres alfanuméricos, barras e sublinhados. As ações não podem ser específicas do usuário.