Activepieces में कैप्चा कैसे हल करें (HTTP Piece)

एक Activepieces कैप्चा हल तीन steps का होता है: challenge submit करें, इंतज़ार करें, token पढ़ें। इसे किसी Code step के बजाय HTTP piece पर बनाएं, क्योंकि कोई Code step npm का इस्तेमाल कर भी सकता है या नहीं, यह इस पर निर्भर करता है कि आपका instance किस sandbox mode में चलता है, और Activepieces Cloud जिस mode का इस्तेमाल करता है उसमें npm नहीं है। HTTP piece हर mode में काम करता है। एक दूसरी setting है जो code से भी ज़्यादा मायने रखती है, और वही तय करती है कि आपका flow किसी private address पर मौजूद सॉल्वर तक पहुँच भी सकता है या नहीं।

आपको क्या चाहिए

• एक Activepieces project जिसमें आप कोई flow publish कर सकें, उनके cloud पर या self-hosted।
• एक Windows machine पर चलता हुआ CapSkip। Local mode तभी ठीक है जब Activepieces उसी machine पर चले, जिसका व्यवहार में मतलब है एक self-hosted install। बाक़ी हर स्थिति में Server mode चाहिए।
• जिस साइट को आप ऑटोमेट कर रहे हैं उसका sitekey और पेज URL।
• एक project variable जिसमें सॉल्वर key रखी हो, ताकि वह flow body में न बैठी रहे।
• किसी hardened network वाले self-hosted instance पर, SSRF allow list में एक entry। Step 3 इसे कवर करता है।

HTTP piece क्यों और Code step क्यों नहीं

Code step editor में एक Add npm package dialog होता है। यह package को npm registry में खोजता है, latest version को pin करता है और उसे उस step की dependency list में लिख देता है। Activepieces Cloud पर वह list फिर फेंक दी जाती है।

Activepieces किसी Code step को इस तरह build करता है: आपका source एक TypeScript file में लिखता है, उसकी dependencies install करता है और नतीजे को bundle कर देता है। build आपकी dependencies तभी माँगता है जब उस instance का execution mode packages की इजाज़त देता हो। V8 sandboxing में, जिसे Activepieces अपने documentation में उस mode के रूप में बताता है जिस पर उनका cloud चलता है, packages की इजाज़त नहीं है, इसलिए build एक खाली dependency set रख देता है और फिर भी compile कर देता है। step साफ़-सुथरा deploy हो जाता है। import तब विफल होता है जब flow चलता है।

तो इसे करने के दो ईमानदार तरीक़े हैं, और आपको कौन-सा मिलेगा यह आपकी नहीं, आपके administrator की पसंद है। नीचे दिया गया HTTP piece वाला रास्ता चारों में काम करता है। इस गाइड के आख़िर में दिया गया Code step वाला रास्ता उनमें से दो में काम करता है और जब वह उपलब्ध हो तो कहीं छोटा पड़ता है।

Step 1: challenge submit करें

CapSkip port 8080 पर 2captcha-compatible API बोलता है, इसलिए HTTP piece बिना कोई connector install किए उससे बात कर लेता है। एक Send HTTP Request action जोड़ें, method को POST पर सेट करें और URL को अपने सॉल्वर के submit endpoint पर।

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

response एक छोटा JSON object होता है जिसके request field में वह id होती है जिससे आप poll करते हैं।

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

यह reCAPTCHA v2 है। CapSkip जिन दूसरे प्रकारों को सपोर्ट करता है वे वही call हैं, बस अलग parameters के साथ: invisible या enterprise को 1 पर सेट करके जोड़ें, या version को किसी action name के साथ v3 पर सेट करें, या method को turnstile या geetest में बदल दें। पूरी parameter सूची यहाँ है CapSkip API डॉक्यूमेंटेशन.

key को paste करने के बजाय project variable syntax से reference करें। Variables at rest encrypted होते हैं और variables list में आपको कभी वापस दिखाए नहीं जाते, और किसी एक को rotate करना हर flow में खोजबीन करने के बजाय एक ही edit होता है।

Step 2: इंतज़ार करें, फिर token पढ़ें

एक Delay For action जोड़ें, फिर एक दूसरा HTTP request जो नतीजा पढ़े। किसी reCAPTCHA v2 checkbox के लिए बीस सेकंड पहली बार का समझदार इंतज़ार है। Image कैप्चा लगभग एक सेकंड में लौट आते हैं, v3 दस से पंद्रह में, GeeTest लगभग पाँच में।

