Explainers

GeeTest v4 CAPTCHA: Perubahan dan Panduan Solve

Integrasi GeeTest yang tadinya lancar tiba-tiba menolak setiap token, dan di source halaman muncul gcaptcha4. Itu tanda Anda berhadapan dengan GeeTest v4 — versi yang merombak cara inisialisasi, tipe challenge, sekaligus validasi dibanding v3. Jawaban singkat soal dukungan: CaptchaAI menyelesaikan GeeTest v3. CaptchaAI tidak menyelesaikan GeeTest v4. Artikel ini memetakan apa saja yang berubah, cara memastikan sebuah situs memakai v4, dan di mana posisi CaptchaAI.

Ringkasan singkat sebelum mulai

  • Deteksi versi dulu. Skrip gcaptcha4/gt4.js berarti v4; api.geetest.com + parameter challenge berarti v3.
  • v3 didukung di CaptchaAI dengan tingkat keberhasilan tinggi.
  • v4 tidak didukung — CaptchaAI tidak menyelesaikan GeeTest v4.
  • Token validasi berbeda: v4 memakai captcha_id, lot_number, dan pass_token.

Cara memastikan situs memakai v3 atau v4

Sebelum menulis kode apa pun, pastikan dulu versinya. Penanda paling andal ada di source halaman: skrip gcaptcha4 atau gt4.js menandakan v4, sedangkan api.geetest.com plus parameter challenge menandakan v3. Karena widget dirender lewat JavaScript, ambil source setelah halaman termuat penuh — Selenium cocok untuk kebutuhan ini. Salah menebak versi adalah penyebab error paling umum: memakai alur v3 pada halaman v4 akan langsung ditolak server.

# extract_geetest_v4.py
import re
from selenium import webdriver


def extract_geetest_v4_params(url):
    """Extract GeeTest v4 captcha_id from a page."""
    driver = webdriver.Chrome()
    driver.get(url)

    page_source = driver.page_source

    # GeeTest v4 uses captcha_id instead of gt
    match = re.search(r'captcha_id["\']?\s*[:=]\s*["\']([a-f0-9]+)', page_source)
    captcha_id = match.group(1) if match else None

    # Check for v4-specific script
    is_v4 = "gcaptcha4" in page_source or "gt4.js" in page_source

    driver.quit()

    return {
        "captcha_id": captcha_id,
        "is_v4": is_v4,
        "pageurl": url,
    }


# Usage
params = extract_geetest_v4_params("https://staging.example.com/qa-login")
print(f"Captcha ID: {params['captcha_id']}")
print(f"Is v4: {params['is_v4']}")

Perubahan utama dari v3 ke v4

Perubahan v4 bukan sekadar tampilan. Arsitektur inisialisasi dan alur validasinya berbeda, sehingga kode v3 lama Anda tidak akan langsung jalan.

Aspek GeeTest v3 GeeTest v4
Inisialisasi gt + challenge dari server cukup captcha_id
Parameter challenge diambil dari API call dibuat di sisi client
Tipe challenge slide, klik slide, klik, pilih ikon, penalaran spasial
Validasi server mengembalikan challenge memakai lot_number + pass_token
Endpoint API api.geetest.com gcaptcha4.geetest.com
Tingkat kesulitan tetap adaptive risk scoring

Posisi CaptchaAI

Perlu ditegaskan tanpa ambigu: CaptchaAI menyelesaikan GeeTest v3. CaptchaAI tidak menyelesaikan GeeTest v4. Metode geetest menerima nilai v3 (gt, challenge yang baru, dan pageurl) lalu mengembalikan challenge, validate, dan seccode. Metode ini tidak punya parameter v4, jadi jangan kirim captcha_id v4 sebagai gt. Jalankan pengecekan di atas lebih dulu: bila halaman memuat gcaptcha4.geetest.com atau gt4.js, halaman itu memakai v4 dan CaptchaAI tidak bisa menyelesaikannya. Bila halaman masih memakai v3, Cara Solve GeeTest v3 Menggunakan API menjelaskan alurnya secara lengkap.

Bedanya validasi di v4

