É 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
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.
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:
Acesse a página do Google Cloud Fraud Defense.
- Selecione a guia Chaves.
- 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.
No console do Google Cloud , acesse a página do reCAPTCHA.
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.
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.
Na seção Chaves reCAPTCHA, identifique a chave de desafio baseada em política que você quer configurar e clique nela.
Na página Detalhes da chave, clique na guia Visão geral.
Na seção Configuração, clique em Configurar em Configurações do desafio.
Na página Definir configurações do desafio, selecione a dificuldade.
Para acionar testes de CAPTCHA, use o controle deslizante para especificar o valor limite padrão.
O limite padrão de
0.0não aciona nenhum desafio. Um limite de1.0aciona um desafio para cada solicitação.Para configurar um limite de pontuação personalizado para ações individuais, que substitui o valor padrão, faça o seguinte:
Insira o nome da ação.
Para especificar um limite de pontuação personalizado, use o controle deslizante Definir limite de ação.
Clique em Concluído.
Clique em Salvar.
Adicionar o reCAPTCHA a um botão HTML
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=LANGno 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.Para adicionar o reCAPTCHA a um botão HTML, faça o seguinte:
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().
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=LOCATIONno elemento que temclass=g-recaptcha. Por padrão, o local é definido comobottomright. Os outros valores possíveis sãoinlineebottomleft.Quando esse botão é usado para enviar um formulário no site, o parâmetro POST
g-recaptcha-responsecontém o token de resposta.
Depois que o token for gerado, envie o token reCAPTCHA ao back-end e crie uma avaliação em até dois minutos.
A seguir
- Para avaliar o token de resposta reCAPTCHA, crie uma avaliação.