Criar chaves reCAPTCHA para sites

Esta página explica como criar chaves reCAPTCHA para verificar as interações do usuário nas páginas da Web.

As chaves reCAPTCHA representam como o reCAPTCHA está configurado para um site. A configuração inclui opções importantes, como a exibição de testes de CAPTCHA.

Antes de começar

Criar uma chave reCAPTCHA

Não há limite no número de chaves reCAPTCHA que podem ser criadas para um Google Cloud projeto. É melhor criar uma chave reCAPTCHA por site.

Recomendamos criar chaves reCAPTCHA separadas para ambientes de preparação e produção. Caso contrário, você corre o risco de poluir a análise de risco reCAPTCHA com dados do seu ambiente de teste.

A maneira mais simples de criar uma chave reCAPTCHA é pelo console de administração do reCAPTCHA. Como alternativa, é possível usar o Google Cloud console, a API reCAPTCHA Enterprise ou a Google Cloud CLI.

Admin Console

  1. Acesse o console de administração do Google Cloud Fraud Defense.

    Acessar o console de administração do Fraud Defense

  2. No campo Rótulo, insira um nome que possa ser usado para identificar seu site.
  3. Se você quiser criar uma chave baseada em pontuação, selecione Com base em pontuação (v3). Se você quiser criar uma chave de caixa de seleção, selecione Desafio (v2).
  4. Para adicionar um domínio, insira o nome de domínio e clique em .

    Para adicionar outro domínio, repita esta etapa. É possível adicionar até 250 domínios.

  5. Se você não conhece o Google Cloud console, leia os Termos de Serviço e marque a caixa de seleção.
  6. Clique em Enviar.

Se você não conhece o Google Cloud console, um Google Cloud projeto será criado e as APIs necessárias serão ativadas para você começar. Se você já tem um Google Cloud projeto, as APIs necessárias serão ativadas para que você possa começar.

Console do Cloud

  1. No Google Cloud consol do Cloud, acesse a página Google Cloud Fraud Defense.

    Acessar o Google Cloud Fraud Defense

  2. Verifique se o nome do projeto aparece no seletor de recursos na parte superior da página.

    Se você não vir o nome do projeto, clique no seletor de recursos, para selecioná-lo.

  3. Selecione a guia Chaves.
  4. Clique em Criar chave.
  5. No campo Nome de exibição, insira um nome de exibição para a chave.
  6. Em Tipo de aplicativo, selecione Web.

    A seção Lista de domínios é exibida.

  7. Para proteger a chave reCAPTCHA do seu domínio e subdomínios, verifique se a opção Desativar verificação de domínio está desativada.

    Desativar a verificação de domínio é um risco para a segurança porque não há restrições no site, então sua chave reCAPTCHA pode ser acessada e usada por qualquer pessoa.

  8. Insira o nome de domínio do seu site:

    1. Na seção Lista de domínios, clique em Adicionar um domínio.
    2. No campo Domínio, digite o nome do seu domínio.

    3. Opcional: para adicionar outro domínio, clique em Adicionar um domínio e digite o nome de outro domínio no campo Domínio. É possível adicionar até 250 domínios.

      Para sites, a chave reCAPTCHA é exclusiva para domínios e subdomínios especificados. É possível especificar mais de um domínio caso seu site seja veiculado em vários. Se você especificar um domínio (por exemplo, examplepetstore.com), não precisará especificar os subdomínios (por exemplo, subdomain.examplepetstore.com).

      Para usar uma chave em mais de 250 domínios, clique na opção Desativar verificação de domínio. O Google Cloud Fraud Defense vai ignorar a lista de domínios. Você precisa realizar a verificação de domínio por conta própria, examinando o tokenProperties.hostname campo nas avaliações criadas.

  9. Dependendo do tipo de chave reCAPTCHA que você quer criar para seu site, execute a ação apropriada:

    10. Criar chaves reCAPTCHA baseadas em pontuação

    1. Se você quiser permitir que a chave baseada em pontuação funcione com Accelerated Mobile Pages (AMP), ative a opção Permitir que esta chave funcione com páginas AMP.

    2. Para seu ambiente de não produção, se você quiser especificar uma pontuação que a chave deve retornar quando as avaliações forem criadas para ela, faça o seguinte:

      1. Clique em Próxima etapa (opcional).
      2. Na etapa "Configurações adicionais", clique na opção