Cloudflare Turnstile çözümünün fiyatlandırması
| CAPTCHA | Fiyat (USD) |
|---|---|
$ 1.30 1000 jeton |
Captcha veya başka bir koruma katmanı olan bir site devraldınız ama kaynak koda erişemiyor musunuz? O zaman hangi çözümün kurulu olduğunu, doğru ayarlanıp ayarlanmadığını ve nasıl test edileceğini bilmek istersiniz.
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 Turnstile 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 Turnstile 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.
Cloudflare Turnstile nedir
Cloudflare Turnstile, web sitelerini otomatik eylemlerden koruyan Cloudflare'in modern bir CAPTCHA'sıdır. Web sitesi ziyaretçileri için doğrulama neredeyse görünmezdir, görevleri tamamlamaya gerek yoktur: genellikle onay kutusuna tek bir tıklama yeterlidir, bundan sonra sistem ziyaretçinin geçmesine izin verilip verilmeyeceğine veya bot şüphesinde engellenip engellenmeyeceğine karar verir. Cloudflare Challenge'ın aksine, Turnstile CAPTCHA'sı ayrı bir pencerede değil, doğrudan web sitesinde yerleştirilir—genellikle giriş veya kayıt formlarında.
CapMonster Cloud aracılığıyla Cloudflare Turnstile nasıl çözülür
Cloudflare Turnstile içeren formları test ederken, captchanın düzgün çalıştığını ve doğru entegre edildiğini doğrulamanız gerekir.
Sitenize yerleştirilen captchayı manuel olarak test edebilirsiniz.
- Form sayfasını açın ve captchanın görüntülendiğinden emin olun.
- Çözmeden form göndermeyi deneyin — sunucu hata döndürmelidir.
- Başarılı çözümlerden sonra form sorunsuz gönderilmelidir.
Otomatik çözüm için CapMonster Cloud gibi araçlar kullanabilirsiniz. Captcha parametrelerini alır, kendi sunucularında işler ve hazır bir token döndürür. Bu tokenı forma ekleyerek kullanıcı müdahalesi olmadan doğrulamayı geçebilirsiniz.
CapMonster Cloud API ile çalışma genellikle şu adımlardan oluşur:
Görev oluşturma
Bu aşamada API anahtarınızı, CAPTCHA türünü ve parametrelerini iletirsiniz. Hizmet, daha sonra sonucu almak için kullanılabilecek benzersiz bir taskId döndürür.
API isteği göndermeCloudflare Turnstile'ı çözmek için istekte aşağıdaki parametrelerin belirtilmesi gerekir:
type - TurnstileTask;
websiteURL - CAPTCHA'nın çözüldüğü sayfanın adresi;
websiteKey - Turnstile anahtarı.
Parametreler ve otomatik toplama hakkında daha fazlası CapMonster Cloud dokümantasyonunda anlatılır.
Görev gönderim adresi:
javascript
https://api.capmonster.cloud/createTaskİstek örneği:
json
{
"clientKey": "API_KEY",
"task": {
"type": "TurnstileTask",
"websiteURL": "http://tsmanaged.zlsupport.com",
"websiteKey": "0x4AAAAAAABUYP0XeMJF0xoy"
}
}Yanıt:
json
{
"errorId":0,
"taskId":407533072
}
Sonucu almaGörev oluşturduktan sonra çözüm durumunu düzenli olarak kontrol edin.
Sonucu almak için adres:
javascript
https://api.capmonster.cloud/getTaskResultİstek örneği:
json
{
"clientKey":"API_KEY",
"taskId": 407533072
}Yanıt:
json
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36",
"token": "0.iGX3xsyFCkbGePM3jP4P4khLo6TrLukt8ZzBvwuQOvbC...f61f3082"
}
}
Token'ı sayfaya yerleştirmeSunucu CapMonster Cloud'dan Turnstile token'ını aldıktan sonra, bunu web sitesine iletmek gerekir. Sunucu verileri doğrulayacak ve CAPTCHA'nın başarıyla çözüldüğünü onaylayacaktır. Otomasyon için HTTP istekleri veya Puppeteer, Selenium veya Playwright gibi araçlar kullanabilirsiniz—bunlar forma değerler eklemenize ve kullanıcı eylemlerini taklit ederek isteği göndermenize olanak tanır.
Hazır kütüphaneler kullanılarak Cloudflare Turnstile tanıma
CapMonster Cloud hizmeti, Python, JavaScript (Node.js) ve C# dillerinde rahat çalışma için hazır kütüphaneler sağlar.
Python
JavaScript
C#
Çözüm, token ekleme ve form gönderimi
Web sayfanızda CAPTCHA tanımanın tam döngüsü için Node.js'de örnek. Olası yaklaşımlar: HTML ve CAPTCHA parametrelerini almak için HTTP isteklerini kullanın, yanıtı gönderin ve sonucu işleyin; veya otomasyon araçlarıyla (örneğin, Playwright)—sayfayı açın, CAPTCHA'yı bekleyin, parametreleri gönderin (test için hem doğru hem de yanlış veriler gönderebilirsiniz), CapMonster Cloud istemcisi aracılığıyla çözümü alın, token'ı forma ekleyin ve sonucu görün.
python
// npm install playwright @zennolab_com/capmonstercloud-client
import { chromium } from "playwright";
import { CapMonsterCloudClientFactory, ClientOptions, TurnstileRequest } from "@zennolab_com/capmonstercloud-client";
async function main() {
// 1. CapMonster Cloud aracılığıyla Turnstile çözümü
const cmcClient = CapMonsterCloudClientFactory.Create(
new ClientOptions({ clientKey: 'YOUR_CAPMONSTER_API_KEY' })
);
const turnstileRequest = new TurnstileRequest({
websiteURL: 'http://tsmanaged.zlsupport.com',
websiteKey: '0x4AAAAAAABUYP0XeMJF0xoy',
});
const result = await cmcClient.Solve(turnstileRequest);
const token = result.solution.token;
console.log('Turnstile token'ı alındı:', token);
// 2. Playwright başlatılıyor
const browser = await chromium.launch({ headless: false });
const context = await browser.newContext();
const page = await context.newPage();
await page.goto('http://tsmanaged.zlsupport.com');
// 3. Giriş ve şifre doldurma
await page.fill('#username', 'your_username');
await page.fill('#password', 'your_password');
// 4. Gizli token alanının görünmesini bekleme
await page.waitForSelector('#token', { state: 'attached', timeout: 60000 });
// 5. Token ekleme ve alanı görünür hale getirme
await page.evaluate((t) => {
const tokenInput = document.querySelector('#token');
if (tokenInput) {
tokenInput.type = 'text'; // alanı görünür hale getir
tokenInput.value = t; // token ekle
console.log('Token, token alanına eklendi');
} else {
console.error('#token alanı bulunamadı');
}
}, token);
// 6. Token'ın gerçekten eklendiğini doğrulama
const checkValue = await page.$eval('#token', el => el.value);
console.log('Token değerinin kontrolü:', checkValue);
// 7. Form gönderme
await page.click('button[type="submit"]');
console.log('Form Turnstile token'ıyla gönderildi');
// await browser.close();
}
main().catch(err => console.error(err));Ayrıca CapMonster Cloud tarayıcı uzantısını kullanarak CAPTCHA tanımayı test etmek için mükemmel bir seçenek var; bu, kod yazmadan doğrudan sayfada CAPTCHA işlevselliğini hızlıca kontrol etmenize ve çözüm sürecini gerçek zamanlı olarak izlemenize olanak tanır—Chrome ve Firefox'a kurulum için mevcuttur.
Cloudflare Turnstile web sitenize nasıl bağlanır
Web sitenizde CAPTCHA'nın çalışmasında güvenle gezinmek, doğrulama mantığını anlamak, yeniden bağlamak veya yeniden yapılandırmak için bu bölümü incelemenizi öneririz. Koruma bağlantı sürecini açıklar—bu, tüm nüansları hızlıca anlamanıza yardımcı olacaktır.
1. Cloudflare Turnstile sayfasına gidin, Şimdi Başlayın'a tıklayın.
2. Hizmete kaydolun.
3. Turnstile Widgets'ta mavi Add Widget düğmesine tıklayın.
4. Cloudflare Turnstile'ı yapılandırın, belirtin:
- Widget name—CAPTCHA'nın adı (kolaylık için, örneğin Login form).
- Hostname Management—CAPTCHA'nın çalışacağı domainler (örneğin, example.com).
- Widget Mode:
- Managed—optimal seçenek, CAPTCHA onay kutusunu gösterip göstermeyeceğine kendisi karar verir.
- Non-interactive—doğrulama tıklama olmadan otomatik olarak gerçekleştirilir.
- Invisible—tamamen görünmez.
- Pre-clearance—site Cloudflare Proxy üzerinden geçiyorsa Yes olarak ayarlayın (CAPTCHA'yı tekrarlamamak için).
5. Widget'ı oluşturduktan sonra iki anahtar alacaksınız—Site Key ve Secret Key.
6. İstemci tarafını bağlayın
1) Turnstile betiğini bağlayın
Otomatik oluşturma (widget sayfa yüklenirken otomatik olarak oluşturulur):
markup
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>Programatik kontrol (widget'ı JavaScript aracılığıyla kendiniz oluşturursunuz):
markup
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js?render=explicit" defer></script>Önemli: betik tam URL'den yüklenmelidir. Proxy veya önbellek hatalara neden olabilir.
2) Widget için bir konteyner oluşturun
Otomatik:
markup
<div class="cf-turnstile" data-sitekey="<YOUR_SITEKEY>"></div>Programatik olarak:
markup
<div id="turnstile-container"></div>3) Widget yapılandırması
Data öznitelikleri aracılığıyla:
markup
<div class="cf-turnstile"
data-sitekey="<YOUR_SITEKEY>"
data-theme="light"
data-size="normal"
data-callback="onSuccess">
</div>JavaScript aracılığıyla:
javascript
const widgetId = turnstile.render("#turnstile-container", {
sitekey: "<YOUR_SITEKEY>",
theme: "light",
size: "normal",
callback: token => console.log("Token:", token)
});4) Token'larla çalışma
javascript
const token = turnstile.getResponse(widgetId); // token al
const isExpired = turnstile.isExpired(widgetId); // süre sonunu kontrol et
turnstile.reset(widgetId); // sıfırla
turnstile.remove(widgetId); // kaldır
turnstile.execute("#turnstile-container"); // manuel yürütme
5) Formla entegrasyon
markup
<form id="my-form" method="POST">
<input type="hidden" name="cf-turnstile-response" id="cf-turnstile-response">
<button type="submit">Gönder</button>
</form>
<script>
function onSuccess(token) {
document.getElementById("cf-turnstile-response").value = token;
}
</script>
Kod örneğimarkup
<title>Turnstile Example</title>
<!-- Turnstile betiğini bağla -->
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
</head>
<body>
<h1>Turnstile ile form örneği</h1>
<form id="my-form">
<label for="username">İsim:</label>
<input type="text" name="username" id="username" required>
<!-- Turnstile için konteyner -->
<div class="cf-turnstile" data-sitekey="<YOUR_SITEKEY>" data-callback="onTurnstileSuccess"></div>
<button type="submit">Gönder</button>
</form>
<script>
// CAPTCHA'dan geçtikten sonra çağrılan callback
function onTurnstileSuccess(token) {
console.log("Turnstile token'ı alındı:", token);
// Token'ı gizli form alanına kaydet (isteğe bağlı)
document.getElementById("cf-turnstile-token")?.remove();
const input = document.createElement("input");
input.type = "hidden";
input.name = "cf-turnstile-response";
input.id = "cf-turnstile-token";
input.value = token;
document.getElementById("my-form").appendChild(input);
}
// Form gönderimi
document.getElementById("my-form").addEventListener("submit", async (e) => {
e.preventDefault();
const formData = new FormData(e.target);
const response = await fetch("/submit-form", {
method: "POST",
body: formData
});
const result = await response.json();
if(result.success){
alert("Form başarıyla gönderildi ve token doğrulandı!");
} else {
alert("Turnstile token doğrulama hatası. Lütfen tekrar deneyin.");
// Kullanıcının CAPTCHA'yı tekrar tamamlayabilmesi için widget'ı sıfırla
turnstile.reset();
}
});
</script>
</body>
</html>
6) Sunucu tarafını yapılandırın
Sunucu tarafı doğrulama süreci:
- İstemci: kullanıcı sayfada Turnstile'ı tamamlar → token oluşturulur.
- Form gönderilir: token form verileriyle birlikte sunucuya gönderilir.
- Sunucu: token ve gizli anahtarla Cloudflare Siteverify API'sine POST isteği yapar.
- Cloudflare: sonuçla (success: true/false) ve ek bilgilerle (action, hostname, tamamlanma süresi) JSON döndürür.
- Sunucu: kullanıcı eyleminin izin verilip verilmeyeceğine veya reddedileceğine karar verir.
Siteverify API:
javascript
POST
https://challenges.cloudflare.com/turnstile/v0/siteverifyİstek parametreleri:
- secret (zorunlu): Cloudflare panelinden gizli Turnstile anahtarı
- response (zorunlu): istemcide alınan token
- remoteip (isteğe bağlı): kullanıcının IP adresi (önerilir)
- idempotency_key (isteğe bağlı): tekrarlanan doğrulamalara karşı koruma için benzersiz UUID
Token özellikleri:
- Maksimum uzunluk: 2048 karakter
- 5 dakika geçerli
- Tek kullanımlık
- Süresi dolduğunda veya yeniden doğrulandığında, API timeout-or-duplicate hatası döndürür
PHP'de doğrulama örneğiphp
<?php
function validateTurnstile($token, $secret, $remoteip = null) {
$url = 'https://challenges.cloudflare.com/turnstile/v0/siteverify';
$data = ['secret' => $secret, 'response' => $token];
if ($remoteip) $data['remoteip'] = $remoteip;
$options = [
'http' => [
'header' => "Content-type: application/x-www-form-urlencoded
",
'method' => 'POST',
'content' => http_build_query($data)
]
];
$response = file_get_contents($url, false, stream_context_create($options));
if ($response === FALSE) {
return ['success' => false, 'error-codes' => ['internal-error']];
}
return json_decode($response, true);
}
// Kullanım
$secret_key = 'YOUR_SECRET_KEY';
$token = $_POST['cf-turnstile-response'] ?? '';
$remoteip = $_SERVER['REMOTE_ADDR'];
$result = validateTurnstile($token, $secret_key, $remoteip);
if($result['success']){
echo "Form başarıyla gönderildi!";
} else {
echo "Doğrulama hatası: " . implode(', ', $result['error-codes']);
}
?>
İstemci ve sunucu entegrasyonu, kod örnekleri, hata açıklamaları ve güvenlik önerileri dahil olmak üzere Cloudflare Turnstile'ı kurma ve yapılandırma için tüm ayrıntılı talimatlar resmi Cloudflare dokümantasyonunda bulunabilir.
Olası hatalar ve hata ayıklama
Yanlış parametreler
CAPTCHA görüntülenmiyor veya invalid-input-secret, missing-input-response, invalid-input-response gibi hatalar veriyor. sitekey ve secret key'in geçerliliğini ve Cloudflare Dashboard'daki ayarları kontrol edin.
Çözüm zaman aşımı
Token'ın süresi doldu (300 saniye geçerli) veya zamanında alınamadı. Kararlı bağlantı ve doğru API entegrasyonu sağlayın.
Boş veya yanlış token
cf-turnstile-response parametresi eksik veya yanlış. Token'ın forma ve sunucuya aktarımını kontrol edin.
Yanıt success=false
Token geçersiz, süresi dolmuş veya zaten kullanılmış. Her token yalnızca bir kez doğrulanabilir. Analiz için Siteverify istek ve yanıtlarının günlüğe kaydedilmesini etkinleştirin.
Korumanın dayanıklılığını test etme
Entegrasyondan sonra sistemin gerçekten otomatik işlemleri engellediğinden emin olun.
CAPTCHA'yı çözmeden isteği yürütmeyi deneyin—sunucu success: false döndürmelidir.
Saniyede 100'den fazla istek hızında yük testi yapın (örneğin, k6 veya JMeter kullanarak). Turnstile istekleri doğru şekilde işlemeli ve sunucu Siteverify API aracılığıyla token'ları kararlı bir şekilde doğrulamalıdır.
Süresi dolmuş veya yeniden gönderilen token'lara verilen yanıtı kontrol edin—beklenen API yanıtı: success: false ve error-codes: ["timeout-or-duplicate"].
Güvenlik ve optimizasyon önerileri
Token'ları yalnızca sunucuda doğrulayın, asla frontend'den Siteverify API'sini çağırmayın—bu gizli anahtarınızı açığa çıkaracaktır.
Kodda anahtar depolamak yerine ortam değişkenlerini veya gizli yönetim sistemini kullanın.
İsteğin web sitenizden geldiğinden emin olmak için ek alanları (hostname, action) kontrol edin.
HTTPS kullanın—Siteverify'a yapılan tüm çağrılar güvenli bir bağlantı üzerinden yapılmalıdır.
Hata işleme uygulayın—API kullanılamadığında, dahili verileri ifşa etmeden kullanıcıya net bir mesaj gösterin.
Sitekey kullanımını domainlere göre kısıtlayın.
Kuruluşunuz veya gizlilik politikanız gerektiriyorsa forma Gizlilik Politikası ve Cloudflare Hizmet Koşulları bağlantıları ekleyin.
Desteklenen captchas
reCAPTCHA v2reCAPTCHA v3reCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
FriendlySonuç
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 Turnstile 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 Turnstile 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.
Faydalı bağlantılar
Cloudflare Turnstile Dokümantasyonu →Cloudflare'e kaydolun →CapMonster Cloud'a kaydolun →CapMonster Cloud Dokümantasyonu (Cloudflare Turnstile ile çalışma) →Cloudflare CAPTCHA nedir ve CapMonster Cloud ile nasıl çözülür →Cloudflare otomatik trafiği nasıl tespit eder: web sitelerini botlardan koruma →
Cloudflare Turnstile hakkında sık sorulan sorular
CapMonster Cloud API ile Cloudflare Turnstile nasıl çözülür?
Hangi Cloudflare Turnstile widget modları mevcuttur?
Bir geliştirici olarak Cloudflare Turnstile token'ını sunucu tarafında nasıl doğrularım?
Playwright'ta bir Turnstile token'ı forma nasıl aktarılır?
Turnstile sunucu doğrulamasında timeout-or-duplicate ne anlama gelir?