Di halaman v3, verifikasi yang lolos menghasilkan tiga nilai, geetest_challenge, geetest_validate, dan geetest_seccode, yang lalu diperiksa backend situs ke GeeTest. Di halaman v4, captchaObj.getValidate() justru mengembalikan empat nilai: lot_number, captcha_output, pass_token, dan gen_time. Backend situs mengirim keempatnya ke endpoint /validate v4 milik GeeTest di gcaptcha4.geetest.com, bersama captcha_id situs itu dan sign_token yang ditandatangani dengan private key-nya (dokumentasi GeeTest v4: web API dan server API). Kode yang membaca atau mengisi tiga field v3 tidak menemukan apa pun untuk diolah di halaman v4.

Empat tipe challenge v4

Slide puzzle

Challenge slide klasik: pengguna menarik potongan puzzle ke posisi yang pas.

Seleksi klik

Pengguna mengklik objek tertentu (misalnya "klik semua wajah"), memakai pengenalan ikon.

Penalaran spasial

Baru di v4 — pengguna menyusun bentuk mengikuti pola spasial. Lebih kompleks dibanding challenge v3 mana pun.

Pencocokan ikon

Pengguna mencocokkan ikon yang muncul secara berurutan. Jauh lebih sulit diautomasi secara manual.

Tipe mana pun yang muncul di sebuah halaman, itu tetap GeeTest v4, dan CaptchaAI tidak bisa menyelesaikannya. CaptchaAI menyelesaikan GeeTest v3.

Menangani halaman v4 di pipeline

Contoh dari lapangan: tim monitoring harga di Jakarta yang menjalankan worker scraping di region AWS ap-southeast-1 (Singapura) mulai menemukan challenge v4 di sebagian target. Karena CaptchaAI tidak menyelesaikan GeeTest v4, susun pipeline agar job v4 tidak dikirim ke solver:

  1. Tambahkan deteksi versi di awal — bila gcaptcha4 terdeteksi, tandai job sebagai v4.
  2. Pisahkan job v4 dari alur solve dan catat metriknya, sambil tetap memproses target v3 seperti biasa.

Adaptive risk scoring v4 berarti frekuensi challenge bisa naik seiring pola trafik, sehingga logging metrik deteksi sejak awal membantu memperkirakan beban. Ingat juga UU Pelindungan Data Pribadi (UU 27/2022): kumpulkan hanya data yang memang berhak Anda proses.

Pemecahan masalah

Gejala Penyebab Solusi
pencarian gt / challenge tidak menemukan apa pun di halaman yang dulu berjalan situs pindah ke GeeTest v4, yang tidak punya challenge dari server cek gcaptcha4.geetest.com atau gt4.js di halaman; CaptchaAI hanya menyelesaikan GeeTest v3
ERROR_WRONG_CAPTCHA_ID dari CaptchaAI gt atau challenge tidak valid, misalnya captcha_id v4 yang dikirim sebagai gt kirim gt v3 milik halaman dan challenge baru untuk setiap request
captcha_id tidak ketemu nilainya dirender via JavaScript ambil dari halaman yang sudah dirender memakai Selenium

Pertanyaan umum

Apakah CaptchaAI menyelesaikan GeeTest v4?

Tidak. CaptchaAI menyelesaikan GeeTest v3 dengan tingkat keberhasilan tinggi. CaptchaAI tidak menyelesaikan GeeTest v4, jadi tidak ada angka keberhasilan v4 yang bisa diberikan.

Parameter apa yang berbeda antara v3 dan v4?

v3 memerlukan gt dan challenge dari server, sedangkan v4 cukup captcha_id di awal lalu mengembalikan lot_number dan pass_token pada tahap validasi.

Bagaimana cara memastikan sebuah situs memakai v4?

Cari gcaptcha4.geetest.com atau gt4.js di source halaman untuk v4. Bila yang muncul api.geetest.com dan parameter challenge, itu v3.

Apakah GeeTest v3 masih relevan dipelajari?

Sangat. GeeTest v3 adalah versi yang didukung CaptchaAI, dan banyak situs masih memakainya. CaptchaAI tidak menyelesaikan GeeTest v4.

Panduan terkait

Solve GeeTest v3 — mulai dengan CaptchaAI. CaptchaAI tidak menyelesaikan GeeTest v4.

Komentar dinonaktifkan untuk artikel ini.