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

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

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.

VarianField yang dikirim ke in.phpPanggilan PythonPanggilan Node.js
v2 checkboxgooglekey, pageurlrecaptcha(sitekey, url)recaptcha(sitekey, url)
v2 invisiblemenambah invisible=1menambah invisible=1options dengan invisible diatur ke 1
v3menambah version=v3 dan sebuah actionversion="v3", action="login"options dengan version diatur ke v3 dan sebuah action
Enterprise v2menambah enterprise=1menambah enterprise=1options dengan enterprise diatur ke 1
Enterprise v2 invisiblemenambah enterprise=1 dan invisible=1kedua keyword argumentkedua options
Enterprise v3menambah version=v3, sebuah action, dan enterprise=1ketiga keyword argumentketiga 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 field

Untuk 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 named

SDK 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.

VarianDari mana token berasalPemeriksaan backendField yang bisa dibaca
v2 checkboxWidget, dikirim sebagai g-recaptcha-responseVerifikasi klasikSuccess, waktu challenge, hostname
v2 invisiblePanggilan execute atau tombol yang terikat, diteruskan ke callbackVerifikasi klasikSuccess, waktu challenge, hostname
v3Panggilan execute yang menyebut sebuah actionVerifikasi klasikMenambah score dan action
Enterprise, key berbasis skorPanggilan execute enterpriseSebuah assessment di backendValiditas token, action, skor risiko
Enterprise, key checkboxWidget yang dirender dari skrip enterpriseSebuah assessment di backendValiditas 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:

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.