DocumentaçãoCommerceGuia de sistemas do administrador

[Somente SaaS]{class="badge positive" title="Aplicável somente a projetos do Adobe Commerce as a Cloud Service (infraestrutura SaaS gerenciada pela Adobe)."}

Google reCAPTCHA Enterprise

Last update: Tue Jan 20 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Iniciante
  • Intermediário
  • Administrador

A Google reCAPTCHA Enterprise oferece proteção avançada de bot para sua loja Adobe Commerce as a Cloud Service usando análise de risco adaptável e aprendizado de máquina para diferenciar usuários humanos e bots. Isso ajuda a evitar atividades fraudulentas, spam e abuso em seu site.

NOTE
Esse recurso NÃO fornece suporte ao reCAPTCHA para o administrador.

Consulte Google reCAPTCHA V3 e V2 para obter informações sobre como configurar outras versões do Google reCAPTCHA.

Recursos

O Google reCAPTCHA Enterprise inclui os seguintes recursos:

  • Detecção avançada de bot: usa os modelos de aprendizado de máquina da Google Cloud para detecção superior de bot
  • Análise de pontuação de risco: fornece pontuações de risco detalhadas (0,0-1,0) para cada interação
  • Limites configuráveis: definir pontuações de risco mínimas aceitáveis por locatário
  • Suporte a vários locatários: configuração por locatário com projetos isolados da Google Cloud
  • Credenciais criptografadas: credenciais de conta de serviço armazenadas e criptografadas em um banco de dados
  • Proteção de formulário: protege todos os formulários padrão do Commerce, incluindo logon, check-out, revisões de produtos e muito mais.

Pré-requisitos

Você precisa dos seguintes recursos antes de configurar o Google reCAPTCHA Enterprise para sua loja Adobe Commerce as a Cloud Service:

  • Uma conta ativa da Google Cloud com o reCAPTCHA Enterprise ativado.
  • Acesso ao Google Cloud Console para criar e gerenciar chaves reCAPTCHA Enterprise.

Em instalações de vários locatários do Adobe Commerce as a Cloud Service, cada locatário deve ter seu próprio projeto da Google Cloud e chaves reCAPTCHA Enterprise.

Etapa 1: configurar o Google reCAPTCHA Enterprise

Siga estas etapas gerais para configurar o Google reCAPTCHA Enterprise para sua loja. Para obter instruções detalhadas, consulte a documentação do Google reCAPTCHA Enterprise.

  1. Crie um projeto da Google Cloud para sua implementação do reCAPTCHA Enterprise.

  2. Habilite a API corporativa do reCAPTCHA.

  3. Crie uma chave do site reCAPTCHA Enterprise baseada em pontuação.

  4. Crie uma Conta de Serviço com a função IAM roles/recaptchaenterprise.admin.

  5. Baixe o arquivo de chave JSON da conta de serviço, que contém as credenciais necessárias para autenticar sua loja do Adobe Commerce as a Cloud Service com o Google reCAPTCHA Enterprise.

Etapa 2: configurar o Google reCAPTCHA para a loja

  1. No painel esquerdo, em Security, escolha Google reCAPTCHA Storefront.

  2. Conclua a seção reCAPTCHA Enterprise da seguinte maneira.

    • Para Site Key, copie e cole sua chave do site reCAPTCHA Enterprise do seu Google Cloud Console.

    • Para Google Cloud Project ID, copie e cole a ID do projeto do seu projeto do Google Cloud.

    • Para Service Account JSON, copie o conteúdo do arquivo de chave JSON da Conta de Serviço que você baixou em Etapa 1: Configurar o Google reCAPTCHA Enterprise.

    • Para Minimum Score Threshold, insira a pontuação mínima (0.0-1.0) para identificar quando uma interação do usuário é sinalizada como um risco potencial. Uma pontuação de 1,0 é uma interação típica do usuário, e 0,0 provavelmente é um bot.

    • Para Badge Position, escolha a posição do selo reCAPTCHA invisível em cada página. Opções: Inline / Bottom Right / Bottom Left.

    • Para Theme, escolha Light Theme (padrão) ou Dark Theme para determinar o estilo da caixa do reCAPTCHA do Google.

    • Para Language Code, insira um código de dois caracteres que especifique o idioma usado para texto e mensagens do Google reCAPTCHA.

    • Para Validation Failure Message, opcionalmente, altere a mensagem exibida na loja quando a validação não for bem-sucedida.

  3. Expanda a seção Storefront e defina cada formulário de vitrine eletrônica que você deseja proteger para reCAPTCHA Enterprise.

Etapa 3: salvar a configuração

  1. Quando as configurações estiverem concluídas, clique em Save Config.

  2. Na mensagem na parte superior do espaço de trabalho, clique em Cache Management e atualize cada cache inválido.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1