Perguntas frequentes

Saiba mais sobre problemas comuns que você pode encontrar ou dúvidas que pode ter ao usar o Google Cloud Fraud Defense.

Geral

Saiba como o Fraud Defense e o reCAPTCHA se relacionam e funcionam com suas integrações atuais.

Qual é a diferença entre o reCAPTCHA e o Fraud Defense e o que isso significa para minha integração atual?

O Fraud Defense é a próxima evolução da nossa plataforma de confiança, projetada para proteger as interações digitais contra bots, fraudes humanas e agentes de IA. No pacote de produtos do Fraud Defense, o reCAPTCHA continua sendo o pilar principal de defesa contra bots.

A API reCAPTCHA, os recursos de defesa contra bots e os tokens que você usa continuam totalmente compatíveis. Para os clientes atuais do reCAPTCHA, a transição para o Fraud Defense é simples:

  • Você é automaticamente um cliente do Fraud Defense.
  • Nenhuma migração ou ação é necessária.
  • Não há mudanças nos preços.
  • As chaves de site e integrações atuais continuam funcionando sem mudanças de código ou configuração.

Implementação

Posso usar o reCAPTCHA de maneira global?

Sim, é possível usar www.recaptcha.net no código de front-end quando www.google.com não estiver acessível para os usuários.

  • Primeiro, substitua <script src="https://www.google.com/recaptcha/enterprise.js?render=<SITE_KEY>"></script> por <script src="https://www.recaptcha.net/recaptcha/enterprise.js?render=<SITE_KEY>"></script>, ao substituir a chave do seu site por <SITE_KEY>.
  • Depois disso, aplique a mesma lógica a qualquer outro lugar que use www.google.com/recaptcha/ no seu site.

O Fraud Defense usa cookies?

Quando executado, o Fraud Defense 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.

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

É permitido ocultar o selo, desde que você inclua o fato de que usa o reCAPTCHA para proteger seu site. Inclua o seguinte texto:

This site is protected by reCAPTCHA.

Exemplo:

Exemplo da mensagem &quot;Protegido pelo reCAPTCHA&quot;

Aprenda mais sobre o tratamento de dados do Fraud Defense.

Preciso mostrar o selo ou widget do reCAPTCHA no meu app nativo para dispositivos móveis?

Não. O SDK do reCAPTCHA para dispositivos móveis é executado de forma invisível em segundo plano e não renderiza nenhum selo ou widget no seu app nativo para dispositivos móveis. Não é necessário ocultar ou configurar um selo.

Se você quiser notificar os usuários de que seu aplicativo para dispositivos móveis está protegido pelo reCAPTCHA, mostre uma declaração de texto no aplicativo, como na tela "Sobre", no fluxo do usuário ou no rodapé. Exemplo:

This app is protected by reCAPTCHA.

Posso personalizar o widget ou o selo do reCAPTCHA?

Sim. O reCAPTCHA oferece temas claros e escuros. Para escolher um tema, defina o atributo data-theme ou o parâmetro theme ao renderizar o widget ou o selo.

  • Tema claro:
    Widget ou selo do reCAPTCHA no tema claro

  • Tema escuro:
    Widget ou selo do reCAPTCHA no tema escuro

Recomendamos usar a abordagem documentada com a CSP3. Inclua o número que pode ser usado apenas uma vez na tag script enterprise.js do reCAPTCHA, e nós cuidaremos do resto.

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/

Quantos domínios posso adicionar à lista de verificação de domínios no console do Google Cloud ?

Há um limite de 250 domínios por chave.

Para usar uma chave em mais de 250 domínios, consulte Criar chaves para sites.

Uso uma implementação de plug-in de terceiros que não é formalmente compatível com as APIs do Cloud do reCAPTCHA, mas apenas com a API reCAPTCHA legada siteverify. Ainda posso usar o reCAPTCHA?

Sim. É possível verificar a versão da chave (v2 ou v3) e recuperar a chave do site (ID da chave) e a chave secreta legada no console do Google Cloud . Para instruções sobre como configurar plug-ins de terceiros e plataformas de CMS, como WordPress ou Shopify, consulte Reconciliar a terminologia do Admin Console e do console do Google Cloud .

Como posso evitar entrar no código do Fraud Defense 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.

Por que a página rola até o final quando o usuário conclui o desafio apenas no iOS 10?

