hCaptcha क्या है? Token, Siteverify और Enterprise की व्याख्या

hCaptcha एक bot check है जिसे आप फ़ॉर्म के सामने लगाते हैं। विज़िटर widget में एक challenge पास करता है, और widget फिर h-captcha-response नाम का token फ़ॉर्म में जोड़ देता है। आपका server उस token को hCaptcha को भेजकर पक्का करता है कि वह असली है। तो डेवलपर के लिए hCaptcha क्या है? यह एक widget, एक token और एक verification call है, और अगर किसी script को इसे पार करना है, तो आप इसी को संभालते हैं। यह गाइड बताती है कि इसे कैसे पहचानें, server क्या जाँचता है, हर error का क्या मतलब है और script क्या भेजती है।
CAPTCHA का सामान्य विचार समझने के लिए देखें: CAPTCHA क्या है और साइटें इसे क्यों इस्तेमाल करती हैं। यह पेज सिर्फ़ hCaptcha पर केंद्रित है।
आप पेज पर hCaptcha को कैसे पहचानते हैं
hCaptcha developer गाइड widget को h-captcha class वाले एक element के रूप में दिखाती है, जिस पर data-sitekey attribute होता है। CapSkip का hCaptcha पेज sitekey को public UUID कहता है। जब कोई script widget खुद बनाती है, तब sitekey hcaptcha.render() का एक parameter होता है, जिसे configuration गाइड बताती है। गाइड के अनुसार सफल challenge के बाद hCaptcha h-captcha-response token को form submission में जोड़ देता है।
तो तीन चीज़ें इसकी पहचान कराती हैं: h-captcha class वाला एक element, एक sitekey, और challenge पास होने के बाद h-captcha-response नाम का form फ़ील्ड। CapSkip API दस्तावेज़ जोड़ते हैं कि form में g-recaptcha-response नाम का दूसरा फ़ील्ड भी हो सकता है, जिसमें वही token भरना होता है।
Checkbox, invisible और Enterprise खाते
Checkbox और invisible दो widget मोड हैं। Enterprise एक खाता स्तर है जो दोनों में से कोई भी इस्तेमाल कर सकता है, और यह बदल देता है कि server के verification जवाब में क्या होता है। CapSkip इन सबके लिए एक ही method इस्तेमाल करता है।
- Checkbox। विज़िटर एक box पर टिक करता है और, CapSkip दस्तावेज़ों के अनुसार, कभी-कभी तस्वीरों वाला challenge हल करता है।
- Invisible। invisible गाइड कहती है कि आप element पर data-size को invisible सेट करते हैं, और तब widget बैकग्राउंड में render होता है और केवल तब दिखता है जब challenge की ज़रूरत हो। आपका पेज इसे hcaptcha.execute() से चलाता है, और token आपके callback function में जाता है।
- Enterprise। verification जवाब में दो और फ़ील्ड जुड़ जाते हैं, score और score_reason, जिन्हें hCaptcha गाइड केवल Enterprise के लिए बताती है। CapSkip में किसी task पर score का कोई option नहीं है। इससे जुड़ा एकमात्र स्विच hCaptcha के लिए High score mode है, जो नीचे FAQ में है।
कुछ Enterprise साइटें widget चलने से पहले hcaptcha.setData() के ज़रिए उसे rqdata नाम का एक मान भी देती हैं। सार्वजनिक hCaptcha दस्तावेज़ उसका वर्णन नहीं करते, इसलिए इस बारे में यहाँ सब कुछ CapSkip दस्तावेज़ों पर टिका है: साइट हर challenge के लिए एक मान जारी करती है और वह जल्दी बासी हो जाता है, इसलिए script को हर task के लिए नया मान चाहिए।
server token के साथ क्या करता है
server token को URL-encoded form body के रूप में https://api.hcaptcha.com/siteverify पर post करता है, और गाइड चेतावनी देती है कि JSON न भेजें। दो फ़ील्ड ज़रूरी हैं: खाते का secret और token, जो secret और response के नाम से भेजे जाते हैं। गाइड remoteip (उपयोगकर्ता का address) की सलाह देती है और sitekey को वैकल्पिक बताती है, यानी यह बताने का तरीका कि आप कौन सा sitekey उम्मीद करते हैं। JSON जवाब में success, challenge_ts, hostname और error-codes होते हैं।
token एक बार इस्तेमाल के हैं। गाइड जो एकमात्र उम्र बताती है वह 120 सेकंड का डिफ़ॉल्ट है, जो एक error code के वर्णन के भीतर आता है। CapSkip दस्तावेज़ इसे करीब दो मिनट बताते हैं। token submit करने से ठीक पहले माँगें।
Siteverify error और क्या जाँचें
ये कोड hCaptcha गाइड की error तालिका से हैं। script को आमतौर पर सिर्फ़ ठुकराया हुआ form दिखता है। आख़िरी कॉलम इस बात की व्याख्या है कि क्या जाँचना है, hCaptcha का लिखा पाठ नहीं।
| Error कोड | गाइड क्या कहती है | क्या जाँचें |
|---|---|---|
missing-input-response | token parameter गायब है। | form post में h-captcha-response फ़ील्ड नहीं था, या साइट कोई दूसरा नाम पढ़ती है। |
invalid-input-response | token अमान्य या गलत बना है। | मान form में जाते हुए कट गया, बदल गया या दो बार encode हो गया। |
expired-input-response | token expire हो चुका है (डिफ़ॉल्ट 120 सेकंड)। | हल करने और submit करने के बीच बहुत देर हो गई। हल करें, फिर तुरंत submit करें। |
already-seen-response | token एक बार पहले ही verify हो चुका है। | token दोबारा इस्तेमाल हुआ, या form post पुराने token के साथ retry हुआ। हर बार नया token माँगें। |
sitekey-secret-mismatch | sitekey दिए गए secret के साथ registered नहीं है। | यह server की तरफ़ की configuration समस्या है, ऐसी चीज़ नहीं जो script भेजती है। |
invalid-input-secret | secret key अमान्य या गलत बनी है। | यह भी server की तरफ़ है, साइट मालिक के कोड में। |
reCAPTCHA और Turnstile से तुलना
तीनों form में एक token डालते हैं और उसे server-side verify करते हैं, इसलिए फ़र्क नाम और संख्याओं का है। reCAPTCHA g-recaptcha-response इस्तेमाल करता है, और Google की verify गाइड कहती है कि token दो मिनट के लिए वैध है और एक ही बार verify हो सकता है। Turnstile cf-turnstile-response इस्तेमाल करता है, और Cloudflare की server-side validation गाइड 300 सेकंड और एक बार इस्तेमाल बताती है। CapSkip के Python SDK में calls hcaptcha(), recaptcha() और turnstile() हैं, जो 1.7.0 के source से लिए गए हैं।
CapSkip को request कैसी दिखती है
CapSkip आपके Windows PC पर चलता है और 2captcha request format बोलता है, इसलिए hCaptcha task दो HTTP call है। नीचे के दोनों curl.exe commands PowerShell और cmd में जैसे लिखे हैं वैसे चलते हैं। पहला task submit करता है और job id लौटाता है। दूसरा उसी id से poll करता है, और CAPCHA_NOT_READY का मतलब है कि कुछ सेकंड रुकें और फिर पूछें। फ़ील्ड data तभी जोड़ें जब पेज rqdata सेट करता हो। key तभी मायने रखती है जब CapSkip में API Key Validation चालू हो।
curl.exe -X POST -d "key=YOUR_API_KEY&method=hcaptcha&sitekey=YOUR_SITEKEY&pageurl=https://example.com/login&json=1" http://127.0.0.1:8080/in.php curl.exe "http://127.0.0.1:8080/res.php?key=YOUR_API_KEY&action=get&id=12345&json=1"
यही task Python SDK से एक call में हो जाता है, जो submit करती है, poll करती है और नतीजा लौटाती है। options हैं invisible, data (Enterprise का rqdata), userAgent और proxy। CapSkip आपका भेजा userAgent तभी इस्तेमाल करता है जब वह उस ब्राउज़र से मेल खाता हो जिससे वह हल करता है। नतीजे में token code और token के रूप में आता है, साथ में एक respKey, और वह User-Agent जिसने token कमाया।
# pip install capskip
from capskip import CapSkip
# The key matters only when API Key Validation is on in CapSkip.
solver = CapSkip(apiKey="YOUR_API_KEY", host="127.0.0.1", port=8080)
# For an Enterprise rqdata add data=RQDATA; for an invisible widget
# add invisible=1. Neither is needed for a plain checkbox.
result = solver.hcaptcha(
sitekey="YOUR_SITEKEY",
url="https://example.com/login",
)
# The token goes in h-captcha-response, sent with this User-Agent.
print(result["code"][:12], result["userAgent"])दोनों block CapSkip के एक mock पर चले, असली app पर नहीं, और हर एक ने दिए गए sitekey और पेज के पते के साथ method=hcaptcha भेजा। कोई असली solve नहीं हुआ, इसलिए यहाँ solve के समय या सफलता दर के बारे में कोई दावा नहीं है। पूरी script और हर parameter यहाँ हैं: CapSkip hCaptcha सॉल्वर पेज। method की सूची यहाँ है: CapSkip API दस्तावेज़.
- Python में capskip SDK के साथ hCaptcha
- ताज़ा rqdata के साथ Node.js में hCaptcha Enterprise
- HCaptchaAsync के साथ C# में hCaptcha
सर्वर पर CapSkip चलाना
अगर आपकी script किसी दूसरी मशीन पर चलती है, तो CapSkip को Server mode में बदलें और host सेटिंग को उसी मशीन पर सेट करें। सेटअप गाइड में कनेक्शन सेटिंग्स दोनों मोड समझाती हैं, और Server mode के लिए CapSkip का administrator के रूप में चलना ज़रूरी है, और मशीन आपके नियंत्रण वाला Windows PC ही रहती है। जाँचें कि कौन से address port तक पहुँच सकते हैं, और जिन्हें नहीं पहुँचना चाहिए उनके लिए Windows Firewall का block rule जोड़ें। क्योंकि solve उसी मशीन पर होता है, hCaptcha को उसका नेटवर्क दिखता है, इसलिए अगर साइट के लिए यह मायने रखता है, तो task के साथ proxy लगाएँ।
अक्सर पूछे जाने वाले सवाल
क्या hCaptcha और reCAPTCHA एक ही हैं?
नहीं। ये अलग सेवाएँ हैं जिनके अपने widget, फ़ील्ड नाम और verification host हैं। script को सही फ़ील्ड भेजना होगा और CapSkip से सही method माँगना होगा।
मैं कैसे जानूँ कि कोई साइट hCaptcha Enterprise इस्तेमाल करती है?
हमेशा front end से नहीं। CapSkip दस्तावेज़ कहते हैं कि कुछ Enterprise साइटें widget चलने से पहले hcaptcha.setData() को rqdata मान देती हैं। अगर आपको वह call दिखे, तो मान को data option के रूप में भेजें, हर task के लिए ताज़ा। अगर नहीं दिखे, तो सामान्य रूप से हल करें और साइट के token ठुकराने पर High score mode आज़माएँ।
CapSkip का लौटाया token form क्यों ठुकरा देता है?
CapSkip दस्तावेज़ आम कारण बताते हैं: पुराना या पहले ही इस्तेमाल हुआ token, ऐसा sitekey जो पेज से मेल नहीं खाता, या ऐसा User-Agent जो जवाब वाले से अलग है। सख़्त साइटों के लिए वे hCaptcha की High score mode सेटिंग जोड़ते हैं, जो Settings, Captcha types में है और जिसके लिए CapSkip वाले PC पर Google Chrome चाहिए।
क्या मैं hCaptcha tasks के लिए CapSkip को server पर चला सकता हूँ?
हाँ। अपने नियंत्रण वाली Windows मशीन पर Server mode इस्तेमाल करें और अपनी script को उसके address पर लगाएँ।
संक्षेप में
hCaptcha एक widget है जो एक single-use token पर खत्म होता है, जिसे hCaptcha के siteverify पते पर एक बार जाँचा जाता है। आपके अपने Windows PC पर चलने वाला एक लोकल captcha सॉल्वर checkbox, invisible और Enterprise, तीनों मामलों को एक ही method से संभालता है, और प्रति-हल शुल्क नहीं लगता।
