CapMonster Cloud API
Tarayıcılar için uzantı
Bu makalede tüm önemli sorulara cevap vermeye çalıştık. Bir problemi çözmeye başlamanın ilk adımı, hangi koruma sisteminin kullanıldığını belirlemektir. Bunun için, görsel örneklerin ve neyle karşı karşıya olduğunuzu hızlıca anlamanıza yardımcı olabilecek temel işaretlerin yer aldığı popüler captcha ve anti-bot koruma sistemleri listesine başvurabilirsiniz.
Sitenizde Cloudflare Waiting Room kullanıldığını fark ederseniz, bir sonraki adım özelliklerini ve çalışma şeklini daha ayrıntılı incelemek olacaktır. Yine bu makalede, Cloudflare Waiting Room sisteminin entegrasyonuna ilişkin kılavuzu da bulabilir ve böylece sitenizde nasıl çalıştığını tamamen anlayabilirsiniz. Bu da yalnızca mevcut korumayı anlamanıza değil, aynı zamanda bakımını doğru şekilde planlamanıza da yardımcı olur.
Waiting Room mekanizmasını test ederken, kuyruğun doğru çalıştığından ve siteye erişimi düzenlediğinden emin olmak önemlidir.
Bunu şu şekilde kontrol edebilirsiniz:
Otomatik test ve captcha tanıma için, captcha parametrelerini kabul eden, bunları sunucularında işleyen ve hazır bir çözüm döndüren CapMonster Cloud gibi özel hizmetleri kullanabilirsiniz. Bu çözüm (token veya çerez), kullanıcı etkileşimi olmadan doğrulamayı geçmek için bir forma veya tarayıcıya eklenebilir.
CapMonster Cloud API ile çalışma genellikle şu adımlardan oluşur:
Görev oluşturma
API isteği göndermeCloudflare Waiting Room'u çözmek için istekte aşağıdaki parametreler belirtilmelidir:
type - TurnstileTask;
websiteURL - Challenge'ın (doğrulama işleminin) bulunduğu sayfanın URL'si;
websiteKey - Hedef sitedeki Cloudflare anahtarı (key);
cloudflareTaskType - wait_room;
htmlPageBase64 - <title>Waiting Room powered by Cloudflare</title> başlığını içeren Base64 kodlu HTML sayfası;
userAgent - Tarayıcı User-Agent bilgisi. Yalnızca Windows işletim sisteminden güncel bir UA iletin;
Ayrıca, bu görev için kendi proxy'lerinizi kullanmanız gerekir:
proxyType :
proxyAddress - Proxy IPv4/IPv6 adresi;
proxyPort - Proxy portu;
proxyLogin - Proxy sunucu kullanıcı adı;
proxyPassword - Proxy sunucu şifresi.
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
}
Sonucu almahttps://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 değişimiAlınan çözüm (cf_clearance çerezi) tarayıcıya ayarlanabilir veya Cookie: cf_clearance=
Aşağıda, önceden alınmış çerez değerleri ile sayfanıza yapılan bir istek örneği verilmiştir. Bu test için yararlıdır: Erişim işleme ve doğrulama mantığınızın doğru çalıştığından emin olmak için hem doğru hem de kasıtlı olarak hatalı değerler iletebilirsiniz.
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
Gereksinimler ve hazırlık1. Cloudflare'e kayıt olun ve sitenizi bağlayın.
2. Traffic → Waiting Room bölümünde yeni bir kuyruk oluşturun:
3. Create Waiting Room (Bekleme Odası Oluştur) düğmesine tıklayın.
Şunları belirtin:
4. Bekleme sayfası tasarımını özelleştirin:
5. Kaydedin ve Waiting Room'u etkinleştirin.
6. Kuralları Yapılandırma
Cloudflare, belirli trafiğin kuyruğa dahil edilmemesine (hariç tutulmasına) izin verir.
Tipik Atlatma (Bypass) Kuralları:
Dashboard'da yol atlatma (path bypass) kuralı örneğiŞunları yapılandırın:
Tüm atlatma kuralları, trafiğin aktif kullanıcı sayısından hariç tutulmasını sağlar, böylece kuyruğu etkilemezler.
Gelişmiş Özellikler:
API ile Yönetim:
Cloudflare Waiting Room API şunları yapmanızı sağlar:
API aracılığıyla atlatma kuralı oluşturma örneğiPOST 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
}Çalışmayı Doğrulama
1) Siteyi farklı tarayıcılardan/cihazlardan açın.
2) Kontrol edin:
Kodu üzerinde erişiminiz olmayan, ancak üzerinde zaten bir captcha veya başka bir koruma sistemi kurulmuş bir site devraldıysanız, sorun değil! Hangi teknolojinin kullanıldığını tespit etmek oldukça kolaydır. Çalışmanın düzgün olup olmadığını kontrol etmek için ise, izole bir test ortamında CapMonster Cloud tanıma servisinden yararlanarak, jeton işleme mekanizmasının ve doğrulama mantığının doğru şekilde çalıştığından emin olabilirsiniz.
Cloudflare Waiting Room söz konusu olduğunda, sistemi tanımlamak, davranışını incelemek ve korumanın düzgün çalıştığını doğrulamak yeterlidir. Bu yazıda, Cloudflare Waiting Room nasıl tespit edilir ve entegrasyonu ya da yeniden yapılandırılması için talimatların nerede bulunabileceği gösterdik; böylece korumayı güvenle sürdürebilir ve çalışmasını kontrol altında tutabilirsiniz.
