CapMonster Cloud API
Rozszerzenie do przeglądarek
W tym artykule staraliśmy się odpowiedzieć na wszystkie najważniejsze pytania. Pierwszym krokiem w rozwiązywaniu problemu jest ustalenie, jaki system ochrony jest używany. W tym celu możesz skorzystać z listy popularnych captcha i systemów ochrony antybotowej, gdzie znajdziesz przykłady graficzne oraz kluczowe cechy, które pomogą szybko rozpoznać, z czym masz do czynienia.
Jeśli okaże się, że na Twojej stronie używany jest Cloudflare Waiting Room, kolejnym krokiem będzie dokładniejsze poznanie jej właściwości i sposobu działania. W tym artykule możesz również zapoznać się z instrukcją integracji systemu Cloudflare Waiting Room, aby w pełni zrozumieć, jak funkcjonuje on na Twojej stronie. Dzięki temu nie tylko lepiej poznasz obecną ochronę, ale też świadomie zaplanujesz jej dalsze utrzymanie.
Podczas testowania mechanizmu Waiting Room ważne jest upewnienie się, że kolejka działa poprawnie i reguluje dostęp do strony.
Oto jak można to sprawdzić:
Do automatycznych testów i rozpoznawania captcha można użyć wyspecjalizowanych usług, na przykład CapMonster Cloud — narzędzia, które przyjmuje parametry captcha, przetwarza je na swoich serwerach i zwraca gotowe rozwiązanie. To rozwiązanie (token lub plik cookie) można podstawić do formularza lub przeglądarki, aby przejść weryfikację bez udziału użytkownika.
Praca z CapMonster Cloud poprzez API zazwyczaj obejmuje następujące kroki:
Tworzenie zadania
Wysyłanie żądania APIW zapytaniu o rozwiązanie Cloudflare Waiting Room należy podać następujące parametry:
type - TurnstileTask;
websiteURL - adres strony, na której znajduje się weryfikacja;
websiteKey - klucz Cloudflare na stronie docelowej;
cloudflareTaskType - wait_room;
htmlPageBase64 - Strona HTML w formacie base64, zawierająca nagłówek <title>Waiting Room powered by Cloudflare</title>;
userAgent - User-Agent przeglądarki. Przesyłaj tylko aktualny UA z systemu Windows;
Również do tego zadania konieczne jest użycie własnych serwerów proxy:
proxyType :
proxyAddress - Adres IP proxy IPv4/IPv6;
proxyPort - port proxy;
proxyLogin - login serwera proxy;
proxyPassword - hasło serwera 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
}
Odebranie wynikuhttps://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"
}
}
Podstawienie cf_clearanceOtrzymane rozwiązanie (cookie cf_clearance) można ustawić w przeglądarce lub wysłać wraz z zapytaniem HTTP, podając je w nagłówku Cookie: cf_clearance=
Poniżej znajduje się przykładowe zapytanie do Twojej strony z wartościami cookie uzyskanymi wcześniej. Jest to wygodne do testowania: można przesyłać zarówno poprawne, jak i celowo błędne wartości, aby upewnić się, że Twoja logika przetwarzania dostępu i walidacji działa poprawnie.
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
Wymagania i przygotowanie1. Zarejestruj się w Cloudflare i podłącz swoją stronę.
2. W sekcji Traffic → Waiting Room utwórz nową kolejkę:
3. Kliknij Create Waiting Room.
Podaj:
4. Skonfiguruj wygląd strony oczekiwania:
5. Zapisz i aktywuj Waiting Room.
6. Konfiguracja reguł (Rules)
Cloudflare pozwala wykluczyć określony ruch z kolejki.
Typowe reguły obejścia (Bypass Rules):
Przykład reguły obejścia ścieżki w DashboardzieSkonfiguruj:
Wszystkie reguły obejścia pozwalają wykluczyć ruch z liczby aktywnych użytkowników, aby nie wpływał on na kolejkę.
Zaawansowane możliwości:
Zarządzanie przez API:
Cloudflare Waiting Room API pozwala:
Przykład tworzenia reguły obejścia przez 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
}Weryfikacja działania
1) Otwórz stronę z różnych przeglądarek/urządzeń.
2) Sprawdź:
Jeśli przejąłeś stronę internetową, na której jest już zainstalowany captcha lub inny system zabezpieczeń, a jednocześnie nie masz dostępu do kodu — to nic strasznego! Dość łatwo jest ustalić, jaka dokładnie technologia jest używana. Aby sprawdzić poprawność działania, możesz skorzystać z usługi rozpoznawania CapMonster Cloud w odizolowanym środowisku testowym, żeby upewnić się, że mechanizm przetwarzania tokenów i logika weryfikacji działają prawidłowo.
W przypadku Cloudflare Waiting Room wystarczy rozpoznać system, przeanalizować jego zachowanie i upewnić się, że zabezpieczenie działa poprawnie. W artykule pokazaliśmy, jak zidentyfikować Cloudflare Waiting Room oraz gdzie znaleźć instrukcje dotyczące jego podłączenia lub ponownej konfiguracji, aby móc pewnie utrzymywać ochronę i kontrolować jej działanie.
