Prosopo Procaptcha
ve CapMonster Cloud

Captcha çözümü, siteye kurulum ve test.

Prosopo Procaptcha çö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 Prosopo Procaptcha kullanıldığını fark ederseniz, bir sonraki adım özelliklerini ve çalışma şeklini daha ayrıntılı incelemek olacaktır. Yine bu makalede, Prosopo Procaptcha 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.

Procaptcha Nedir
Procaptcha Nedir
Procaptcha, Prosopo şirketi tarafından geliştirilen, siteyi spam ve otomatik zararlı işlemlerden korumak için tasarlanmış bir güvenlik sistemidir. Gerçek kullanıcıları botlardan ayırmaya yardımcı olur, böylece web sitesinin güvenliğini ve istikrarını sağlar. Sistem ziyaretçinin doğruluğundan şüphelenirse, bir doğrulama görevi (ör. belirli resimleri seçme) sunar; gerçek kullanıcılar ise siteyi sorunsuz ve rahat bir şekilde kullanabilir.
Background
Prosopo Procaptcha örnekleri
Frictionless CAPTCHA
Frictionless CAPTCHA
Görünmez captcha. Ziyaretçinin gerçek kullanıcı mı yoksa bot mu olduğunu otomatik olarak belirler. Kullanıcı normal şekilde davranıyorsa (normal tarayıcı, otomasyon yok) captcha fark edilmeden çözülür. Bot belirtileri tespit edilirse, kullanıcıya ek bir image görevi gösterilir.
Proof of Work (PoW) CAPTCHA
Proof of Work (PoW) CAPTCHA
Hesaplamaya dayalı captcha, yani cihazınızın arka planda küçük bir hesaplama işlemi yapmasını gerektirir. Temel amacı toplu botları ve spam’i durdurmaktır, çünkü otomatik sistemler işlemi tamamlamak için zaman ve kaynak harcar. İnsan için genellikle neredeyse fark edilmez.
Image CAPTCHA
Image CAPTCHA
Klasik görsel captcha. Resimleri gösterir ve belirli bir koşulu karşılayanları seçmenizi ister (ör. 'tüm atları seçin').

CapMonster Cloud ile Procaptcha Nasıl Çözülür

Prosopo Procaptcha 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şturmaGörev oluşturma
arrow
API isteği göndermeAPI isteği gönderme
arrow
Sonucu almaSonucu alma
arrow
Token'ı sayfaya yerleştirmeToken'ı sayfaya yerleştirme
arrow
Hazır Kütüphanelerle Procaptcha Tanıma
CapMonster Cloud servisi, Python, JavaScript (Node.js) ve C# dillerinde kolay kullanım için hazır kütüphaneler sunar.
Python
JavaScript
C#
Çözüm, token ekleme ve form gönderme
Node.js örneği ile web sayfanızda captcha çözmenin tam döngüsü. Olası yaklaşımlar: HTML ve captcha parametrelerini almak için HTTP istekleri kullanmak, cevabı göndermek ve sonucu işlemek; veya otomasyon araçları ile (ör. Playwright) sayfayı açmak, captcha’yı beklemek, parametreleri göndermek (test için doğru veya hatalı verileri gönderebilirsiniz), CapMonster Cloud istemcisi aracılığıyla sonucu almak, tokeni forma eklemek ve sonucu görmek.

async function sendTokenToSite(token) {
    // Tokenin gönderileceği form URL’si veya endpoint
    const formURL = "https://example..com/en/your-form-endpoint";

    // Form verisi örneği
    const formData = {
        email: "example@example.com",
        password: "yourpassword",
        "procaptcha-response": token // Procaptcha tokeni
    };

    try {
        const response = await fetch(formURL, {
            method: "POST",
            headers: {
                "Content-Type": "application/json", // или 'application/x-www-form-urlencoded' siteye bağlı olarak
            },
            body: JSON.stringify(formData),
        });

        const result = await response.text(); // veya sunucu JSON döndürüyorsa response.json()
        console.log("Server response:", result);
    } catch (err) {
        console.error("Error sending token:", err);
    }
}

// Ana fonksiyon
async function solveAndSend() {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    const prosopoRequest = new ProsopoRequest({
        websiteURL: "https://example.com/en/",
        websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV"
    });

    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(prosopoRequest);
    console.log("Captcha solution:", result);

    // Tokeni siteye gönderme
    await sendTokenToSite(result.solution); // result.solution Procaptcha tokenini içerir
}

