Solucionador de reCAPTCHA Enterprise | CapMonster Cloud

reCAPTCHA v2 Enterprise
y CapMonster Cloud

Resolución de captchas, integración en el sitio y pruebas end-to-end.

Precios de la solución reCAPTCHA v2 Enterprise

CAPTCHA

Precio

Éxito de la resolución

reCAPTCHA v2 Enterprise

97%

$ 1.00

1k tokens

97%

¿Heredaste un sitio con una captcha u otra capa de protección pero sin acceso al código fuente? Entonces es normal preguntarse: ¿qué solución está instalada, está configurada correctamente y cómo se puede probar?

En este artículo hemos intentado responder a todas las preguntas clave. Para empezar a resolver la tarea, primero hay que determinar qué sistema de protección se está utilizando. Para ello, puedes consultar la lista de captchas y sistemas de protección antibot más populares, donde se muestran ejemplos visuales y señales clave que te ayudarán a identificar rápidamente con qué estás tratando.

Si descubres que tu sitio web utiliza reCAPTCHA v2 Enterprise, el siguiente paso será analizar con más detalle sus propiedades y su funcionamiento. En este mismo artículo también puedes consultar la guía de integración de reCAPTCHA v2 Enterprise para comprender por completo cómo funciona en tu sitio. Esto te permitirá no solo entender la protección actual, sino también planificar correctamente su mantenimiento.

Qué es Google reCAPTCHA v2 Enterprise

reCAPTCHA v2 Enterprise es la versión corporativa del sistema estándar de Google para detener el spam y los ataques automatizados. Detecta con mayor precisión si en la página hay una persona o un bot y utiliza la API de Google Cloud para validar los tokens. A simple vista luce igual que la v2 tradicional con checkbox y retos de imágenes, pero carga https://www.google.com/recaptcha/enterprise.js para ofrecer mayor seguridad.

Cómo resolver reCAPTCHA v2 Enterprise con CapMonster Cloud

Al probar formularios que incluyen reCAPTCHA v2 Enterprise, normalmente debes verificar que la captcha funcione y esté integrada correctamente.

Puedes comprobar manualmente la captcha incrustada en tu sitio.

Abre la página del formulario y verifica que la captcha se renderice.
Intenta enviar el formulario sin resolverla: el servidor debe devolver un error.
Tras una solución correcta, el formulario debe enviarse sin inconvenientes.

Para la resolución automática puedes usar herramientas como CapMonster Cloud, que reciben los parámetros de la captcha, los procesan en sus servidores y devuelven un token listo para usar. Inserta ese token en el formulario para pasar la verificación sin interacción del usuario.

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

Creación de la tarea

En este paso envías tu clave API, el tipo de captcha y los parámetros. El servicio devuelve un taskId único para consultar después el resultado.

Enviar una solicitud API

Tu solicitud para resolver reCAPTCHA v2 Enterprise debe incluir:

type - RecaptchaV2EnterpriseTask;

websiteURL - la URL donde aparece la captcha;

websiteKey - el sitekey mostrado en esa página;

enterprisePayload - envíalo si tu widget reCAPTCHA Enterprise añade un campo s al objeto que se pasa a grecaptcha.enterprise.render junto con el sitekey;

pageAction - el valor action que el widget envía a Google. Valor por defecto: verify.

Consulta más detalles sobre los parámetros y cómo recopilarlos automáticamente antes de enviar una tarea en la documentación de CapMonster Cloud.

Resolve reCAPTCHA v2 Enterprise con bibliotecas listas

CapMonster Cloud ofrece SDK para Python, JavaScript (Node.js) y C# para una integración rápida.

Python

JavaScript

Cómo conectar reCAPTCHA v2 Enterprise a tu sitio

Para entender cómo funciona el captcha en tu sitio, cómo se comporta la validación y cómo volver a conectarlo o reconfigurarlo, revisa esta sección. Aquí se explica toda la configuración de protección para que puedas cubrir cada detalle rápidamente.

Como reCAPTCHA Enterprise se ejecuta en Google Cloud, primero debes crear un proyecto en su consola:

1. Ve a la Google Cloud Console.

2. En el menú superior elige un proyecto existente o haz clic en Nuevo proyecto.

3. Introduce un nombre de proyecto, especifica tu organización y confirma la creación.

HowTo Connect image 1

4. Abre la página de la API: reCAPTCHA Enterprise API y haz clic en Habilitar.

5. Ve a Crear clave en la consola y haz clic en Crear clave.

HowTo Connect image 2

6. Configura los ajustes básicos:

Nombre para mostrar: cualquier etiqueta que te ayude a identificar la clave (por ejemplo, MySite Login Page).
Tipo de aplicación: elige WEB (sitios) o Aplicación móvil. No podrás cambiar esto después.
Lista de dominios: añade los dominios donde se usará esta clave.

Luego abre Configuración adicional, activa ¿Vas a usar desafíos? y habilita Checkbox Challenge.

