reCAPTCHA v3
e CapMonster Cloud

Trabalhar com o CapMonster Cloud via API normalmente envolve as etapas abaixo:

1. Acesse a página do painel de administração do reCAPTCHA.

2. Registre um novo site e escolha o tipo de captcha — reCAPTCHA v3

3. Obtenha duas chaves:

• Site key — chave pública (usada no frontend);
• Secret key — chave privada (usada no servidor para verificação)

Você pode abrir as configurações, onde é possível, por exemplo, especificar os domínios nos quais o reCAPTCHA será utilizado ou configurar alertas sobre problemas no site ou aumento de tráfego suspeito.

4. Exemplos de código para o lado do cliente

A maneira mais simples de usar o reCAPTCHA v3 é conectar a API JavaScript e adicionar atributos a um botão.

Conectando a API:

<script src="https://www.google.com/recaptcha/api.js"></script>

Função de callback para o formulário:

<script>
  function onSubmit(token) {
    document.getElementById("form").submit();
  }
</script>

Botão com atributos do reCAPTCHA:

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

Para controle total, use grecaptcha.execute com o parâmetro render:

Conectando a API com a chave:

<script src="https://www.google.com/recaptcha/api.js?render=reCAPTCHA_site_key"></script>

Chamada programática:

<script>
  function onClick(e) {
    e.preventDefault();
    grecaptcha.ready(function() {
      grecaptcha.execute('reCAPTCHA_sitekey', {action: 'submit'}).then(function(token) {
          // Envie o token para o servidor para verificação
      });
    });
  }
</script>

O token deve ser enviado imediatamente ao servidor para verificação.

Observações importantes:

• Validade do token: o token recebido do reCAPTCHA v3 é válido por 2 minutos. Certifique-se de enviá-lo ao servidor dentro desse período.
• Verificação no servidor: após receber o token no servidor, envie uma requisição POST para https://www.google.com/recaptcha/api/siteverify com os parâmetros:
  – secret: sua chave secreta
  – response: o token recebido do cliente
  – remoteip (opcional): endereço IP do usuário
• O servidor do Google retornará uma resposta JSON contendo informações sobre o resultado da verificação.

Você pode encontrar informações mais detalhadas na documentação oficial do captcha.

5. Agora, no lado do servidor, faça a validação da resposta

Exemplo em PHP

<?php
// Sua chave secreta (Secret Key) do reCAPTCHA v3
$secret = 'YOUR_SECRET_KEY';

// Obtendo o token do formulário
$token = $_POST['recaptcha-token'] ?? '';

// Enviando a requisição ao Google para verificar o token
$response = file_get_contents(
    "https://www.google.com/recaptcha/api/siteverify?secret={$secret}&response={$token}"
);

$result = json_decode($response, true);

// Verificando o sucesso e a pontuação de confiança
if ($result['success'] && $result['score'] >= 0.5 && $result['action'] === 'submit') {
    echo "Verificação aprovada";
} else {
    http_response_code(403);
    echo "Verificação reprovada";
}
?>

Observações:

• Certifique-se de que, no cliente, o token seja enviado em um campo oculto do formulário com o nome recaptcha-token:

<input type="hidden" name="recaptcha-token" id="recaptcha-token">


• O limite do score pode ser ajustado de acordo com o nível de rigor desejado (por exemplo, 0,3–0,7).
• A validação de action === 'submit' aumenta a segurança, garantindo que o token foi gerado para a ação correta na página.