reCAPTCHA v3
y CapMonster Cloud

Trabajar con CapMonster Cloud mediante la API suele implicar los siguientes pasos:

1. Ve a la página del panel de administración de reCAPTCHA.

2. Registra un nuevo sitio y elige como tipo de captcha — reCAPTCHA v3

3. Obtén las dos claves:

• Site key — clave pública (se usa en el frontend);
• Secret key — clave privada (se usa en el servidor para la verificación)

Puedes abrir la configuración donde, por ejemplo, puedes indicar dominios adicionales en los que usar reCAPTCHA o configurar avisos sobre problemas en el sitio o incrementos de tráfico sospechoso.

4. Ejemplos de código para la parte cliente

La forma más sencilla de usar reCAPTCHA v3 es incluir la API de JavaScript y añadir atributos al botón.

Inclusión de la API:

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

Función de callback para el formulario:

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

Botón con atributos de reCAPTCHA:

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

Para un control completo, utiliza grecaptcha.execute con el parámetro render:

Inclusión de la API con la clave:

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

Llamada mediante código:

<script>
  function onClick(e) {
    e.preventDefault();
    grecaptcha.ready(function() {
      grecaptcha.execute('reCAPTCHA_sitekey', {action: 'submit'}).then(function(token) {
          // Envía el token al servidor para su verificación
      });
    });
  }
</script>

El token debe enviarse inmediatamente al servidor para su verificación.

Notas importantes:

• Validez del token: el token recibido de reCAPTCHA v3 es válido durante 2 minutos. Asegúrate de enviarlo al servidor dentro de ese tiempo.
• Verificación en el servidor: después de recibir el token en el servidor, envía una petición POST a https://www.google.com/recaptcha/api/siteverify con los parámetros:
  – secret: tu clave secreta
  – response: el token recibido del cliente
  – remoteip (opcional): la dirección IP del usuario
• El servidor de Google responderá con un JSON que contiene información sobre el resultado de la verificación.

Puedes encontrar información más detallada en la documentación oficial del propio captcha.

5. Ahora realiza la verificación de la respuesta en el servidor

Ejemplo en PHP

<?php
// Tu clave secreta (Secret Key) de reCAPTCHA v3
$secret = 'YOUR_SECRET_KEY';

// Obtener el token desde el formulario
$token = $_POST['recaptcha-token'] ?? '';

// Enviar una solicitud a Google para verificar el token
$response = file_get_contents(
    "https://www.google.com/recaptcha/api/siteverify?secret={$secret}&response={$token}"
);

$result = json_decode($response, true);

// Comprobar si la verificación ha tenido éxito y el score de confianza
if ($result['success'] && $result['score'] >= 0.5 && $result['action'] === 'submit') {
    echo "Verificación correcta";
} else {
    http_response_code(403);
    echo "Verificación fallida";
}
?>

Notas:

• Asegúrate de que en el cliente el token se envía en un campo oculto del formulario llamado recaptcha-token:

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


• El umbral de score puede ajustarse según el nivel de estrictitud deseado (por ejemplo, 0.3–0.7).
• Comprobar que action === 'submit' aumenta la seguridad y garantiza que el token se ha emitido para la acción concreta en la página.