Cara Memecahkan CAPTCHA di Activepieces (Piece HTTP)

Pemecahan captcha di Activepieces terdiri dari tiga langkah: kirim challenge, tunggu, baca token. Bangun alurnya di atas piece HTTP, bukan di langkah Code, karena apakah langkah Code bisa memakai npm sama sekali bergantung pada mode sandbox yang dijalankan instance Anda, dan mode yang dipakai Activepieces Cloud tidak memiliki npm. Piece HTTP bekerja di semua mode. Ada satu pengaturan kedua yang lebih menentukan daripada kodenya, dan pengaturan itu memutuskan apakah alur Anda bisa menjangkau pemecah di alamat privat sama sekali.

Apa yang Anda butuhkan

• Sebuah proyek Activepieces tempat Anda bisa mempublikasikan alur, di cloud mereka atau self-hosted.
• CapSkip yang berjalan di komputer Windows. Mode Local hanya cocok jika Activepieces berjalan di komputer yang sama, yang dalam praktiknya berarti instalasi self-hosted. Selain itu semuanya butuh mode Server.
• Sitekey dan URL halaman dari situs yang Anda otomatisasi.
• Sebuah variabel proyek yang menyimpan kunci pemecah, sehingga kunci itu tidak tertulis di badan alur.
• Pada instance self-hosted dengan jaringan yang diperketat, satu entri di daftar izin SSRF. Langkah 3 membahas hal ini.

Mengapa piece HTTP dan bukan langkah Code

Editor langkah Code punya dialog Add npm package. Dialog itu mencari paketnya di registry npm, mengunci versi terbaru dan menuliskannya ke daftar dependensi langkah tersebut. Di Activepieces Cloud daftar itu kemudian dibuang.

Activepieces membangun langkah Code dengan menulis kode sumber Anda ke sebuah file TypeScript, menginstal dependensinya dan membundel hasilnya. Proses build hanya meminta dependensi Anda jika mode eksekusi pada instance itu mengizinkan paket. Pada V8 sandboxing, yaitu mode yang menurut dokumentasi Activepieces dipakai cloud mereka, paket tidak diizinkan, sehingga proses build menggantinya dengan kumpulan dependensi kosong dan tetap mengompilasi. Langkahnya ter-deploy tanpa masalah. Import-nya baru gagal saat alur dijalankan.

Jadi ada dua cara jujur untuk melakukan ini, dan yang mana yang Anda dapat bukan pilihan Anda, melainkan pilihan administrator Anda. Jalur piece HTTP di bawah ini bekerja di keempat mode. Jalur langkah Code di akhir panduan ini bekerja di dua di antaranya dan jauh lebih singkat kalau Anda memilikinya.

Langkah 1: kirim challenge

CapSkip berbicara dengan API yang kompatibel dengan 2captcha di port 8080, sehingga piece HTTP bisa berkomunikasi dengannya tanpa konektor yang perlu diinstal. Tambahkan aksi Send HTTP Request, atur method ke POST dan URL ke endpoint submit pada pemecah Anda.

{
  "key": "{{variables['CAPSKIP_KEY']}}",
  "method": "userrecaptcha",
  "googlekey": "YOUR_SITEKEY",
  "pageurl": "https://example.com/page-with-recaptcha",
  "json": 1
}

Responsnya berupa objek JSON kecil yang bidang request-nya berisi id yang Anda pakai untuk polling.

{ "status": 1, "request": "2122988149" }

Itu untuk reCAPTCHA v2. Jenis lain yang didukung CapSkip memakai panggilan yang sama dengan parameter berbeda: tambahkan invisible atau enterprise yang diatur ke 1, atau version yang diatur ke v3 dengan nama action, atau ganti method menjadi turnstile atau geetest. Daftar parameter lengkapnya ada di dokumentasi API CapSkip.

Rujuk kuncinya dengan sintaks variabel proyek, jangan menempelkannya langsung. Variabel dienkripsi saat disimpan dan tidak pernah ditampilkan kembali kepada Anda di daftar variabel, dan mengganti satu variabel cukup satu kali edit, bukan berburu ke setiap alur.

Langkah 2: tunggu, lalu baca token

Tambahkan aksi Delay For, lalu permintaan HTTP kedua yang membaca hasilnya. Dua puluh detik adalah waktu tunggu pertama yang masuk akal untuk kotak centang reCAPTCHA v2. CAPTCHA gambar kembali dalam sekitar satu detik, v3 dalam sepuluh sampai lima belas detik, GeeTest sekitar lima detik.