HowTo Connect image 3

7. Haz clic en Crear. Recibirás una clave que debes añadir a tu sitio para activar la protección.

HowTo Connect image 3

8. Añade el script a tu página.

Fragmento de HTML de ejemplo que puedes incrustar en tu sitio

Posibles errores y depuración

Sitio o clave inválidos

La captcha no carga o devuelve invalid-input-secret.

Tiempo límite excedido

El servidor no recibió la respuesta a tiempo. Aumenta el tiempo de espera.

Token vacío

Ocurrió un error al pasar el resultado a la página.

Response success=false

El token ha caducado, se reutilizó o fue manipulado. Activa el registro de solicitudes y revisa el campo error-codes en la respuesta de Google.

Pruebas de resistencia de la protección

Después de la integración, asegúrate de que el sistema realmente proteja el sitio contra acciones automatizadas.

Intente enviar una petición sin resolver el captcha: el servidor debería devolver success: false.

Realice una prueba de carga (por ejemplo, con k6 o JMeter) a una velocidad superior a 100 solicitudes por segundo: el captcha debe mostrarse correctamente y el sistema de validación debe seguir siendo estable.

Compruebe la respuesta del servidor con un token caducado o reenviado: la respuesta esperada debe ser 403 Forbidden.

Consejos de seguridad y optimización

Guarde la <span class="font-bold">Secret Key</span> solo en el servidor; no la exponga en la parte del cliente.

Guarde la Secret Key solo en el servidor; no la exponga en la parte del cliente.

Registre los códigos de error <span class="font-bold">(error-codes)</span> para entender por qué han fallado comprobaciones concretas.

Registre los códigos de error (error-codes) para entender por qué han fallado comprobaciones concretas.

Añada en la parte inferior del formulario enlaces a la <span class="font-bold">Política de privacidad</span> y a los <span class="font-bold">Términos de uso de Google</span>, tal y como exige la licencia.

Añada en la parte inferior del formulario enlaces a la Política de privacidad y a los Términos de uso de Google, tal y como exige la licencia.

Captchas compatibles

reCAPTCHA v2

reCAPTCHA v3

reCAPTCHA v2 Enterprise

reCAPTCHA v3 Enterprise

GeeTest

Cloudflare Turnstile

Cloudflare Bot Challenge

DataDome

Tencent CAPTCHA

Conclusión

Si has heredado un sitio web que ya tiene un captcha u otro sistema de protección instalado y no tienes acceso al código, no pasa nada. Identificar qué tecnología se está utilizando es bastante sencillo. Para comprobar que todo funciona correctamente, puedes usar el servicio de reconocimiento CapMonster Cloud en un entorno de pruebas aislado, para asegurarte de que el mecanismo de procesamiento de tokens y la lógica de verificación funcionan correctamente.

En el caso de reCAPTCHA v2 Enterprise, basta con detectar el sistema, analizar su comportamiento y confirmar que la protección funciona correctamente. En el artículo hemos mostrado cómo identificar reCAPTCHA v2 Enterprise y dónde encontrar las instrucciones para su integración o reconfiguración, de modo que puedas mantener la protección con confianza y controlar su funcionamiento.

Enlaces útiles

Crea un proyecto y conoce más sobre reCAPTCHA v2 Enterprise →

Documentación de CapMonster Cloud (reCAPTCHA v2 Enterprise) →

Cómo resolver reCAPTCHA Enterprise con CapMonster Cloud: guía paso a paso →

La extensión de navegador de CapMonster Cloud está disponible para Chrome y Firefox. La guía completa de instalación y uso está disponible aquí.

{
  "clientKey": "API_KEY",
  "task": {
    "type": "RecaptchaV2EnterpriseTask",
    "websiteURL": "https://mydomain.com/page-with-recaptcha-enterprise",
    "websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
    "pageAction": "verify",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN"
    }
  }
}

Recepción del resultado

Tras crear la tarea, consulta periódicamente el estado de la solución.

Dirección para recibir el resultado:

https://api.capmonster.cloud/getTaskResult

Ejemplo de solicitud:

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

Respuesta:

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AFcWeA66ZARdA5te7acD9vSwWE2hEQ2-B2aqFxm455iMA-g-Jis..."
  }
}

Resolver, insertar el token y enviar el formulario

Ejemplo en Node.js que cubre todo el ciclo de resolución en tu página. Puedes usar solicitudes HTTP para obtener el HTML y los parámetros de la captcha, enviar la respuesta y procesar el resultado; o recurrir a herramientas de automatización (por ejemplo, Playwright) para abrir la página, esperar la captcha, enviar parámetros (válidos o de prueba), recibir el resultado con el cliente de CapMonster Cloud, insertar el token en el formulario y observar el resultado.

import { chromium } from 'playwright';
import { CapMonsterCloudClientFactory, ClientOptions, RecaptchaV2EnterpriseRequest } from '@zennolab_com/capmonstercloud-client';