Esse é um bug de foco que já informamos à Apple. 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 reCAPTCHA para cima ou para baixo na página.

Uso

Encontre respostas para perguntas sobre cotas, métricas e testes do Google Cloud Fraud Defense.

Por que estou vendo a mensagem "Seu computador ou sua rede pode estar enviando consultas automáticas"?

Talvez você veja a mensagem "Seu computador ou sua rede pode estar enviando consultas automatizadas. Para proteger nossos usuários, não podemos processar sua solicitação no momento" por um dos seguintes motivos:

  • Tráfego de rede compartilhado: você está usando uma rede compartilhada (como uma VPN corporativa ou um Wi-Fi público) que está gerando tráfego abusivo ou automatizado.
  • Endereço IP suspeito: seu provedor de acesso à Internet (ISP) atribuiu a você um endereço IP recentemente associado a uma atividade suspeita.
  • Ataque ativo ao site: o site que você está tentando acessar está recebendo um grande volume de solicitações automatizadas ou um ataque DDoS.

Para resolver problemas, consulte a página de ajuda sobre tráfego incomum ou tente fazer a solicitação novamente mais tarde.

Há limites de taxa no meu uso do Fraud Defense?

Sim, consulte cotas e limites.

No painel do Fraud Defense, qual fuso horário é usado? Posso alterar essa informação?

Esse fuso horário é baseado no fuso horário do cliente do seu navegador. Essa informação não pode ser alterada no momento.

Como faço para medir a qualidade das pontuações que o Fraud Defense está retornando?

No final das contas, depende do seu caso de uso e dos resultados necessários. Em geral, recomendamos que você use suas próprias métricas internas sobre o comportamento do usuário para determinar se a pontuação foi precisa, como:

  • Um usuário que redefiniu a senha e recebeu uma pontuação alta informa posteriormente que a conta dele foi invadida?
  • Um usuário que fez login com uma pontuação baixa continua enviando spam para outras pessoas?
  • Um usuário que não conseguiu fazer login e recebeu uma pontuação continuou tentando fazer login com vários nomes de usuário diferentes?

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

Confira os detalhes na página Fraud Defense do console doGoogle Cloud .

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

É possível criar chaves de site do reCAPTCHA projetadas para testes usando a Google Cloud CLI. Para mais informações, consulte as opções --testing-challenge e --testing-score na página recaptcha keys create reference.

Exemplos

  • Criar uma chave de site com caixa de seleção que sempre retorna "Sem CAPTCHA" (sem teste) e 1,0 (altere --domains e --display-name abaixo).
gcloud recaptcha keys create --testing-challenge=nocaptcha --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always No CAPTCHA" --integration-type=checkbox
  • Criar uma chave de site com caixa de seleção que sempre retorna um teste sem solução (altere --domains e --display-name abaixo).
gcloud recaptcha keys create --testing-score=0.0 --testing-challenge=challenge --web --domains="domain1.com,domain2.com" --display-name="Unsolvable Challenge" --integration-type=checkbox
  • Criar uma chave de site baseada em pontuação que sempre retorna uma pontuação definida (altere --domains, --display-name e --testing-score abaixo).
gcloud recaptcha keys create --testing-score=1.0 --web --domains="domain1.com,domain2.com" --display-name="Always 1" --integration-type=score

Quero me comunicar com a API REST do reCAPTCHA. Posso presumir que o formato da resposta não vai mudar no futuro?

À medida que nosso produto evolui, podemos aplicar mudanças não interruptivas, como adicionar novos campos à nossa API. Se você usar JSON, não valide estritamente o formato da resposta para manter a compatibilidade com futuras adições à API.

Quais são minhas opções se eu quiser criar uma chave do reCAPTCHA clássico?

Não é mais possível criar chaves clássicas. Se você tiver chaves clássicas, recomendamos que migre do reCAPTCHA clássico. Todos os clientes do Google Cloud reCAPTCHA podem criar 10.000 avaliações sem custo financeiro todos os meses. Para mais informações sobre uso e preços, consulte Preços do reCAPTCHA.

Processamento de dados

Aprenda mais sobre o tratamento de dados do Fraud Defense.

Quais são as implicações e recomendações sobre a remoção das referências à Política de Privacidade e aos Termos de Uso do Google do selo do reCAPTCHA e dos sites dos clientes a partir de 2 de abril de 2026?

