Instale chaves de desafio baseadas em políticas em Websites

Esta página explica como instalar uma chave de desafio baseada em políticas no seu Website. Com uma chave de desafio baseada em políticas, o reCAPTCHA pode acionar deterministicamente desafios CAPTCHA com base num limite de pontuação e na dificuldade do desafio.

Antes de começar

  1. Prepare o seu ambiente para o reCAPTCHA.

  2. Crie uma chave de desafio baseada em políticas.

    Em alternativa, pode copiar o ID de uma chave de desafio baseada em políticas existente através de um dos seguintes passos:

    • Para copiar o ID de uma chave existente a partir da Google Cloud consola, faça o seguinte:

      1. Aceda à página reCAPTCHA.

        Aceder ao reCAPTCHA

      2. Na lista de chaves do reCAPTCHA, mantenha o ponteiro sobre a chave que quer copiar e, de seguida, clique em .
    • Para copiar o ID de uma chave existente através da API REST, use o método projects.keys.list.
    • Para copiar o ID de uma chave existente através da CLI gcloud, use o comando gcloud recaptcha keys list.

Configure a chave de desafio baseada em políticas

Para a chave de desafio baseada em políticas, tem de especificar a dificuldade do desafio que determina a complexidade e a frequência dos desafios CAPTCHA e definir um limite personalizado de pontuação para ações específicas que substitui o limite predefinido.

  1. Na Google Cloud consola, aceda à página reCAPTCHA.

    Aceder ao reCAPTCHA

    A página reCAPTCHA tem duas vistas: Tabelas e Cartões. Se o seu projeto tiver muitas chaves do reCAPTCHA, apenas a vista de tabela está disponível.

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

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

  3. Na secção Chaves reCAPTCHA, identifique a chave de desafio baseada em políticas que quer configurar e clique na chave.

  4. Na página Detalhes principais, aceda ao separador Vista geral.

  5. Na secção Configuração, clique em Configurar para Definições de desafio.

  6. Na página Configure as definições do desafio, selecione a dificuldade do desafio.

  7. Para acionar desafios CAPTCHA, use o controlo de deslize para especificar o valor do limite predefinido.

    O limite predefinido de 0.0 não aciona nenhum desafio. 1.0 aciona um desafio para cada pedido.

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

    1. Introduza um nome da ação.

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

    3. Clique em Concluído.

  9. Clique em Guardar.

Adicione o reCAPTCHA a um botão HTML

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

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

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

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

    1. Defina uma função de chamada de retorno 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 seu botão HTML.

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

      Se quiser especificar uma localização para o emblema, use o atributo data-badge=LOCATION no elemento que tem class=g-recaptcha. Por predefinição, a localização está definida como bottomright. Os outros valores possíveis são inline e bottomleft.

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

  3. Depois de o token ser gerado, envie-o para o seu back-end e crie uma avaliação no prazo de dois minutos.

O que se segue?