reCAPTCHA v2, v3 ve Enterprise karşılaştırması: gönderilecek CapSkip alanları

recaptcha v2 vs v3 - reCAPTCHA v2 vs v3 vs Enterprise: CapSkip Fields to Send

reCAPTCHA v2 ile v3 karşılaştırması, kodda token alan herkes için pratik bir yanıta sahiptir: çözücü isteğine hangi alanların gireceğini belirler. v2 bir sitekey ve bir sayfa adresi ister, v3 ayrıca bir action adı ister ve Enterprise ikisinin üstüne eklenen bir bayraktır. Bu yazı istek kopya kâğıdıdır. Her widget’ın ne olduğunu ve nasıl tanınacağını öğrenmek için şuradan başlayın: reCAPTCHA nedir ve alanlar için buraya geri dönün.

Her reCAPTCHA varyantının ihtiyaç duyduğu CapSkip alanları

CapSkip 2captcha uyumludur, bu yüzden her varyant tek bir userrecaptcha görevidir ve bayraklar varyantı seçer. Adlar şuradan gelir: API belgeleri ve 1.7.0 sürümünde Python ile Node.js SDK kaynağına karşı doğrulandı.

Varyantin.php’ye gönderilen alanlarPython çağrısıNode.js çağrısı
v2 checkboxgooglekey, pageurlrecaptcha(sitekey, url)recaptcha(sitekey, url)
v2 invisibleinvisible=1 eklerinvisible=1 eklerinvisible değeri 1 olan options
v3version=v3 ve bir action eklerversion="v3", action="login"version değeri v3 ve bir action olan options
Enterprise v2enterprise=1 eklerenterprise=1 eklerenterprise değeri 1 olan options
Enterprise v2 invisibleenterprise=1 ve invisible=1 eklerher iki keyword argümanıher iki option
Enterprise v3version=v3, bir action ve enterprise=1 eklerüç keyword argümanının hepsiüç option’ın hepsi

Üç ayrıntı hata ayıklama zamanından tasarruf ettirir. Birincisi, API belgeleri v3 için varsayılan olarak action=verify değerini listeler. Bir action’ı atladığınızda iki SDK de onu göndermez, yani varsayılanı uygulama uygular ve bunu test edemedim. Bir sayfa action=login değerini denetliyorsa onu sizin geçirmeniz gerekir. İkincisi, callback isteğin parçası değildir: CapSkip token’ı döndürür ve callback’li ya da invisible bir widget için sayfa kodunuz callback’i onunla çağırır. Üçüncüsü, API belgeleri bir v2 Enterprise sayfasının s veya data-s parametresinde fazladan özel bir dize taşıyabileceğini söyler. Sayfada böyle bir şey varsa onu data-s alanı olarak gönderin; SDK’ler bunu datas anahtar sözcüğüyle kabul eder.

İşte Python’daki v2 varyantları. Token, sonucun code anahtarı altında gelir.

# pip install capskip
from capskip import CapSkip

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"
KEY = "YOUR_SITEKEY"

# Checkbox v2, then the invisible flavour of v2.
v2 = solver.recaptcha(sitekey=KEY, url=PAGE)
invisible = solver.recaptcha(sitekey=KEY, url=PAGE, invisible=1)

# Enterprise is a flag. Add the page's data-s value if it has one.
ent = solver.recaptcha(sitekey=KEY, url=PAGE, enterprise=1,
                       datas="YOUR_DATA_S")
ent_inv = solver.recaptcha(sitekey=KEY, url=PAGE, enterprise=1, invisible=1)

print(v2["code"][:20])   # token, ready for the form field

v3 için sürümü ve sayfanın execute çağrısına geçirdiği action’ı belirtirsiniz.

# pip install capskip
from capskip import CapSkip

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"
KEY = "YOUR_SITEKEY"

v3 = solver.recaptcha(sitekey=KEY, url=PAGE, version="v3", action="login")

# v3 Enterprise adds the same flag as v2 Enterprise.
ent_v3 = solver.recaptcha(sitekey=KEY, url=PAGE, version="v3",
                          action="login", enterprise=1)

print(v3["code"][:20])   # token for the action you named

Node.js SDK’si aynı seçimleri, sitekey’den ve sayfa adresinden sonra bir options nesnesi olarak alır.

// npm install capskip
const { CapSkip } = require('capskip');

const solver = new CapSkip({ host: '127.0.0.1', port: 8080 });
const PAGE = 'https://example.com/page-with-recaptcha';

(async () => {
  const v3 = await solver.recaptcha('YOUR_SITEKEY', PAGE,
    { version: 'v3', action: 'login' });
  const ent = await solver.recaptcha('YOUR_SITEKEY', PAGE,
    { enterprise: 1, invisible: 1 });
  console.log(v3.code.slice(0, 20), ent.code.slice(0, 20));
})();

İki SDK de karışık istekleri hiçbir şey gönderilmeden önce reddeder. Bir v2 görevindeki action ve bir v3 görevindeki invisible bayrağı, her biri doğrulama exception’ını fırlatır; bu, başarısız bir form gönderiminden öğrenmekten daha ucuzdur.

# pip install capskip
from capskip import CapSkip, ValidationException

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"

try:
    # An action only exists on v3, so this v2 task is refused locally.
    solver.recaptcha(sitekey="YOUR_SITEKEY", url=PAGE, action="login")
except ValidationException as err:
    print("refused:", err)

Bu blokları gerçek uygulamaya değil, bir in.php ve res.php mock’una karşı; Python 3.11.7, 3.13.7 ve 3.14.0 ile Node.js 24.22.0 üzerinde, hepsini capskip 1.7.0 ile çalıştırdım. Mock her çağrının gönderdiği alanları kaydetti ve alanlar tabloyla eşleşti: her çağrı metodu, sitekey’i ve sayfa adresini taşıyordu, ayrıca SDK’nın doldurduğu 0 veya 1 olarak açık bir enterprise değeri; diğer varyantlar da tam olarak listelenen bayrakları ekledi. Bu, isteğin biçimini kanıtlar, bir çözümü değil.

