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

Esta página explica como instalar uma chave de teste baseada em política no seu site. Com uma chave de teste baseada em política, o reCAPTCHA pode acionar testes de CAPTCHA de forma determinista com base em um limite de pontuação e na dificuldade do teste.

Antes de começar

  1. Prepare seu ambiente para o reCAPTCHA.

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

    O reCAPTCHA exige que o faturamento seja vinculado e ativado no projeto para usar chaves de teste baseadas em política. É possível ativar o faturamento usando um cartão de crédito ou um ID de faturamento de projeto 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 baseada em política.

    Como alternativa, é possível copiar o ID de uma chave de teste baseada em política executando uma das seguintes etapas:

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

      1. Acesse a página reCAPTCHA.

        Acessar o reCAPTCHA

      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 atual usando a API REST, use o método projects.keys.list.
    • Para copiar o ID de uma chave atual usando a CLI gcloud, use o comando gcloud recaptcha keys list.

Configurar a chave de teste baseada em política

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. Noconsole, acesse a página reCAPTCHA. Google Cloud

    Acessar o reCAPTCHA

  2. Verifique se o nome do projeto aparece no seletor de recursos , na parte de cima 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.

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

  4. Na seção Chaves reCAPTCHA , identifique a chave de teste 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 para Configurações de teste.

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

  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 teste. Um limite de 1.0 aciona um teste para cada solicitação.

  9. Para configurar um limite de pontuação personalizado para ações individuais, que substitui o valor limite 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 página da Web, adicione a API JavaScript com a chave de teste 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 saber mais sobre os idiomas aceitos, consulte Códigos de idioma para reCAPTCHA.

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

    1. Defina uma função de callback para manipular 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 data-badge=LOCATION atributo 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 para o back-end e crie uma avaliação em dois minutos.

A seguir