(async () => {
  const browser = await chromium.launch({ headless: false });
  const context = await browser.newContext();
  const page = await context.newPage();

  // 2. Abre la página con la captcha
  await page.goto('https://example.com');

  // 3. Crea el cliente de CapMonster Cloud
  const cmcClient = CapMonsterCloudClientFactory.Create(
    new ClientOptions({ clientKey: '<your_capmonster_cloud_api_key>' })
  );

  // 4. Configura la petición que resuelve la captcha
  const recaptchaRequest = new RecaptchaV2EnterpriseRequest({
    websiteURL: page.url(),
    websiteKey: '6Lf76sUnAAAAAIKLuWNyegRsFUfmI-3Lex3xT5N'
    // enterprisePayload: { s: 'SOME_ADDITIONAL_TOKEN' } // Parámetro enterprise opcional
  });

  // 5. Resuelve la captcha con CapMonster
  const solution = await cmcClient.Solve(recaptchaRequest);
  const token = solution.solution.gRecaptchaResponse;
  console.log('Token del captcha:', token);

  // 6. Inserta el token en un campo oculto
  await page.evaluate((t) => {
    const el = document.getElementById('g-recaptcha-response');
    if (el) el.value = t;
  }, token);

  // 7. (Opcional) Envía el formulario — sustituye por el selector adecuado
  await page.click('button[data-action="submit"]');

  await page.waitForTimeout(5000);
  await browser.close();
})();

También puedes probar el reconocimiento con la extensión de navegador CapMonster Cloud, que verifica la captcha directamente en la página y muestra el proceso en tiempo real sin escribir código. Disponible para Chrome y Firefox.

<html>
  <head>
    <title>reCAPTCHA demo: Simple page</title>
    <script src="https://www.google.com/recaptcha/enterprise.js" async defer></script>
  </head>
  <body>
    <form action="" method="POST">
      <div class="g-recaptcha" data-sitekey="YOUR_SITEKEY" data-action="LOGIN"></div>
      <br/>
      <input type="submit" value="Submit">
    </form>
  </body>
</html>

Ejemplo en PHP

El token (g-recaptcha-response) se envía al backend.
Es válido durante 2 minutos, ¡así que verifícalo en cuanto lo recibas! Para una comunicación segura con la API recomendamos las bibliotecas oficiales de Google Cloud:

<?php
require 'vendor/autoload.php';

// Instala las bibliotecas de Google Cloud mediante Composer
use Google/Cloud/RecaptchaEnterprise/V1/RecaptchaEnterpriseServiceClient;
use Google/Cloud/RecaptchaEnterprise/V1/Event;
use Google/Cloud/RecaptchaEnterprise/V1/Assessment;
use Google/Cloud/RecaptchaEnterprise/V1/CreateAssessmentRequest;
use Google/Cloud/RecaptchaEnterprise/V1/TokenProperties/InvalidReason;

/**
 * Valida el token de reCAPTCHA Enterprise y obtén la puntuación de riesgo.
 *
 * @param string $recaptchaKey Clave de reCAPTCHA de tu sitio/app
 * @param string $token Token recibido desde el cliente
 * @param string $projectId ID del proyecto de Google Cloud
 * @param string $action Nombre de la acción asociado al token
 */
function create_assessment(string $recaptchaKey, string $token, string $projectId, string $action): void {
    $client = new RecaptchaEnterpriseServiceClient();
    $projectName = $client->projectName($projectId);

    // Crea el evento de evaluación (assessment)
    $event = (new Event())->setSiteKey($recaptchaKey)->setToken($token);
    $assessment = (new Assessment())->setEvent($event);
    $request = (new CreateAssessmentRequest())->setParent($projectName)->setAssessment($assessment);

    try {
        $response = $client->createAssessment($request);

        if (!$response->getTokenProperties()->getValid()) {
            echo 'El token no es válido: ' . InvalidReason::name($response->getTokenProperties()->getInvalidReason());
            return;
        }

        if ($response->getTokenProperties()->getAction() === $action) {
            echo 'Puntuación de riesgo: ' . $response->getRiskAnalysis()->getScore();
        } else {
            echo 'La acción en la etiqueta reCAPTCHA no coincide con el valor esperado';
        }
    } catch (Exception $e) {
        echo 'Error al comprobar reCAPTCHA: ' . $e->getMessage();
    }
}

// Llama a la función con las variables
create_assessment(
    'YOUR_SITE_KEY',
    'YOUR_USER_RESPONSE_TOKEN',
    'YOUR_PROJECT_ID',
    'YOUR_RECAPTCHA_ACTION'
);
?>

reCAPTCHA v2 Enterprise y CapMonster Cloud

Precios de la solución reCAPTCHA v2 Enterprise

Cómo resolver reCAPTCHA v2 Enterprise con CapMonster Cloud

Captchas compatibles

reCAPTCHA v2 Enterprise
y CapMonster Cloud