CapMonster Cloud API
Extensie voor browsers
In dit artikel hebben we geprobeerd antwoord te geven op alle belangrijke vragen. De eerste stap bij het oplossen van het vraagstuk is vaststellen welk beveiligingssysteem wordt gebruikt. Daarvoor kun je de lijst met populaire captcha’s en anti-botbeveiligingssystemen raadplegen, met visuele voorbeelden en kernkenmerken die je helpen snel te bepalen waarmee je te maken hebt.
Als je ontdekt dat je website Cloudflare Waiting Room gebruikt, is de volgende stap om de eigenschappen en werking ervan uitgebreider te bestuderen. In dit artikel vind je ook een handleiding voor het integreren van Cloudflare Waiting Room, zodat je volledig begrijpt hoe het systeem op je website werkt. Zo kun je niet alleen de huidige bescherming beter doorgronden, maar ook het onderhoud ervan goed plannen.
Bij het testen van het Waiting Room-mechanisme is het belangrijk om ervoor te zorgen dat de wachtrij correct werkt en de toegang tot de site reguleert.
Zo kunt u dit controleren:
Voor geautomatiseerd testen en captcha-herkenning kunt u gespecialiseerde diensten gebruiken, bijvoorbeeld CapMonster Cloud — een tool die captcha-parameters accepteert, deze op zijn servers verwerkt en een kant-en-klare oplossing retourneert. Deze oplossing (token of cookie) kan in een formulier of browser worden geplaatst om de controle zonder tussenkomst van de gebruiker te doorstaan.
Werken met CapMonster Cloud via de API bestaat doorgaans uit de volgende stappen:
Taak aanmaken
API-aanvraag versturenIn het verzoek om Cloudflare Waiting Room op te lossen, moeten de volgende parameters worden opgegeven:
type - TurnstileTask;
websiteURL - URL van de pagina waarop de controle zich bevindt;
websiteKey - Cloudflare-sleutel op de doelsite;
cloudflareTaskType - wait_room;
htmlPageBase64 - HTML-pagina in base64-formaat die de titel <title>Waiting Room powered by Cloudflare</title> bevat;
userAgent - User-Agent van de browser. Geef alleen een actuele UA van Windows OS door;
Ook is het voor deze taak noodzakelijk om uw eigen proxy's te gebruiken:
proxyType :
proxyAddress - IP-adres van de proxy IPv4/IPv6;
proxyPort - poort van de proxy;
proxyLogin - login van de proxyserver;
proxyPassword - wachtwoord van de proxyserver.
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/143.0.0.0 Safari/537.36",
"proxyType":"http",
"proxyAddress":"8.8.8.8",
"proxyPort":8080,
"proxyLogin":"proxyLoginHere",
"proxyPassword":"proxyPasswordHere"
}
}{
"errorId":0,
"taskId":407533072
}
Resultaat ontvangenhttps://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"
}
}
cf_clearance vervangingDe verkregen oplossing (cookie cf_clearance) kan in de browser worden ingesteld of samen met het HTTP-verzoek worden verzonden door deze in de header Cookie: cf_clearance=
Hieronder staat een voorbeeld van een verzoek aan uw pagina met vooraf verkregen cookie-waarden. Dit is handig voor het testen: u kunt zowel correcte als opzettelijk onjuiste waarden doorgeven om er zeker van te zijn dat uw logica voor toegangsverwerking en validatie correct werkt.
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/143.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
Vereisten en voorbereiding1. Registreer u bij Cloudflare en koppel uw site.
2. Maak in de sectie Traffic → Waiting Room een nieuwe wachtrij aan:
3. Klik op Create Waiting Room.
Geef het volgende op:
4. Pas het ontwerp van de wachtpagina aan:
5. Sla op en activeer de Waiting Room.
6. Configuratie van regels (Rules)
Cloudflare maakt het mogelijk om bepaald verkeer uit te sluiten van de wachtrij.
Typische omzeilingsregels (Bypass Rules):
Voorbeeld van een regel voor het omzeilen van een pad in het DashboardConfigureer:
Alle omzeilingsregels maken het mogelijk om verkeer uit te sluiten van de telling van actieve gebruikers, zodat het de wachtrij niet beïnvloedt.
Geavanceerde mogelijkheden:
Beheer via API:
De Cloudflare Waiting Room API maakt het mogelijk om:
Voorbeeld van het maken van een omzeilingsregel via de 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
}Controle van de werking
1) Open de site via verschillende browsers/apparaten.
2) Controleer:
Als je een website in beheer krijgt waarop al een captcha of een ander beveiligingssysteem is geïnstalleerd en je geen toegang hebt tot de code, is dat geen probleem! Het is vrij eenvoudig te bepalen welke technologie precies wordt gebruikt. Voor het controleren of alles correct werkt, kun je de herkenningsservice CapMonster Cloud in een geïsoleerde testomgeving gebruiken, zodat je zeker weet dat het tokenverwerkingsmechanisme en de validatielogica correct functioneren.
In het geval van Cloudflare Waiting Room is het voldoende om het systeem te herkennen, het gedrag te analyseren en te bevestigen dat de beveiliging correct werkt. In het artikel hebben we laten zien hoe je Cloudflare Waiting Room kunt herkennen en waar je instructies vindt om het te koppelen of opnieuw te configureren, zodat je de bescherming met vertrouwen kunt onderhouden en de werking onder controle kunt houden.