# GET, with the id from step 1 in the query string.
http://127.0.0.1:8080/res.php?key=YOUR_KEY&action=get&id=2122988149&json=1

Ada dua jawaban yang mungkin. Hasil yang sudah siap berupa objek JSON dengan bentuk seperti respons submit, dengan tokennya di bidang request. Hasil yang belum siap berupa string CAPCHA_NOT_READY, dieja tanpa huruf T, dan artinya teruslah menunggu, bukan ada sesuatu yang salah. Riwayat ejaan itu ada di ulasan lengkap tentang respons CAPCHA_NOT_READY.

Piece Delay berperilaku berbeda di bawah dan di atas sepuluh detik, dan inilah detail yang membuat pola polling di sini jadi murah. Delay sepuluh detik atau kurang akan tidur di dalam proses worker. Apa pun yang lebih lama akan membuat waitpoint, menangguhkan eksekusi dan melanjutkannya ketika waktunya habis. Waktu tertangguh bukan waktu eksekusi, dan Activepieces mendokumentasikan bahwa alur yang dijeda oleh Delay atau oleh Wait for Approval tidak diperhitungkan terhadap batas waktu eksekusi. Jadi menunggu dua puluh detik tidak memakan apa pun dari jatah sepuluh menit Anda, begitu pula tunggu kedua.

Jika satu kali baca tidak cukup, tambahkan Delay lagi dan pembacaan lagi, bukan memakai loop. Ada dua alasan. Loop on Items menjalankan setiap item di daftar, jadi iterasinya tetap terjadi entah tokennya sudah datang atau belum, dan Router di dalamnya hanya menghemat pekerjaan di cabang itu, bukan perjalanan mengelilingi loop-nya. Yang lebih penting, hasil CapSkip hanya bisa dibaca sekali, jadi loop yang membaca ulang id yang sudah dikumpulkannya tidak mendapat token dua kali, melainkan mendapat error pada pembacaan kedua.

Langkah 3: pengaturan jaringan yang memblokir pemecah lokal

Ini bagian yang sering menjebak orang, dan ini khas Activepieces, bukan saran umum untuk orkestrator. Activepieces punya penjaga SSRF untuk kode alur, yang dikendalikan oleh variabel bernama AP_NETWORK_MODE. Nilai default-nya UNRESTRICTED. Jika diatur ke STRICT, engine akan menambal fungsi DNS lookup dan socket connect milik Node sebelum kode alur mana pun berjalan, dan menolak setiap koneksi yang alamatnya loopback, privat RFC1918, link-local atau metadata cloud. Ia melempar error bernama SSRFBlockedError.

Pemecah CAPTCHA di jaringan Anda sendiri persis berbentuk seperti yang diblokir penjaga itu. Baik 127.0.0.1 maupun alamat LAN seperti 192.168.1.40 ada di daftar tersebut. Itu penjaga yang sedang bekerja sebagaimana mestinya, bukan bug, dan Activepieces memberi Anda pengecualian resmi untuk itu: masukkan alamat pemecah ke AP_SSRF_ALLOW_LIST, yang menerima IP dan rentang CIDR dipisahkan koma dan berlaku untuk kode alur maupun untuk permintaan keluar milik server itu sendiri. Restart server setelah mengubahnya.

# On a self-hosted Activepieces with AP_NETWORK_MODE=STRICT,
# name the solver machine or its subnet so flows can reach it.
AP_SSRF_ALLOW_LIST=192.168.1.40,10.0.5.0/24

Terlepas dari penjaga itu, alurnya tetap harus bisa menjangkau komputer tersebut. CapSkip punya dua mode koneksi untuk ini. Local mengikat ke 127.0.0.1 dan hanya melayani perangkat itu. Server mengikat ke alamat jaringan atau IP publik Anda, sehingga mesin lain, host container atau platform hosting bisa menjangkau komputer Windows yang sama lewat API. Keduanya ada di bawah pengaturan koneksi, dan mode Server hanya mengubah di alamat mana pemecah mendengarkan. Perangkat kerasnya tetap milik Anda dan pemecahannya tetap tanpa batas.

Langkah 4: batas waktu dan percobaan ulang

Tiga angka menentukan apakah pemecahan yang lambat bisa bertahan, dan hanya satu di antaranya yang bisa Anda atur di dalam alur.

