API CapMonster Cloud
Extension pour navigateurs
Dans cet article, nous avons essayé de répondre à toutes les questions essentielles. Pour commencer à résoudre le problème, il faut d’abord déterminer quel système de protection est utilisé. Pour cela, vous pouvez consulter la liste des captchas et systèmes de protection antibot les plus populaires, qui présente des exemples visuels et des caractéristiques clés permettant d’identifier rapidement avec quoi vous avez affaire.
Si vous constatez que votre site utilise Cloudflare Waiting Room, l’étape suivante consiste à étudier plus en détail ses propriétés et son fonctionnement. Dans cet article, vous pouvez également consulter le guide d’intégration de Cloudflare Waiting Room afin de comprendre pleinement la façon dont il fonctionne sur votre site. Cela vous permettra non seulement de mieux connaître la protection en place, mais aussi de planifier correctement sa maintenance.
Lors du test du mécanisme Waiting Room, il est important de s'assurer que la file d'attente fonctionne correctement et régule l'accès au site.
Voici comment vous pouvez le vérifier :
Pour les tests automatisés et la reconnaissance de captcha, vous pouvez utiliser des services spécialisés, comme CapMonster Cloud — un outil qui reçoit les paramètres du captcha, les traite sur ses serveurs et renvoie une solution prête à l'emploi. Cette solution (jeton ou cookie) peut être insérée dans un formulaire ou un navigateur pour passer la vérification sans intervention de l'utilisateur.
Travailler avec CapMonster Cloud via l’API comprend généralement les étapes suivantes :
Création de la tâche
Envoyer une requête APIDans la requête pour résoudre Cloudflare Waiting Room, il est nécessaire d'indiquer les paramètres suivants :
type - TurnstileTask;
websiteURL - adresse de la page où se trouve la vérification;
websiteKey - clé Cloudflare sur le site cible;
cloudflareTaskType - wait_room;
htmlPageBase64 - Page HTML au format base64 contenant le titre <title>Waiting Room powered by Cloudflare</title>;
userAgent - User-Agent du navigateur. Transmettez uniquement un UA actuel de l'OS Windows;
De plus, pour cette tâche, l'utilisation de vos propres proxies est nécessaire :
proxyType :
proxyAddress - Adresse IP du proxy IPv4/IPv6;
proxyPort - port du proxy;
proxyLogin - identifiant du serveur proxy;
proxyPassword - mot de passe du serveur 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
}
Réception du résultathttps://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"
}
}
Substitution de cf_clearanceLa solution obtenue (cookie cf_clearance) peut être installée dans le navigateur ou envoyée avec la requête HTTP, en l'indiquant dans l'en-tête Cookie: cf_clearance=
Ci-dessous se trouve un exemple de requête vers votre page avec des valeurs de cookie obtenues à l'avance. C'est utile pour les tests : vous pouvez transmettre des valeurs correctes ou intentionnellement incorrectes pour vous assurer que votre logique de traitement d'accès et de validation fonctionne correctement.
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
Exigences et préparation1. Inscrivez-vous sur Cloudflare et connectez votre site.
2. Dans la section Traffic → Waiting Room, créez une nouvelle file d'attente :
3. Cliquez sur Create Waiting Room.
Indiquez :
4. Personnalisez le design de la page d'attente :
5. Enregistrez et activez le Waiting Room.
6. Configuration des règles (Rules)
Cloudflare permet d'exclure certains trafics de la file d'attente.
Règles de contournement typiques (Bypass Rules) :
Exemple de règle de contournement de chemin dans le DashboardConfigurez :
Toutes les règles de contournement permettent d'exclure le trafic du décompte des utilisateurs actifs, afin qu'il n'affecte pas la file d'attente.
Fonctionnalités avancées :
Gestion via API :
L'API Cloudflare Waiting Room permet :
Exemple de création d'une règle de contournement via l'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
}Vérification du fonctionnement
1) Ouvrez le site depuis différents navigateurs/appareils.
2) Vérifiez :
Si vous avez récupéré un site avec un captcha ou un autre système de protection déjà installé, mais sans accès au code, pas de panique ! Il est assez simple d’identifier quelle technologie est utilisée. Pour vérifier que tout fonctionne correctement, vous pouvez utiliser le service de reconnaissance CapMonster Cloud dans un environnement de test isolé, afin de vous assurer que le mécanisme de traitement des jetons et la logique de vérification fonctionnent correctement.
Dans le cas de Cloudflare Waiting Room, il suffit d’identifier le système, d’étudier son comportement et de vérifier que la protection fonctionne correctement. Dans cet article, nous avons montré comment reconnaître Cloudflare Waiting Room et où trouver les instructions pour son intégration ou sa reconfiguration, afin de maintenir la protection en toute confiance et de garder son fonctionnement sous contrôle.