# 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

दो जवाब मुमकिन हैं। तैयार नतीजा submit response जैसा एक JSON object होता है, जिसके request field में token होता है। जो नतीजा अभी तैयार नहीं है वह string CAPCHA_NOT_READY होता है, जो बिना T के लिखा जाता है, और इसका मतलब है कि इंतज़ार जारी रखें, न कि कुछ ग़लत हो गया। उस वर्तनी का इतिहास यहाँ है CAPCHA_NOT_READY response का पूरा विवरण.

Delay piece दस सेकंड के इस पार और उस पार अलग-अलग व्यवहार करता है, और यही वह बारीकी है जो यहाँ polling के इस ढाँचे को सस्ता बना देती है। दस सेकंड या उससे कम का delay worker process में ही सोता है। इससे लंबा कुछ भी एक waitpoint बनाता है, run को suspend कर देता है और घड़ी पूरी होने पर उसे फिर से चालू कर देता है। Suspended समय execution समय नहीं है, और Activepieces अपने documentation में बताता है कि Delay या Wait for Approval से रुके हुए flows run timeout में नहीं गिने जाते। इसलिए बीस सेकंड का इंतज़ार आपके दस मिनट के बजट में कुछ भी ख़र्च नहीं करता, और दूसरा इंतज़ार भी नहीं।

अगर एक बार पढ़ना काफ़ी न हो, तो loop की ओर बढ़ने के बजाय एक और Delay और एक और read जोड़ें। दो वजहें। Loop on Items सूची के हर item को चलाता है, इसलिए iterations तब भी होते हैं जब token पहले ही आ चुका हो, और उसके अंदर रखा Router आपका काम loop का चक्कर बचाने के बजाय सिर्फ़ उस branch में बचाता है। इससे भी ज़्यादा अहम बात, किसी CapSkip नतीजे को एक ही बार पढ़ा जा सकता है, इसलिए ऐसा loop जो पहले ही ले चुकी id को दोबारा पढ़ता है उसे token दो बार नहीं मिलता, दूसरी बार पढ़ने पर उसे एक error मिलती है।

Step 3: वह network setting जो किसी local सॉल्वर को ब्लॉक कर देती है

यही वह हिस्सा है जिसमें लोग फँसते हैं, और यह सामान्य orchestrator सलाह के बजाय ख़ास Activepieces की बात है। Activepieces में flow code के लिए एक SSRF guard है, जिसे AP_NETWORK_MODE नाम का एक variable नियंत्रित करता है। यह डिफ़ॉल्ट रूप से UNRESTRICTED रहता है। STRICT पर सेट होने पर engine किसी भी flow code के चलने से पहले Node की DNS lookup और socket connect को patch कर देता है, और ऐसे हर connection से इनकार कर देता है जिसका address loopback, RFC1918 private, link-local या cloud metadata हो। यह SSRFBlockedError नाम की एक error फेंकता है।

आपके अपने network पर मौजूद कोई कैप्चा सॉल्वर ठीक उसी शक्ल का होता है जिसे वह guard ब्लॉक करता है। 127.0.0.1 और 192.168.1.40 जैसा कोई LAN address, दोनों उस सूची में हैं। यह guard का अपना काम है, कोई bug नहीं, और Activepieces इसके लिए एक documented अपवाद देता है: सॉल्वर का address AP_SSRF_ALLOW_LIST में डालें, जो comma से अलग किए गए IPs और CIDR ranges लेता है और flow code तथा server के अपने outbound requests, दोनों पर एक जैसा लागू होता है। इसे बदलने के बाद server को restart करें।

# 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

guard से अलग, flow का उस machine तक पहुँच पाना भी ज़रूरी है। CapSkip के पास इसके लिए दो connection modes हैं। Local mode 127.0.0.1 से bind होता है और सिर्फ़ उसी device को सेवा देता है। Server mode आपके network address या public IP से bind होता है, ताकि कोई दूसरा box, कोई container host या कोई hosted platform उसी Windows machine तक API के ज़रिए पहुँच सके। दोनों यहाँ मौजूद हैं कनेक्शन सेटिंग्स, और Server mode सिर्फ़ यह बदलता है कि सॉल्वर किस address पर सुनता है। hardware अब भी आपका ही है और हल अब भी बिना मीटर वाला है।

Step 4: timeouts और retries