solveAndSend().catch(console.error);

Procaptcha’yı sitenize nasıl bağlarsınız
Sitenizde captcha’nın çalışma mantığını güvenle anlamak, doğrulama sürecini kavramak, yeniden bağlamak veya yeniden yapılandırmak için bu bölümü incelemenizi öneririz. Bu bölüm koruma sürecini açıklayarak tüm ayrıntıları hızlıca anlamanıza yardımcı olur.

1. Anahtarları alın (sitekey ve secret key)

  • 1) Prosopo Portal adresine gidin.
  • 2) Site Management bölümüne gidin
  • 3) Reveal tıklayın — iki anahtar görünecek:
    • sitekey — herkese açık, istemcide kullanılır.
    • secret key — gizli, sadece sunucuda kullanılır.
Önemli: Her widget kendi anahtar setini oluşturur. Başka projelerde tekrar kullanılamaz.

2. Alan adınızı ekleyin

  • 1) Account → Domains bölümüne gidin.
  • 2) Alan adınızın listelendiğinden emin olun.
  • 3) Lokal test ediyorsanız — localhost ekleyin.
  • 4) Prodüksiyona geçmeden önce localhost kaldırın.

3. Procaptcha scriptini bağlayın

Tag’i <head> içine yerleştirin

<script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>>

4. Seçenek 1: Implicit rendering (otomatik render) — DAHA KOLAY

Captcha’nın otomatik olarak görüneceği bir container ekleyin:

<div class="procaptcha" data-sitekey="your_site_key"></div>

Genellikle formun içine yerleştirilir.

Tam form örneğiTam form örneği
arrow

Başarılı doğrulama sonrası gizli bir parametre eklenecek:

5. Seçenek 2: Explicit rendering (manuel render) — DAHA FAZLA KONTROL

HTML örneğiHTML örneği
arrow
JavaScript örneğiJavaScript örneği
arrow

6. Captcha tipini ayarlama (opsiyonel)

Açıkça seçilebilir:

  • frictionless (varsayılan)
  • pow
  • image

Örnek:


<div class="procaptcha"
     data-sitekey="your_site_key"
     data-captcha-type="pow">
</div>

7. Zorunlu adım: Sunucuda token doğrulama

Captcha renderlandıktan sonra sunucu cevabı doğrulamak zorundadır. Doğrulama API üzerinden yapılır:

POST
https://api.prosopo.io/siteverify

İstek içeriği:

{
    "secret": "your_secret_key",
    "token": "PROCAPTCHA-RESPONSE"
}

8. PHP ile sunucu doğrulaması

Kod örneği:Kod örneği:
arrow

Başarılı doğrulama ne demektir?

Eğer Procaptcha sunucusu dönerse:

{
    "verified": true
}

captcha geçtiyse, korumalı işlemi (örn. kullanıcı kaydı) gerçekleştirebilirsiniz.

Background
Olası hatalar ve hata ayıklama
Bug Icon
Geçersiz Site Key
Yanlış veya geçersiz site key kullanılıyor. Çözüm: Procaptcha kontrol panelinden doğru anahtarı kullandığınızdan emin olun.
Bug Icon
Yetkisiz origin URL
Widget’ın kurulu olduğu domain, site key ile ilişkili domain ile eşleşmiyor. Çözüm: Procaptcha portal ayarlarında domain listesini kontrol edin ve güncelleyin.
Bug Icon
Oturum bulunamadı
Oturum bulunamadı veya süresi doldu. Çözüm: Widget yeniden yüklenene kadar bekleyin (~3 saniye) veya sayfayı yenileyin. Hata tekrarlıyorsa tarayıcı önbelleğini ve çerezleri temizleyin veya destek ile iletişime geçin.
Bug Icon
success=false cevabı
Token süresi dolmuş, tekrar kullanılmış veya doğrulama başarısız olmuş. Tanılama için istek kaydını açın ve Procaptcha yanıtındaki error alanını kontrol edin.
Korumanın dayanıklılığını test etme
Entegrasyondan sonra sistemin gerçekten otomatik işlemleri engellediğinden emin olun.
Güvenlik ve optimizasyon önerileri
<span class="font-bold">Secret Key</span> yalnızca sunucuda saklayın. Asla istemciye göndermeyin.
Hangi doğrulamaların başarısız olduğunu anlamak için hata kodlarını <span class="font-bold">(error-codes)</span> kaydedin.
Formların altına <span class="font-bold">Gizlilik Politikası</span> ve <span class="font-bold">Procaptcha Kullanım Şartları</span> bağlantıları ekleyin, eğer uygulamanız bunu gerektiriyorsa.
Sonuç

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.