Sunucunun her varyant için neyi denetlediği

Alıcı taraftaki farklar, bayrakları gerekli kılan şeydir. Bu tablo yalnızca bir sitenin backend’inin gördüğünü karşılaştırır.

VaryantToken’ın geldiği yerBackend denetimiOkuyabileceği alanlar
v2 checkboxWidget, g-recaptcha-response olarak gönderilirKlasik doğrulamaSuccess, challenge zamanı, hostname
v2 invisibleBir execute çağrısı veya bağlı bir düğme, callback’e geçirilirKlasik doğrulamaSuccess, challenge zamanı, hostname
v3Bir action adlandıran bir execute çağrısıKlasik doğrulamaScore ve action ekler
Enterprise, puan tabanlı anahtarenterprise execute çağrısıBackend’de bir assessmentToken geçerliliği, action, risk puanı
Enterprise, onay kutusu anahtarıenterprise script’inden oluşturulan widgetBackend’de bir assessmentToken geçerliliği, risk puanı

Hepsi tek bir kuralı paylaşır: bir token iki dakika geçerlidir ve bir kez doğrulanabilir. Google’ın doğrulama kılavuzu bunu klasik endpoint için söyler ve assessment kılavuzu Enterprise için tekrarlar; bu yüzden token sona erme rehberi her satır için geçerlidir. Google’ın v3 dokümantasyonu ayrıca sitenin dönen action değerini beklediği action ile karşılaştırması gerektiğini ekler ve assessment kılavuzu assessment’ların backend’de yapılması gerektiğini söyler.

Enterprise ile v3 sorusuna gelince: Google iki tür Enterprise anahtarı tanımlar. Puan tabanlı anahtarlar, v3’ün yaptığı gibi enterprise execute fonksiyonunu çağırır. Onay kutusu anahtarları, v2’nin yaptığı gibi enterprise script’inden bir widget oluşturur ve onu hiç çağırmaz. Enterprise’ın istekte üçüncü bir sürüm değil, bir bayrak olmasının nedeni budur.

Puan Google’ındır, bir CapSkip seçeneği değil

Google bir v3 ziyaretini, büyük olasılıkla bot için 0,0’dan büyük olasılıkla iyi bir etkileşim için 1,0’a kadar puanlar ve varsayılan eşik olarak 0,5 önerir. CapSkip’in puan isteyen bir ayarı yoktur, bu yüzden çözüm kodunuzdaki hiçbir şey bir sayıyı garanti edemez. Sizin kontrol ettiğiniz şey geçirdiğiniz action ve ne zaman istediğinizdir.

Değerleri sayfadan okumak

Sitekey, data-sitekey özniteliğinde veya widget’ın frame adresindeki k parametresinde bulunur. v3 ve puan tabanlı Enterprise anahtarları için action, sayfanın execute çağrısındaki dizedir. Enterprise kendini enterprise script’i ve enterprise nesnesindeki çağrılarla belli eder. Varyant başına çözücü kılavuzları daha derine iner:

Başka bir makineden çağırmak

CapSkip bir Windows uygulamasıdır ve yukarıdaki örnekler onunla 127.0.0.1 üzerinden konuşur. Script’leriniz başka yerde çalışıyorsa CapSkip’i Server moduna alın ve host ayarını o Windows bilgisayarına yöneltin. Kurulum kılavuzu bu geçişi şu başlık altında anlatır: bağlantı ayarları ve kararlı uzak erişim için statik bir genel IP önerir. Server modu portu her adresten erişilebilir bırakır, çünkü CapSkip her başlatıldığında onun için bir izin kuralı ekler. Çağıranları sınırlamak için güvenmediğiniz adresler için bir Windows Güvenlik Duvarı engelleme kuralı ekleyin.

FAQ

reCAPTCHA v2 mi v3 mü otomatikleştirmek daha zor?

Hiçbiri farklı araç gerektirmez: ikisi de farklı bayraklı tek bir görevdir. Pratik fark, v3’te izleyecek bir widget olmamasıdır. Action’ı sayfa script’inde bulursunuz ve sonuç, ayarlayamadığınız bir Google puanına bağlıdır.

v3 hiç challenge gösterir mi?

Google’a göre hayır; v3 kullanıcıları hiç kesintiye uğratmaz. Düşük puandan sonra görünür bir adım isteyen bir site onu kendisi kurmak zorundadır.

Enterprise v2 mi v3 mü?

İkisi de olabilir. Enterprise ürün katmanıdır, bu yüzden stili sayfa belirler. CapSkip’te enterprise bayrağını bir v2 görevine ya da bir v3 görevine eklersiniz ve isteğin başka hiçbir şeyi değişmez.

CapSkip’in alacağı puanı seçebilir miyim?

Hayır. CapSkip’in bunun için bir ayarı yoktur. Doğru action’ı geçirin, token’ı onu kullanan istekten hemen önce isteyin ve sonucu siteden okuyun.

Hangisini çözüyorsunuz?

Önce sayfaya bakın: bir kutu veya invisible bir tetikleyici v2, action’lı bir execute çağrısı v3, enterprise script’i ise ikisinden birinde bir bayrak demektir. Sonra istek tablosunda satırı eşleştirin. CapSkip kendi Windows bilgisayarınızda bir sınırsız captcha çözücü olarak çalıştığı için, her varyant için yeni bir token istemek ya da biri sona erdiğinde yeniden istemek faturaya bir şey eklemez.