Instalar chaves de desafio com base em políticas em sites

É possível instalar uma chave de desafio baseada em políticas no seu site para acionar desafios visuais de CAPTCHA somente quando as solicitações recebidas corresponderem às políticas de segurança configuradas. A integração de chaves baseadas em políticas ajuda a manter uma experiência de navegação sem atrito para visitantes legítimos, ao mesmo tempo que apresenta uma verificação direcionada para tráfego suspeito.

Antes de começar

  1. Prepare seu ambiente para o Google Cloud Fraud Defense.

  2. Verifique se o faturamento está ativado para o projeto do Google Cloud .

    O reCAPTCHA exige que o faturamento esteja vinculado e ativado no projeto para usar chaves de desafio baseadas em políticas. É possível ativar o faturamento usando um cartão de crédito ou um ID de faturamento de projeto do Google Cloud atual. Se precisar de ajuda com o faturamento, entre em contato com o suporte do Cloud Billing.

  3. Crie uma chave de desafio com base em políticas.

    Como alternativa, você pode copiar o ID de uma chave de desafio baseada em política seguindo uma destas etapas:

    • Para copiar o ID de uma chave do console doGoogle Cloud , faça o seguinte:

      1. Acesse a página do Google Cloud Fraud Defense.

        Acessar o Google Cloud Fraud Defense

      2. Selecione a guia Chaves.
      3. Na lista de chaves reCAPTCHA, encontre a chave que você quer copiar e clique em .
    • Para copiar o ID de uma chave usando a API REST, use o método projects.keys.list.
    • Para copiar o ID de uma chave usando a CLI gcloud, use o comando gcloud recaptcha keys list.

Configurar a chave de desafio com base em políticas

Para a chave de teste baseada em política, é necessário especificar a dificuldade do teste, que determina a complexidade e a frequência dos testes de CAPTCHA, e definir um limite de pontuação personalizado para ações específicas que substitui o limite padrão.

  1. No console do Google Cloud , acesse a página do reCAPTCHA.

    Acessar o reCAPTCHA

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

    Se o nome do projeto não aparecer, clique no seletor de recursos e selecione o projeto.

  3. Selecione a guia Chaves.

    A guia Chaves tem duas visualizações: Tabela e Cards. Se o projeto tiver muitas chaves reCAPTCHA, apenas a visualização em Tabela estará disponível.

  4. Na seção Chaves reCAPTCHA, identifique a chave de desafio baseada em política que você quer configurar e clique nela.

  5. Na página Detalhes da chave, clique na guia Visão geral.

  6. Na seção Configuração, clique em Configurar em Configurações do desafio.

  7. Na página Definir configurações do desafio, selecione a dificuldade.

  8. Para acionar testes de CAPTCHA, use o controle deslizante para especificar o valor limite padrão.

    O limite padrão de 0.0 não aciona nenhum desafio. Um limite de 1.0 aciona um desafio para cada solicitação.

  9. Para configurar um limite de pontuação personalizado para ações individuais, que substitui o valor padrão, faça o seguinte:

    1. Insira o nome da ação.

    2. Para especificar um limite de pontuação personalizado, use o controle deslizante Definir limite de ação.

    3. Clique em Concluído.

  10. Clique em Salvar.

Adicionar o reCAPTCHA a um botão HTML

  1. Para carregar o reCAPTCHA na sua página da Web, adicione a API JavaScript com sua chave de desafio baseada em política no elemento <head></head> da página da Web.

        <head>
        <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
        ....
        </head>
      

    O reCAPTCHA usa o idioma do navegador por padrão. Se você quiser especificar um idioma diferente, use o atributo hl=LANG no script. Por exemplo, para usar o francês, especifique o seguinte: <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. Para aprender mais sobre os idiomas disponíveis, consulte os códigos de idioma do reCAPTCHA.

  2. Para adicionar o reCAPTCHA a um botão HTML, faça o seguinte:

    1. Defina uma função de callback para processar o token.

      <script>
         function onSubmit(token) {
           document.getElementById("demo-form").submit();
         } // Use `requestSubmit()` for extra features like browser input validation.
      </script>

      Para mais informações, consulte o método requestSubmit().

    2. Adicione atributos ao botão HTML.

      <button class="g-recaptcha"
      data-sitekey="KEY_ID"
      data-callback="onSubmit"
      data-action="submit">Submit</button>

      Se você quiser especificar um local para o selo, use o atributo data-badge=LOCATION no elemento que tem class=g-recaptcha. Por padrão, o local é definido como bottomright. Os outros valores possíveis são inline e bottomleft.

    3. Quando esse botão é usado para enviar um formulário no site, o parâmetro POST g-recaptcha-response contém o token de resposta.

  3. Depois que o token for gerado, envie o token reCAPTCHA ao back-end e crie uma avaliação em até dois minutos.

A seguir