CapMonster Cloud API
Extensión para navegadores
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 Cloudflare Waiting Room, 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 Cloudflare Waiting Room 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.
Al probar el mecanismo de Waiting Room, es importante asegurarse de que la cola funcione correctamente y regule el acceso al sitio.
Así es como puede comprobarlo:
Para pruebas automatizadas y reconocimiento de captchas, puede utilizar servicios especializados, como CapMonster Cloud, una herramienta que recibe los parámetros del captcha, los procesa en sus servidores y devuelve una solución lista. Esta solución (token o cookie) se puede insertar en un formulario o navegador para pasar la verificación sin la participación del usuario.
Trabajar con CapMonster Cloud mediante la API suele implicar los siguientes pasos:
Creación de la tarea
Enviar una solicitud APIEn la solicitud para resolver Cloudflare Waiting Room es necesario indicar los siguientes parámetros:
type - TurnstileTask;
websiteURL - dirección de la página donde se encuentra la verificación;
websiteKey - clave de Cloudflare en el sitio de destino;
cloudflareTaskType - wait_room;
htmlPageBase64 - Página HTML en formato base64 que contiene el título <title>Waiting Room powered by Cloudflare</title>;
userAgent - User-Agent del navegador. Envíe solo un UA actual del sistema operativo Windows;
Además, para esta tarea es necesario el uso de sus propios proxies:
proxyType :
proxyAddress - Dirección IP del proxy IPv4/IPv6;
proxyPort - puerto del proxy;
proxyLogin - usuario del servidor proxy;
proxyPassword - contraseña del servidor proxy.
https://api.capmonster.cloud/createTask{
"clientKey":"API_KEY",
"task": {
"type":"TurnstileTask",
"websiteURL":"https://example.com",
"websiteKey":"xxxxxxxxxx",
"cloudflareTaskType": "wait_room",
"htmlPageBase64": "PCFET0NUWVBFIGh0...vYm9keT48L2h0bWw+",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36",
"proxyType":"http",
"proxyAddress":"8.8.8.8",
"proxyPort":8080,
"proxyLogin":"proxyLoginHere",
"proxyPassword":"proxyPasswordHere"
}
}{
"errorId":0,
"taskId":407533072
}
Recepción del resultadohttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}{
"errorId": 0,
"status": "ready",
"solution": {
"cf_clearance": "1tarGvbY2_ZhQdYxpSBloao.FoOn9VtcJtmb_IQ_hCE-1761217338-1.2.1.1-vyVPoLYIGX0VCJomVuLjF7n0kdM0PXaPjpDsRcohxGr7hb2CE7WfcHpmQZ70goqEjdWxPsDhSVaKNTz9opxWguiNdWEEq_.SceWXIqfP7tnEb69f3bP0mixNqcWy_5P_9INpoAEqr1k7aYU0r45PT4gPr5pwHxedVySyLRdoBXIJasdTE52YOQ3NPdGWTwQ_3h2n_wYqqIvf0kCSAvimRrmsgZxomlyejwqPI6ZHi.w"
}
}
Sustitución de cf_clearanceLa solución obtenida (cookie cf_clearance) se puede establecer en el navegador o enviarse junto con la solicitud HTTP, indicándola en el encabezado Cookie: cf_clearance=
A continuación se muestra un ejemplo de solicitud a su página con valores de cookie obtenidos previamente. Esto es útil para pruebas: puede enviar tanto valores correctos como intencionalmente incorrectos para asegurarse de que su lógica de procesamiento de acceso y validación funcione correctamente.
GET https://example.com/
sec-ch-ua: "Google Chrome";v="141", "Not?A_Brand";v="8", "Chromium";v="141"
sec-ch-ua-mobile: ?0
sec-ch-ua-platform: "Windows"
upgrade-insecure-requests: 1
user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36
accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7
sec-fetch-site: same-origin
sec-fetch-mode: navigate
sec-fetch-user: ?1
sec-fetch-dest: document
accept-encoding: gzip, deflate, br
accept-language: en-US
cookie: cf_clearance=Jf0udVxx.pxJMEHnish22ZOFt4WZEh8iLKm62gIxQAw-1760087570-1.2.1.1-IAO44jrcaDIU6v3f01Q6MpH58vo521.cgZg9OG5ASav.EIf9fmqH2yETyPkmm7dExFNlRL.dYv6xA4iPtlwMepInUaeFinDbYtoMstD_9Vyexx2B2K.r4eJb9zMCQc0XA3yYDHViOC7cYBYHi58FbvycjBe4o236lyz2eoyC48IS.K1zSsVdqBqIoXIT4tEFYdibXdWudtp57lmyjwpryZy..fGFAcFjAGn3iho98_4
sec-ch-ua-arch: "x86"
sec-ch-ua-bitness: "64"
sec-ch-ua-full-version: "141.0.7390.55"
sec-ch-ua-platform-version: "19.0.0"
sec-ch-ua-model: ""
sec-ch-ua-full-version-list: "Google Chrome";v="141.0.7390.55", "Not?A_Brand";v="8.0.0.0", "Chromium";v="141.0.7390.55"
Origin: https://example.com
Upgrade-Insecure-Requests: 1
Requisitos y preparación1. Regístrese en Cloudflare y conecte su sitio.
2. En la sección Traffic → Waiting Room, cree una nueva cola:
3. Haga clic en Create Waiting Room.
Indique:
4. Configure el diseño de la página de espera:
5. Guarde y active el Waiting Room.
6. Configuración de reglas (Rules)
Cloudflare permite excluir cierto tráfico de la cola.
Reglas de omisión típicas (Bypass Rules):
Ejemplo de regla de omisión de ruta en el DashboardConfigure:
Todas las reglas de omisión permiten excluir el tráfico del conteo de usuarios activos, para que no afecte a la cola.
Capacidades avanzadas:
Gestión a través de API:
La API de Cloudflare Waiting Room permite:
Ejemplo de creación de regla de omisión a través de la APIPOST zones/{zone_id}/waiting_rooms/{room_id}/rules
Content-Type: application/json
Authorization: Bearer <API_TOKEN>
{
"description": "Bypass admins",
"expression": "ip.src in { '1.2.3.4', '5.6.7.8' }",
"action": "bypass_waiting_room",
"enabled": true
}Verificación del funcionamiento
1) Abra el sitio desde diferentes navegadores/dispositivos.
2) Verifique:
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 Cloudflare Waiting Room, 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 Cloudflare Waiting Room 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.