Prosopo Procaptcha 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, Prosopo Procaptcha 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.

Conclusion
Faydalı bağlantılar
DocIconProcaptcha DokümantasyonuDocIconProsopo PortalDocIconCapMonster Cloud Dokümantasyonu (Procaptcha ile çalışma)

Prosopo Procaptcha hakkında sık sorulan sorular

Procaptcha üç doğrulama türü kullanır ve ziyaretçi oturumunun risk düzeyine göre en uygun olanı seçer:

  • Frictionless CAPTCHA: Arka planda çalışır ve tarayıcı sinyalleri ile davranış insan gibi görünüyorsa ziyaretçiyi görünmez şekilde doğrular. Şüpheli oturumlar görünür bir göreve yükseltilebilir.
  • Proof of Work (PoW) CAPTCHA: Ziyaretçinin cihazına küçük bir hesaplama görevi verir; bu, büyük ölçekli otomatik istekleri daha maliyetli hale getirirken gerçek kullanıcılar için neredeyse fark edilmez kalır.
  • Image CAPTCHA: «Tüm atları seçin» gibi bir istemle eşleşen tüm görüntüleri seçmek gibi görsel bir görev gösterir.

Doğrulama modunu widget div'indeki data-captcha-type özniteliğiyle belirtebilirsiniz. Görünmez arka plan kontrolleri için frictionless, Proof of Work bulmacası için pow veya klasik görüntü seçimi görevi için image olarak ayarlayın.

Örneğin:

<div class="procaptcha"
     data-sitekey="your_site_key"
     data-captcha-type="pow">
</div>

İstemci tarafındaki data-captcha-type değeriniz, Prosopo Portal hesap ayarlarınızda yapılandırılan CAPTCHA türüyle tam olarak eşleşmelidir.

Evet, evrensel HTTP istekleri kullanarak çözümü herhangi bir Python betiğine entegre edebilirsiniz.

Görev ID'si isteyin: API anahtarınız, websiteURL ve websiteKey ile createTask endpoint'ine bir POST isteği gönderin.

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ProsopoTask",
    "websiteURL": "https://example.com",
    "websiteKey": "SITE_KEY"
  }
}

Sonucu sorgulayın: Durum ready olana kadar alınan taskId'yi getTaskResult endpoint'ine gönderin.

{
  "clientKey": "YOUR_API_KEY",
  "taskId": 123456789
}

Token'ı kullanın: solution nesnesinden dizeyi çıkarın ve HTTP yükünüzde (requests, aiohttp) procaptcha-response değeri olarak iletin veya DOM'a enjekte edin (Playwright, Puppeteer, Selenium).

Procaptcha, örtük render için widget div'inde data-callback özniteliğini veya açık render için yapılandırma nesnesinde callback özelliğini destekler.

Belirttiğiniz fonksiyon, captcha çözüldüğünde otomatik olarak çağrılır ve ilk argüman olarak token dizesini alır — bu noktada gönder düğmesini etkinleştirebilir, bir AJAX isteği tetikleyebilir veya token'ı bileşen durumunda saklayabilirsiniz.

callback kullanmak, genellikle procaptcha-response alanını yoklamaktan daha temizdir; widget çözümü ile form gönderimi arasındaki yarış koşullarını ortadan kaldırır.

Playwright, Puppeteer veya Selenium, çözülmüş Procaptcha token'larının enjeksiyonunu otomatikleştirmek için uyumlu yaklaşımlardır. Genel akış aynıdır:

  1. Hedef sayfaya gidin
  2. Procaptcha widget'ının yüklenmesini bekleyin
  3. CapMonster Cloud'dan API (veya istemci SDK) aracılığıyla token isteyin
  4. Form gönderimini tetiklemeden önce framework'ün yerel DOM manipülasyon yöntemleriyle dönen token'ı sayfaya enjekte edin.