CapMonster Cloud API
Estensione per browser
In questo articolo abbiamo cercato di rispondere a tutte le domande principali. Il primo passo per risolvere il problema è capire quale sistema di protezione viene utilizzato. A questo scopo puoi consultare l’elenco dei captcha e dei sistemi di protezione antibot più diffusi, dove trovi esempi visivi e caratteristiche chiave che ti aiutano a identificare rapidamente con cosa hai a che fare.
Se scopri che sul tuo sito viene utilizzato Cloudflare Waiting Room, il passo successivo è analizzarne più nel dettaglio le proprietà e il funzionamento. In questo stesso articolo puoi anche studiare la guida all’integrazione di Cloudflare Waiting Room, per comprendere a fondo come opera sul tuo sito. Questo ti permetterà non solo di capire la protezione attuale, ma anche di pianificarne correttamente la manutenzione.
Durante il test del meccanismo Waiting Room, è importante assicurarsi che la coda funzioni correttamente e regoli l'accesso al sito.
Ecco come puoi verificarlo:
Per i test automatizzati e il riconoscimento dei captcha, è possibile utilizzare servizi specializzati, come CapMonster Cloud, uno strumento che riceve i parametri del captcha, li elabora sui propri server e restituisce una soluzione pronta. Questa soluzione (token o cookie) può essere inserita in un modulo o nel browser per superare la verifica senza l'intervento dell'utente.
Lavorare con CapMonster Cloud via API di solito prevede i seguenti passaggi:
Creazione della task
Invio della richiesta APINella richiesta per risolvere Cloudflare Waiting Room è necessario specificare i seguenti parametri:
type - TurnstileTask;
websiteURL - indirizzo della pagina su cui si trova la verifica;
websiteKey - chiave Cloudflare sul sito di destinazione;
cloudflareTaskType - wait_room;
htmlPageBase64 - Pagina HTML in formato base64 contenente il titolo <title>Waiting Room powered by Cloudflare</title>;
userAgent - User-Agent del browser. Inviare solo uno UA attuale del sistema operativo Windows;
Inoltre, per questo compito è necessario utilizzare i propri proxy:
proxyType :
proxyAddress - Indirizzo IP del proxy IPv4/IPv6;
proxyPort - porta del proxy;
proxyLogin - login del server proxy;
proxyPassword - password del server 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
}
Ricezione del risultatohttps://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"
}
}
Sostituzione di cf_clearanceLa soluzione ottenuta (cookie cf_clearance) può essere impostata nel browser o inviata insieme alla richiesta HTTP, specificandola nell'intestazione Cookie: cf_clearance=
Di seguito è riportato un esempio di richiesta alla tua pagina con valori di cookie ottenuti in anticipo. Questo è utile per i test: è possibile trasmettere sia valori corretti che intenzionalmente errati per assicurarsi che la logica di elaborazione dell'accesso e di convalida funzioni correttamente.
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
Requisiti e preparazione1. Registrati su Cloudflare e collega il tuo sito.
2. Nella sezione Traffic → Waiting Room, crea una nuova coda:
3. Clicca su Create Waiting Room.
Indica:
4. Personalizza il design della pagina di attesa:
5. Salva e attiva la Waiting Room.
6. Configurazione delle regole (Rules)
Cloudflare consente di escludere determinato traffico dalla coda.
Regole di bypass tipiche (Bypass Rules):
Esempio di regola di bypass del percorso nella DashboardConfigura:
Tutte le regole di bypass consentono di escludere il traffico dal conteggio degli utenti attivi, in modo che non influenzi la coda.
Funzionalità avanzate:
Gestione tramite API:
L'API Cloudflare Waiting Room consente di:
Esempio di creazione di una regola di bypass tramite 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
}Verifica del funzionamento
1) Apri il sito da diversi browser/dispositivi.
2) Verifica:
Se ti è capitato un sito con un captcha o un altro sistema di protezione già installato e senza accesso al codice, nessun problema! È piuttosto facile capire quale tecnologia viene utilizzata. Per verificare che tutto funzioni correttamente, puoi usare il servizio di riconoscimento CapMonster Cloud in un ambiente di test isolato, così da assicurarti che il meccanismo di elaborazione dei token e la logica di verifica funzionino correttamente.
Nel caso di Cloudflare Waiting Room, è sufficiente individuare il sistema, analizzarne il comportamento e assicurarsi che la protezione funzioni correttamente. Nell’articolo abbiamo mostrato come riconoscere Cloudflare Waiting Room e dove trovare le istruzioni per la sua integrazione o riconfigurazione, in modo da poter mantenere la protezione in modo affidabile e controllarne il funzionamento.