तीन संख्याएँ तय करती हैं कि कोई धीमा हल बचता है या नहीं, और उनमें से सिर्फ़ एक ऐसी है जिसे आप flow में सेट करते हैं।

webhook वाली संख्या ही काटती है। sync शब्द पर ख़त्म होने वाला कोई webhook URL HTTP connection खुला रखता है और flow के नतीजे के साथ जवाब देता है, और तीस सेकंड बाद हार मान लेता है। कोई reCAPTCHA v2 हल तीस सेकंड के अंदर भरोसे से पूरा नहीं होता, इसलिए जो caller flow को synchronously trigger करता है और वापस token की उम्मीद करता है उसे HTTP 408 मिलता है, जबकि flow उसके पीछे चलता रहता है। flow को asynchronously trigger करें और उससे token वहाँ post करवाएँ जहाँ आपको चाहिए, या काम को इस तरह बाँटें कि synchronous हिस्सा कभी किसी हल का इंतज़ार न करे।

Retry on Failure को submit step के लिए चालू करना फ़ायदेमंद है, read step के लिए नहीं। इसका backoff दो सेकंड के base से exponential है, इसलिए चार कोशिशों में इंतज़ार लगभग चार, आठ और सोलह सेकंड होते हैं। यह उस connection के लिए सही है जिसे refuse कर दिया गया हो। यह उस token के लिए ग़लत है जिसे आप पहले ही ले चुके हैं, ऊपर बताए गए एक बार पढ़ने वाले नियम की वजह से।

पूरा काम एक ही step में, किसी self-hosted instance पर

अगर आपका administrator कोई sandboxing नहीं चलाता या kernel namespace sandboxing चलाता है, तो ऊपर वाला flow एक ही Code step में सिमट जाता है, क्योंकि SDK आपके लिए poll करता है। npm dialog में capskip जोड़ें, फिर step लिखें। Code steps TypeScript हैं, चलने से पहले bundle होते हैं, इसलिए एक साधारण import काम कर जाता है।

// 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 };
};

capskipKey को एक step input के रूप में पास करें जिसमें project variable का reference हो, ताकि key run time पर resolve हो और source में कभी दिखाई न दे। SDK किसी तय अंतराल पर सोने के बजाय 250 milliseconds से polling शुरू करता है और फिर धीमा होता जाता है, यही वजह है कि यह version आम तौर पर Delay आधारित flow से जल्दी लौटता है। reCAPTCHA, Turnstile और GeeTest के लिए इसकी अधिकतम सीमा 300 सेकंड है, जो दस मिनट के action timeout के भीतर आराम से आ जाती है।

token को ठीक अगले step में submit करें। कोई reCAPTCHA token लगभग दो मिनट तक चलता है, इसलिए ऐसा flow जो हल करता है, किसी approval step पर रुकता है और फिर submit करता है, वह उस token पर विफल होगा जो बनते समय बिल्कुल वैध था। उस विफलता को इस गाइड में कवर किया गया है reCAPTCHA token की समय समाप्ति.

आम errors और उनका मतलब

FAQ

संक्षेप में

हल को HTTP piece पर बनाएं, क्योंकि यह हर sandbox mode में काम करता है और Code step वाला रास्ता नहीं करता। submit endpoint पर submit करें, दस सेकंड से आगे का delay रखें ताकि run किसी worker को घेरने के बजाय suspend हो जाए, फिर नतीजा एक बार पढ़ें और उसे रख लें। key को किसी project variable में रखें। अगर instance self-hosted है और उसका network mode strict है, तो सॉल्वर को SSRF allow list में जोड़ें, और अगर Activepieces सॉल्वर की अपनी machine के अलावा कहीं और चलता है, तो CapSkip को Server mode पर स्विच करें। किसी synchronous webhook पर हल का इंतज़ार कभी न करें।

• reCAPTCHA v2 checkbox ख़ुद यहाँ कवर किया गया है reCAPTCHA v2 सॉल्वर पेज.
• Python, Node.js, PHP और C# में इसके बराबर के one-call versions यहाँ दिए गए हैं CAPTCHA solving SDK पेज.

इस flow को हर कुछ मिनट पर schedule करने से पहले एक बात तौलने लायक़ है: CapSkip एक असीमित कैप्चा सॉल्वर है, जो उसी हार्डवेयर पर चलता है जो पहले से आपका है, इसलिए लगातार चलने वाले flow और कभी-कभार चलने वाले flow, दोनों की लागत बिल्कुल एक जैसी है।