A partir de 2 de abril de 2026, as referências à Política de Privacidade e aos Termos de Uso do Google serão removidas do selo do reCAPTCHA para refletir o papel do cliente como controlador de dados e o papel do Google como operador de dados do cliente. Embora esses links permaneçam ativos para outros produtos do Google, recomendamos que os clientes removam essas referências dos próprios sites para garantir uma representação precisa. Você pode continuar ocultando o selo reCAPTCHA, se necessário.

Os clientes assumem o papel de controlador de dados?

Os clientes do Fraud Defense sempre foram controladores de dados em relação aos dados dos usuários finais. No entanto, o Google manteve a posição de que operava como um controlador de dados independente em relação à entrega do Fraud Defense. Ao mudar para a função de operador de dados, o Google abre mão da capacidade de determinar as finalidades e os meios de tratamento dos Dados do Cliente. Por isso, os clientes do Fraud Defense precisam remover as referências à Política de Privacidade do Google e aos Termos de Uso. A partir de 2 de abril de 2026, os clientes do Fraud Defense serão os únicos controladores dos Dados do Cliente, e o Google só vai tratar esses dados de acordo com os Termos de Serviço do Google Cloud e o Aditivo sobre Tratamento de Dados do Cloud.

O cookie do reCAPTCHA (_grecaptcha) permanece e não é afetado.

Há alguma implicação para as implementações atuais do Fraud Defense ou para a postura contratual com o Google ao mudar para o papel de operador de dados?

Não há implicações para suas implementações do Fraud Defense ou postura contratual com o Google. No entanto, revise suas declarações de privacidade voltadas ao usuário final para garantir que elas cubram a finalidade do tratamento realizado pelo Fraud Defense, que é a segurança, a prevenção de fraudes e de abusos. O Google atualizou os Termos de Serviço Específicos do Fraud Defense como parte da mudança para um operador de dados. Essa atualização remove principalmente as obrigações do cliente, como o requisito de exibir a Política de Privacidade e os Termos de Serviço do Google aos usuários finais.

Como operador de dados, quais limitações de tratamento se aplicam aos Dados do Cliente tratados pelo Fraud Defense?

O Google se compromete a tratar os Dados do Cliente capturados usando o Fraud Defense apenas conforme necessário para fornecer e manter o serviço, além de garantir que os recursos de segurança, detecção, proteção e resposta a ameaças do serviço permaneçam eficazes contra ameaças em evolução. Essa limitação de finalidade já está descrita nos Termos específicos de serviço do Fraud Defense atuais e é ainda mais fundamentada nas nossas obrigações como operador de dados no Aditivo sobre tratamento de dados do Cloud.

Quais dados de sessão são coletados pelo Fraud Defense e como o Google os protege?

Para informações sobre a coleta de dados pelo Fraud Defense e as medidas que o Google toma para proteger os dados, consulte nosso Adendo sobre tratamento de dados do Cloud e os Termos específicos de serviço do Fraud Defense.

Para mais informações sobre como o Google protege os dados, consulte o Artigo sobre segurança.

A Fraud Defense está em conformidade com o GDPR?

Sim. No Google Cloud, apoiamos iniciativas que priorizam e melhoram a segurança e a privacidade dos dados pessoais dos clientes. Queremos que os clientes do Fraud Defense se sintam seguros ao usar nossos serviços em conformidade com os requisitos do GDPR. No Aditivo sobre tratamento de dados do Cloud, nos comprometemos a obedecer ao GDPR em relação ao tratamento de dados pessoais de clientes em todos os serviços do Google Cloud , incluindo o Fraud Defense.

Para ver outros termos específicos da Fraud Defense, consulte os Termos Específicos de Serviço da Fraud Defense.

As informações de transações de pagamento são coletadas pelo Fraud Defense?

Quando você instala o Fraud Defense em uma página de transação de pagamento, ele examina determinados sinais de transação para ajudar a proteger contra ataques automatizados. Por exemplo, muitas tentativas de compra por segundo com o mesmo preço podem, em certos casos, indicar um ataque.

No entanto, os bots representam apenas uma fração do problema geral de fraude. Para uma proteção mais abrangente, faça a integração com o Fraud Defense, que permite enviar informações de transação mais completas e receber avaliações de fraudes, como teste de cartão e uso de instrumentos roubados.