Angka webhook itulah yang menggigit. URL webhook yang berakhiran kata sync menahan koneksi HTTP tetap terbuka dan menjawab dengan hasil alur, dan ia menyerah setelah tiga puluh detik. Pemecahan reCAPTCHA v2 tidak selalu selesai dalam tiga puluh detik, jadi pemanggil yang memicu alur secara sinkron dan mengharapkan token kembali akan menerima HTTP 408 sementara alurnya terus berjalan di belakang. Picu alur secara asinkron dan biarkan ia mengirim token ke tempat yang Anda butuhkan, atau pecah pekerjaannya sehingga bagian sinkronnya tidak pernah menunggu pemecahan.

Retry on Failure layak diaktifkan untuk langkah pengiriman dan tidak untuk langkah pembacaan. Jeda mundurnya eksponensial dari basis dua detik, sehingga waktu tunggunya kira-kira empat, delapan dan enam belas detik sepanjang empat percobaan. Itu tepat untuk koneksi yang ditolak. Itu keliru untuk token yang sudah Anda kumpulkan, karena aturan baca sekali di atas.

Semuanya dalam satu langkah, di instance self-hosted

Jika administrator Anda menjalankan tanpa sandboxing atau dengan sandboxing namespace kernel, alur di atas menyusut menjadi satu langkah Code, karena SDK-nya melakukan polling untuk Anda. Tambahkan capskip di dialog npm, lalu tulis langkahnya. Langkah Code ditulis dalam TypeScript dan dibundel sebelum dijalankan, sehingga import biasa sudah cukup.

// npm install capskip - add it in the step's package dialog.
import { CapSkip } from 'capskip';

export const code = async (inputs) => {
  // host is the solver machine. Keep 127.0.0.1 only when
  // Activepieces runs on the same Windows box as CapSkip.
  const solver = new CapSkip({
    host: inputs.capskipHost,
    port: 8080,
    apiKey: inputs.capskipKey,
  });

  const result = await solver.recaptcha(inputs.sitekey, inputs.pageUrl);

  // Return the token, not the whole result. The next step
  // submits it, and run logs keep whatever you return.
  return { token: result.code };
};

Berikan capskipKey sebagai input langkah yang berisi rujukan variabel proyek, sehingga kuncinya diselesaikan saat runtime dan tidak pernah muncul di kode sumber. SDK mulai melakukan polling pada 250 milidetik lalu melambat secara bertahap, bukan tidur dengan interval tetap, dan itulah sebabnya versi ini biasanya kembali lebih cepat daripada alur berbasis Delay. Batas atasnya untuk reCAPTCHA, Turnstile dan GeeTest adalah 300 detik, jauh di dalam batas waktu aksi sepuluh menit.

Kirim tokennya di langkah yang langsung menyusul. Token reCAPTCHA berlaku sekitar dua menit, jadi alur yang memecahkan, menunggu di langkah persetujuan lalu mengirim akan gagal dengan token yang tadinya benar-benar valid saat dibuat. Mode kegagalan itu dibahas di panduan tentang kedaluwarsa token reCAPTCHA.

Kesalahan umum dan artinya

FAQ

Versi singkatnya

Bangun pemecahannya di atas piece HTTP, karena piece ini bekerja di semua mode sandbox sedangkan jalur langkah Code tidak. Kirim ke endpoint submit, beri delay lebih dari sepuluh detik supaya eksekusinya ditangguhkan alih-alih menduduki worker, lalu baca hasilnya sekali dan simpan. Taruh kuncinya di variabel proyek. Jika instance-nya self-hosted dengan mode jaringan yang ketat, tambahkan pemecah ke daftar izin SSRF, dan jika Activepieces berjalan di mana pun selain komputer pemecah itu sendiri, alihkan CapSkip ke mode Server. Jangan pernah menunggu pemecahan pada webhook sinkron.

• Kotak centang reCAPTCHA v2 itu sendiri dibahas di halaman pemecah reCAPTCHA v2.
• Versi satu panggilan yang setara dalam Python, Node.js, PHP dan C# tercantum di halaman SDK pemecahan CAPTCHA.

Satu hal yang layak ditimbang sebelum Anda menjadwalkan alur ini setiap beberapa menit: CapSkip adalah pemecah captcha tanpa batas yang berjalan di hardware yang sudah Anda miliki, jadi flow yang berjalan terus-menerus dan yang berjalan sesekali biayanya persis sama.