reCAPTCHA v2 vs v3 vs Enterprise: Field CapSkip yang Perlu Dikirim

Pertanyaan reCAPTCHA v2 vs v3 punya jawaban praktis bagi siapa pun yang mengambil token lewat kode: ia menentukan field mana yang masuk ke request pemecah. v2 memerlukan sitekey dan alamat halaman, v3 juga memerlukan nama action, dan Enterprise adalah flag di atas salah satunya. Tulisan ini adalah contekan request. Untuk mengetahui apa itu setiap widget dan cara mengenalinya, mulailah dengan apa itu reCAPTCHA lalu kembali ke sini untuk membahas field-nya.
Field CapSkip yang dibutuhkan setiap varian reCAPTCHA
CapSkip kompatibel dengan 2captcha, jadi setiap varian adalah satu userrecaptcha task, dan flag yang memilih variannya. Nama-namanya berasal dari Dokumentasi API dan telah diperiksa terhadap source SDK Python dan Node.js pada 1.7.0.
| Varian | Field yang dikirim ke in.php | Panggilan Python | Panggilan Node.js |
|---|---|---|---|
| v2 checkbox | googlekey, pageurl | recaptcha(sitekey, url) | recaptcha(sitekey, url) |
| v2 invisible | menambah invisible=1 | menambah invisible=1 | options dengan invisible diatur ke 1 |
| v3 | menambah version=v3 dan sebuah action | version="v3", action="login" | options dengan version diatur ke v3 dan sebuah action |
| Enterprise v2 | menambah enterprise=1 | menambah enterprise=1 | options dengan enterprise diatur ke 1 |
| Enterprise v2 invisible | menambah enterprise=1 dan invisible=1 | kedua keyword argument | kedua options |
| Enterprise v3 | menambah version=v3, sebuah action, dan enterprise=1 | ketiga keyword argument | ketiga options |
Tiga detail menghemat waktu debugging. Pertama, dokumentasi API mencantumkan action=verify sebagai default untuk v3. Kedua SDK tidak mengirim action jika Anda tidak menyertakannya, jadi default itu diterapkan oleh aplikasi, dan saya tidak bisa mengujinya. Halaman yang memeriksa action=login mengharuskan Anda mengirimnya. Kedua, callback bukan bagian dari request: CapSkip mengembalikan token, dan untuk widget callback atau invisible kode halaman Anda memanggil callback dengan token itu. Ketiga, dokumentasi API menyebut halaman v2 Enterprise mungkin membawa string kustom tambahan dalam parameter s atau data-s. Jika halaman punya string itu, kirim sebagai field data-s, yang diterima SDK dengan keyword datas.
Berikut varian v2 dalam Python. Token kembali di bawah key code pada hasilnya.
# 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 fieldUntuk v3, Anda menyebut versi dan action yang diteruskan halaman ke panggilan execute-nya.
# 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 namedSDK Node.js menerima pilihan yang sama sebagai objek options setelah sitekey dan alamat halaman.
// 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));
})();Kedua SDK juga menolak request yang keliru sebelum apa pun dikirim. Action pada task v2 dan flag invisible pada task v3 masing-masing memunculkan validation exception, yang lebih murah daripada mengetahuinya dari pengiriman formulir yang gagal.
# 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)Saya menjalankan blok-blok ini terhadap mock in.php dan res.php, bukan aplikasi aslinya, di Python 3.11.7, 3.13.7, dan 3.14.0 serta di Node.js 24.22.0, semuanya dengan capskip 1.7.0. Mock mencatat field yang dikirim setiap panggilan, dan hasilnya cocok dengan tabel: setiap panggilan membawa method, sitekey, dan alamat halaman, ditambah nilai enterprise eksplisit 0 atau 1 yang diisi SDK, sedangkan varian lain menambahkan persis flag yang tercantum. Itu membuktikan bentuk request, bukan pemecahan.
Apa yang diperiksa server untuk setiap varian
Perbedaan di sisi penerima inilah yang membuat flag diperlukan. Tabel ini hanya membandingkan apa yang dilihat backend sebuah situs.
| Varian | Dari mana token berasal | Pemeriksaan backend | Field yang bisa dibaca |
|---|---|---|---|
| v2 checkbox | Widget, dikirim sebagai g-recaptcha-response | Verifikasi klasik | Success, waktu challenge, hostname |
| v2 invisible | Panggilan execute atau tombol yang terikat, diteruskan ke callback | Verifikasi klasik | Success, waktu challenge, hostname |
| v3 | Panggilan execute yang menyebut sebuah action | Verifikasi klasik | Menambah score dan action |
| Enterprise, key berbasis skor | Panggilan execute enterprise | Sebuah assessment di backend | Validitas token, action, skor risiko |
| Enterprise, key checkbox | Widget yang dirender dari skrip enterprise | Sebuah assessment di backend | Validitas token, skor risiko |
Semuanya berbagi satu aturan: token berlaku selama dua menit dan hanya bisa diverifikasi sekali. Panduan verifikasi Google menyatakannya untuk endpoint klasik dan panduan assessment-nya mengulanginya untuk Enterprise, sehingga panduan kedaluwarsa token penting untuk setiap baris. Selain itu, Dokumentasi v3 milik Google menambahkan bahwa situs harus memeriksa action yang dikembalikan terhadap action yang diharapkannya, dan panduan assessment menyatakan bahwa assessment seharusnya dilakukan di backend.
Soal Enterprise vs v3: Google menjelaskan dua jenis key Enterprise. Key berbasis skor memanggil fungsi execute enterprise, seperti v3. Key checkbox merender widget dari skrip enterprise, seperti v2, dan tidak pernah memanggilnya. Itulah sebabnya Enterprise adalah flag di dalam request, bukan versi ketiga.
Skor itu milik Google, bukan opsi CapSkip
Google menilai kunjungan v3 dari 0.0 untuk sangat mungkin bot sampai 1.0 untuk sangat mungkin interaksi yang baik, dan menyarankan 0.5 sebagai ambang default. CapSkip tidak punya pengaturan yang meminta skor, jadi tidak ada kode pemecahan Anda yang bisa menjanjikan angka. Yang bisa Anda kendalikan adalah action yang Anda kirim dan kapan Anda memintanya.
Membaca nilai dari halaman
Sitekey berada di atribut data-sitekey atau di parameter k pada alamat frame widget. Untuk v3 dan key Enterprise berbasis skor, action adalah string di panggilan execute halaman. Enterprise menunjukkan dirinya lewat skrip enterprise dan panggilan pada objek enterprise. Panduan pemecah per varian membahasnya lebih dalam:
- Pemecah reCAPTCHA v2, untuk widget checkbox, invisible, dan callback
- Pemecah reCAPTCHA v3, untuk halaman berbasis skor
- Pemecah reCAPTCHA Enterprise, untuk kedua gaya
Memanggilnya dari mesin lain
CapSkip adalah aplikasi Windows, dan contoh di atas menghubunginya di 127.0.0.1. Jika skrip Anda berjalan di tempat lain, alihkan CapSkip ke mode Server dan arahkan pengaturan host ke PC Windows itu. Panduan penyiapan menjelaskan cara beralihnya di bagian pengaturan koneksi dan menyarankan IP publik statis untuk akses jarak jauh yang stabil. Mode Server membuat port bisa dijangkau dari alamat mana pun, karena CapSkip menambahkan aturan izinkan untuk port itu setiap kali dimulai. Untuk membatasi pemanggil, tambahkan aturan blokir Windows Firewall untuk alamat yang tidak Anda percaya.
FAQ
Apakah reCAPTCHA v2 atau v3 lebih sulit diotomatiskan?
Tidak ada yang memerlukan perkakas berbeda: keduanya adalah satu task dengan flag berbeda. Perbedaan praktisnya adalah v3 tidak punya widget untuk diamati. Anda menemukan action di skrip halaman, dan hasilnya bergantung pada skor Google yang tidak bisa Anda atur.
Apakah v3 pernah menampilkan challenge?
Tidak menurut Google, yang menyatakan v3 tidak pernah mengganggu pengguna. Situs yang menginginkan langkah terlihat setelah skor rendah harus membuatnya sendiri.
Enterprise itu v2 atau v3?
Keduanya. Enterprise adalah tingkat produk, jadi halamannya yang menentukan gayanya. Di CapSkip Anda menambahkan flag enterprise ke task v2 atau ke task v3, dan tidak ada hal lain dalam request yang berubah.
Bisakah saya memilih skor yang diperoleh CapSkip?
Tidak. CapSkip tidak punya pengaturan untuk itu. Kirim action yang tepat, minta token tepat sebelum request yang memakainya, dan baca hasilnya dari situs.
Mana yang sedang Anda pecahkan?
Lihat halamannya dulu: kotak atau pemicu tak terlihat berarti v2, panggilan execute dengan action berarti v3, dan skrip enterprise berarti flag pada keduanya. Lalu cocokkan baris di tabel request. Karena CapSkip berjalan di PC Windows Anda sendiri sebagai pemecah captcha tanpa batas, meminta token baru untuk setiap varian, atau meminta lagi setelah token kedaluwarsa, tidak menambah tagihan.
