Cloudflare Turnstile क्या है? मोड, Token और Verification

Cloudflare Turnstile क्या है? यह Cloudflare का एक CAPTCHA विकल्प है। यह तस्वीरों वाली पहेलियों की जगह बैकग्राउंड में चलने वाली जाँचों से विज़िटर को परखता है, और विज़िटर के पास होने पर पेज को एक token मिलता है, जिसे साइट का server फिर Cloudflare से verify करता है। यह गाइड तीन widget मोड, token और उसकी सीमाएँ, verification का तरीका, और widget तथा full-page challenge में फ़र्क पहचानना बताती है।
विज़िटर को क्या दिखता है: तीन widget मोड
Cloudflare अपने widget दस्तावेज़में तीन मोड बताता है। साइट का मालिक widget बनाते समय उनमें से एक चुनता है।
| मोड | विज़िटर को क्या दिखता है |
|---|---|
| Managed mode | Cloudflare तय करता है कि non-interactive जाँच चले या checkbox, इसलिए checkbox तभी दिखता है जब आगे और जाँच की ज़रूरत हो |
| Non-interactive mode | जाँच चलने के दौरान loading spinner वाला widget, और विज़िटर से कभी कुछ करने को नहीं कहा जाता |
| Invisible mode | कुछ भी नहीं: न widget, न spinner, और जाँचें बैकग्राउंड में चलती हैं |
इन तीनों में से कोई भी विज़िटर से बिगड़े हुए अक्षर पढ़ने या तस्वीरें चुनने को नहीं कहता। Cloudflare के overview के अनुसार, widget इस्तेमाल करने के लिए साइट को अपना ट्रैफ़िक Cloudflare से गुज़ारना ज़रूरी नहीं है, लेकिन उसे बनाने के लिए मालिक के पास Cloudflare खाता होना चाहिए।
Cloudflare Turnstile पेज को क्या देता है? एक token
डेवलपर के लिए बात तीन चीज़ों पर आती है: cf-turnstile-response नाम का एक form फ़ील्ड, server पर एक verification call, और जब आप इसे इस्तेमाल करने वाली साइट को ऑटोमेट करते हैं, तो एक token जो आपको खुद देना होता है। जब widget किसी form के अंदर होता है, तो Cloudflare के अनुसार वह cf-turnstile-response नाम का एक छिपा हुआ input जोड़ता है, जो बाकी फ़ील्ड के साथ server तक जाता है। widget को implicit तरीके से render किया जा सकता है, जिसमें वह markup में cf-turnstile class वाला element ढूँढता है, या explicit तरीके से, पेज की script से turnstile.render() call करके। जो पेज explicit render करता है वह callback भी दे सकता है, और CapSkip API दस्तावेज़ कहते हैं कि अगर पेज में callback तय है, तो उसे लौटे हुए token के साथ चलाएँ।
token की उम्र कम होती है। server-side validation गाइड के अनुसार हर token 300 सेकंड के लिए वैध है और सिर्फ़ एक बार इस्तेमाल के लिए है, और Cloudflare अपने नेटवर्क में redemption को कुछ देरी से ट्रैक करता है। इसलिए लंबी script की शुरुआत में माँगा गया token फ़ॉर्म भेजे जाने तक खर्च हो चुका या बासी हो सकता है।
server token को कैसे verify करता है
फ़ील्ड मिल जाना अपने आप में कुछ साबित नहीं करता। Cloudflare server-side validation को अनिवार्य बताता है: साइट token और अपनी secret key को siteverify endpointपर भेजती है और JSON जवाब पढ़ती है। यह भेजना https://challenges.cloudflare.com/turnstile/v0/siteverify पर एक POST है। दस्तावेज़ में दिए मान नीचे हैं।
| दिशा | मान | अर्थ |
|---|---|---|
| भेजा गया | secret (ज़रूरी) | widget की secret key |
| भेजा गया | response (ज़रूरी) | form फ़ील्ड से मिला token |
| भेजा गया | remoteip (वैकल्पिक) | विज़िटर का IP address |
| भेजा गया | idempotency_key (वैकल्पिक) | आपका बनाया UUID, ताकि उसी जाँच का retry सुरक्षित रहे |
| लौटाया गया | success | validation पास हुई या नहीं |
| लौटाया गया | challenge_ts, hostname | challenge कब हल हुआ और कहाँ परोसा गया |
| लौटाया गया | error-codes | ऐसी सूची जैसे missing-input-response या timeout-or-duplicate |
| लौटाया गया | action, cdata | पेज ने widget पर जो custom मान सेट किए |
Cloudflare सात error code बताता है, और यहाँ दो मायने रखते हैं। कोड missing-input-response का मतलब है कि Cloudflare तक कोई token पहुँचा ही नहीं, और timeout-or-duplicate का मतलब है कि token expire हो गया या पहले ही validate हो चुका है। दस्तावेज़ में दिए जवाब में कोई score नहीं होता: नतीजा pass या fail होता है, साथ में वे action और cdata मान जो आपके पेज ने सेट किए, ताकि server उन्हें जाँच सके। यह दस्तावेज़ में दिए फ़ील्ड की व्याख्या है, इस बारे में Cloudflare का कोई बयान नहीं कि वह क्या कभी नहीं लौटाता।
Widget या challenge पेज: यह कौन सा Turnstile है?
widget एक चीज़ है और full-page challenge दूसरी। widget उस पेज का एक element है जो पहले ही लोड हो चुका है। challenge पेज वह है जो Cloudflare साइट की जगह दिखाता है, किसी भी content के आने से पहले। Cloudflare का clearance दस्तावेज़ कहता है कि ऐसा challenge हल करने पर एक cf_clearance cookie सेट होती है, जो विज़िटर और डिवाइस से बँधी होती है। वह यह भी कहता है कि pre-clearance चालू वाला widget वह cookie जारी कर सकता है, जबकि डिफ़ॉल्ट रूप से widget एक बार इस्तेमाल होने वाला token जारी करता है। आप क्या देख रहे हैं, यह तय करने के लिए इस तालिका का इस्तेमाल करें।
| आप जो देखते हैं | यह क्या है | CapSkip को आपसे क्या चाहिए |
|---|---|---|
| form के अंदर एक box या spinner, और HTML में cf-turnstile-response input | widget, managed या non-interactive mode में | sitekey और पेज का पूरा पता। token फ़ील्ड में जाता है |
| एक form जो token के बिना फ़ेल होता है, पर स्क्रीन पर कोई box नहीं | invisible mode वाला widget, या ऐसा widget जो render नहीं हुआ | वही दो मान। sitekey को markup में या render call में ढूँढें |
| एक पूरा पेज जिस पर साइट लोड होने से पहले "Just a moment" लिखा आता है | full-page challenge | CapSkip के दो रास्ते। एक Turnstile token request, जिसमें action, data और pagedata तब जाते हैं जब पेज उन्हें turnstile.render को देता है, या नीचे बताई गई cf_clearance cookie request |
CapSkip से Turnstile token पाना
CapSkip आपके अपने Windows PC पर चलता है और 2captcha request format में 127.0.0.1:8080 पर जवाब देता है, और लाइसेंस वाली कॉपी पर प्रति-हल शुल्क नहीं लगता। Cloudflare Turnstile सॉल्वर पेज प्रोडक्ट के बारे में बताता है, और API दस्तावेज़ यहाँ इस्तेमाल हुए parameters की सूची देते हैं। अगर आपकी script किसी दूसरी मशीन पर चलती है, तो CapSkip को Server mode में बदलें और उस PC का address host के रूप में दें, जैसा सेटअप गाइड का कनेक्शन सेटिंग्स सेक्शन समझाता है। Server mode शुरू होने पर CapSkip अपना port हर address के लिए खोल देता है, इसलिए उसे सिर्फ़ अपनी चुनी हुई मशीनों तक सीमित रखने के लिए बाकी सब के लिए Windows Firewall का block rule जोड़ें।
यहाँ हाथ से की गई widget request है। method turnstile है, और API दस्तावेज़ sitekey और pageurl को ज़रूरी मान बताते हैं। हर call curl.exe की एक पंक्ति है, जिसे PowerShell जैसी लिखी है वैसी चलाता है। cmd में उन पंक्तियों को छोड़ दें जो hash से शुरू होती हैं।
# 1. Submit the task. CapSkip answers with a task id.
curl.exe -s -X POST -d "key=YOUR_API_KEY&method=turnstile&sitekey=YOUR_SITEKEY&pageurl=https://example.com/contact&json=1" http://127.0.0.1:8080/in.php
# {"status":1,"request":"12345"}
# 2. Poll with that id until the token is ready.
curl.exe -s "http://127.0.0.1:8080/res.php?key=YOUR_API_KEY&action=get&id=12345&json=1"
# {"status":0,"request":"CAPCHA_NOT_READY"} means poll again shortly.
# {"status":1,"request":"TOKEN","userAgent":"Mozilla/5.0 ..."}यही task Python SDK से एक call में हो जाता है। वह submit करता है, poll करता है और एक dictionary लौटाता है, जिसका code मान cf-turnstile-response फ़ील्ड के लिए token है।
# python -m pip install capskip
from capskip import CapSkip
# Local mode. In Server mode, use your server's address as the host.
solver = CapSkip(host="127.0.0.1", port=8080)
result = solver.turnstile("YOUR_SITEKEY", "https://example.com/contact")
print(result["code"]) # the token for the cf-turnstile-response field
print(result.get("userAgent")) # the User-Agent to send with itAPI दस्तावेज़ कहते हैं कि CapSkip Turnstile को एक खास ब्राउज़र User-Agent से हल करता है, और token सबमिट करते समय आपको वही User-Agent भेजना होगा। JSON जवाब में वह userAgent के रूप में आता है, और plain text mode में X-Turnstile-User-Agent response header में। SDK JSON जवाब माँगता है, इसलिए मान को नतीजे से पढ़ें और उसे उस request पर लगाएँ जो token ले जाती है।
challenge पेज की request
challenge पेज के लिए API दस्तावेज़ तीन और मान भेजने को कहते हैं, जिन्हें आप उन arguments से पढ़ते हैं जो पेज turnstile.render() को देता है। जो मान पेज तय करता है, वही भेजें, खाली मान न भेजें। दस्तावेज़ में एक छोटी script है जो उस function को override करके arguments प्रिंट करती है।
| Request मान | पेज इसे कहाँ रखता है |
|---|---|
| action | data-action attribute, या render call में action |
| data | render call में cData मान, या data-cdata attribute |
| pagedata | render call में chlPageData मान |
# python -m pip install capskip
from capskip import CapSkip
solver = CapSkip(host="127.0.0.1", port=8080)
# action, data and pagedata come from the page's turnstile.render call.
result = solver.turnstile(
"YOUR_SITEKEY",
"https://example.com/protected",
action="managed",
data="YOUR_CDATA",
pagedata="YOUR_CHLPAGEDATA",
)
print(result["code"], result.get("userAgent"))action के लिए managed मान API दस्तावेज़ की sample request से लिया गया है, इसलिए वही action इस्तेमाल करें जो आपका पेज तय करता है।
cookie वाला रास्ता एक अलग request है। API दस्तावेज़ इसे Cloudflare Challenge (cf_clearance) के तहत सूचीबद्ध करते हैं, उस पूरे पेज के लिए जिस पर "Just a moment" लिखा आता है। यह सिर्फ़ JSON createTask API से काम करता है, Cloudflare settings में Return cf_clearance cookies चालू किए बिना बंद रहता है, और हर request में वह proxy बताना ज़रूरी है जिसे आप बाद में इस्तेमाल करेंगे। Python SDK में इसके लिए कोई call नहीं है, इसलिए यहाँ वह request उसी रूप में है जैसा API दस्तावेज़ लिखते हैं, PowerShell से भेजी गई। proxy मान दस्तावेज़ का placeholder है।
# Submit the cookie task. A proxy is required.
$body = '{"clientKey":"YOUR_API_KEY","task":{"type":"AntiCloudflareTask","websiteURL":"https://www.example.com/","proxy":"203.0.113.10:8080:login:password"}}'
$task = Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8080/createTask -ContentType "application/json" -Body $body
# Poll every few seconds while the status is processing.
$ask = @{ clientKey = "YOUR_API_KEY"; taskId = $task.taskId } | ConvertTo-Json
do {
Start-Sleep -Seconds 5
$result = Invoke-RestMethod -Method Post -Uri http://127.0.0.1:8080/getTaskResult -ContentType "application/json" -Body $ask
} while ($result.status -eq "processing")
$result.solution.cookies.cf_clearance
$result.solution.userAgentजब challenge के बाद आप साइट को सामान्य HTTP request से लाना चाहें, तब cookie request इस्तेमाल करें। API दस्तावेज़ यह स्थिति ऐसी script या टूल के लिए बताते हैं जिसका अपना कोई ब्राउज़र नहीं है, और कहते हैं कि cookie उसी proxy से और उसी User-Agent के साथ भेजें। token request उस पेज के लिए ठीक बैठती है जो turnstile.render() call करता है और जिसमें callback या token लेने वाला फ़ील्ड है। token request की यह जोड़ी दस्तावेज़ के दो हिस्सों से निकाला गया अनुमान है, दस्तावेज़ का कथन नहीं।
Python में cookie दोबारा इस्तेमाल करने के लिए देखें: cf_clearance cookie दोबारा इस्तेमाल करने का तरीका। कोड में token request के लिए यह देखें: Node.js गाइड। PHP वाला संस्करण यहाँ है: PHP में Turnstile हल करना। C# वाला संस्करण यहाँ है: C# challenge पेज गाइड.
मैंने क्या चलाया, और यह क्या नहीं दिखाता
मैंने चारों code block एक ऐसे mock पर चलाए जो CapSkip की भूमिका निभाता है, Python 3.11.7, 3.13.7 और 3.14.0 पर capskip 1.7.0 के साथ, और दोनों PowerShell block Windows PowerShell 5.1 में। मैंने असली app को कोई task नहीं भेजा, इसलिए यहाँ कुछ भी नहीं दिखाता कि असली Turnstile पेज कैसे जवाब देता है या असली app widget के लिए क्या लौटाता है।
| mock के विरुद्ध जाँच | नतीजा |
|---|---|
| Python में widget call | method turnstile, sitekey और पेज के पते वाला एक task, और token तथा User-Agent नतीजे में लौट आए |
| Python में challenge पेज call | उसी task में action, data और pagedata भी थे, ठीक वैसे जैसे दिए गए |
| दोनों Python block एक फ़ाइल में चिपकाए गए | दोनों task भेजे गए और वापस पढ़े गए |
| PowerShell में cookie वाला रास्ता | mock को type AntiCloudflareTask, पेज का पता और proxy दिखे। उसने एक बार processing कहा, फिर cookie और User-Agent दिए, जिन्हें block ने प्रिंट किया |
| curl.exe से submit, फिर poll | पहले poll ने कहा कि task तैयार नहीं है और दूसरे ने token लौटाया |
FAQ
Turnstile token कितनी देर चलता है?
Cloudflare के अनुसार 300 सेकंड, और token एक ही बार इस्तेमाल के लिए हैं। form भेजने से ठीक पहले CapSkip से token माँगें।
क्या Turnstile वही है जो साइट लोड होने से पहले Cloudflare की जाँच होती है?
नहीं। widget एक पेज के अंदर रहता है और token देता है। full-page challenge पेज की जगह ले लेता है और cf_clearance cookie पर खत्म होता है। ऊपर की निर्णय तालिका दिखाती है कि दोनों में फ़र्क कैसे करें।
क्या कोड लिखने से पहले मैं Turnstile widget देख सकता हूँ?
हाँ। लाइव widget और वह फ़ील्ड देखने के लिए जिसे वह भरता है, Turnstile demo पेज खोलें।
क्या मैं solver को किसी दूसरे PC से call कर सकता हूँ?
हाँ, Server mode के ज़रिए। CapSkip चलाने वाले PC का address host के रूप में दें, और जिस address को वहाँ नहीं पहुँचना चाहिए उसके लिए Windows Firewall का block rule जोड़ें। solver फिर भी आपके अपने Windows हार्डवेयर पर चलता है।
संक्षेप में
संक्षेप में, Cloudflare Turnstile क्या है? cf-turnstile-response में एक token जिसे साइट Cloudflare से जाँचती है, और उसके साथ एक अलग full-page challenge जो एक cookie पर खत्म होता है। अपने कोड से token या cookie देने के लिए आपके अपने PC पर चलने वाला एक लोकल कैप्चा बायपास टूल, जैसे CapSkip, यह काम करता है, फिक्स्ड कीमत वाले लाइसेंस पर और प्रति-हल शुल्क के बिना।
