cf-turnstile-response फ़ील्ड ज़रूरी है: error ठीक करें

cf-turnstile-response field is required - Fix: The cf-turnstile-response Field Is Required Error

"The cf-turnstile-response field is required" संदेश साइट की अपनी फ़ॉर्म validation से आता है, और इसका मतलब है कि form post उस नाम के फ़ील्ड के बिना, या खाली फ़ील्ड के साथ पहुँचा। समाधान इस पर निर्भर करता है कि फ़ॉर्म किसने भेजा। ब्राउज़र में Turnstile widget ने token नहीं बनाया। आपकी अपनी script में किसी ने उसे माँगा ही नहीं। यह गाइड दोनों कारण दिखाती है, फिर script वाले मामले को Python में CapSkip के token से ठीक करती है।

संदेश का मतलब

यह Cloudflare की error नहीं है। Laravel जैसी validation परतें यह वाक्य फ़ील्ड के नाम से बनाती हैं, "The :attribute field is required" पैटर्न में, इसलिए संदेश के भीतर का नाम वही है जिसे server ने ढूँढा और नहीं पाया। यह जाँच server के Cloudflare को बुलाने से पहले ही चलती है। जब कोई server Cloudflare के siteverify endpoint को बिना response मान के बुलाता है, तब Cloudflare अपने ही कोड missing-input-response से जवाब देता है, जो एक अलग संदेश है।

Cloudflare का widget दस्तावेज़ कहता है कि किसी फ़ॉर्म के अंदर रखे widget के लिए cf-turnstile-response नाम का एक छिपा हुआ input बनता है, और वह बाकी फ़ील्ड के साथ जाता है। यानी फ़ील्ड तभी मौजूद होता है जब widget चल चुका हो और उसने token बना दिया हो।

फ़ील्ड क्यों गायब है

कारणकैसे पहचानेंफिक्स
widget कभी render नहीं हुआपेज पर कोई Turnstile बॉक्स नहीं, और ब्राउज़र के network टैब में widget script का एक blocked requestscript को अनुमति दें, और उसे Cloudflare के दिए ठीक उसी URL से लोड करें, क्योंकि Cloudflare कहता है कि proxied या cached कॉपी अपडेट होने पर टूट जाती है
widget फ़ॉर्म के बाहर हैबॉक्स दिखता है, लेकिन छिपा हुआ input form element के अंदर नहीं हैwidget को फ़ॉर्म के अंदर ले जाएँ, या token को खुद किसी फ़ील्ड में कॉपी करें
widget के पूरा होने से पहले फ़ॉर्म भेज दिया गयाerror तभी आती है जब विज़िटर तुरंत सबमिट करता है, और दूसरी कोशिश काम करती हैजब तक widget अपना token न बना ले, सबमिट बटन को बंद रखें
फ़ील्ड का नाम कुछ और हैसंदेश किसी दूसरे फ़ील्ड का नाम बताता है, या पेज एक custom response फ़ील्ड नाम सेट करता हैवही नाम भेजें जो संदेश दिखाता है। Cloudflare एक response-field-name विकल्प दर्ज करता है जिसका डिफ़ॉल्ट cf-turnstile-response है
widget का response फ़ील्ड बंद हैबॉक्स दिखता है, लेकिन फ़ॉर्म में cf-turnstile-response नाम का कोई input नहीं है, और पेज data-response-field को false पर सेट करता हैवह सेटिंग हटाएँ, या token को widget के callback से पढ़कर खुद किसी फ़ील्ड में डालें
कोई script फ़ॉर्म सबमिट करती हैकोई ब्राउज़र शामिल नहीं है, और सबमिशन में सिर्फ़ आपके अपने फ़ील्ड जाते हैंएक token लें और उसे भेजें, यही इस गाइड का बाकी हिस्सा है

आख़िरी पंक्ति वह है जिसे आप कोड में ठीक कर सकते हैं, और फ़ील्ड के नाम में संदेश मदद करता है: वह server का चाहा हुआ नाम छापता है, इसलिए उसे ठीक वैसा ही कॉपी करें। "कैसे पहचानें" वाला कॉलम इस बारे में मेरी समझ है कि widget कैसे व्यवहार करता है। Cloudflare छिपे हुए input, response-field और response-field-name विकल्पों और script URL के नियम को दर्ज करता है।

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

  • CapSkip चलता हुआ एक Windows PC। Cloudflare Turnstile सॉल्वर पेज widget का request बताता है: एक sitekey और पेज का address।
  • Python 3.10 या उससे नया, जो capskip 1.7.0 की घोषित न्यूनतम सीमा है, साथ में requests। पहले ब्लॉक की पहली लाइन वह pip कमांड दिखाती है जो दोनों इंस्टॉल करती है। मैंने ब्लॉक Python 3.11.7, 3.13.7 और 3.14.0 पर capskip 1.7.0 और requests 2.34.2 के साथ चलाए।
  • एक ऐसा फ़ॉर्म जिसमें सबमिट करने की आपको अनुमति है। नमूना placeholder address https://example.com/contact इस्तेमाल करता है, यानी _token नाम के एक छिपे CSRF फ़ील्ड, एक email फ़ील्ड और एक message फ़ील्ड वाला फ़ॉर्म।
  • दूसरी मशीन की script के लिए CapSkip को Server mode में बदलें और उस PC का address host के रूप में दें। सेटअप गाइड यह स्विच यहाँ बताती है: कनेक्शन सेटिंग्स। Server mode शुरू करने पर CapSkip किसी भी address से कनेक्शन स्वीकार करने लगता है। पोर्ट को अपने भरोसे की मशीनों के लिए रखने को, बाकी सबके लिए Windows Firewall का block rule जोड़ें।

मैंने सब कुछ अपने लिखे दो mocks के सामने चलाया: एक CapSkip बनता है, एक फ़ॉर्म वाली साइट। mock साइट बिना फ़ील्ड वाला फ़ॉर्म सबमिशन ठुकरा देती है और इस पोस्ट का संदेश छापती है। उस पर हर नियम मेरा है, और मैंने असली CapSkip ऐप को कोई task नहीं भेजा, इसलिए यहाँ कुछ भी यह नहीं दिखाता कि कोई असली साइट token स्वीकार करती है।

चरण 1: session तैयार करें

पहला ब्लॉक turnstile_form.py के रूप में सेव करें। उसके बाद के दो ब्लॉक उसी फ़ाइल के अंत में जाते हैं। read_input नाम का helper एक छिपा हुआ input पढ़ता है, और send_form आपके फ़ील्ड post करता है। वह Referer header को फ़ॉर्म पेज पर सेट करता है, जैसा ब्राउज़र करता, क्योंकि requests खुद कोई नहीं भेजता।

# python -m pip install capskip requests
import re

import requests
from capskip import CapSkip

FORM_URL = "https://example.com/contact"  # the page that shows the form

# Local mode. In Server mode, use your server's address as the host.
solver = CapSkip(host="127.0.0.1", port=8080)


def read_input(html, name):
    tag = re.search(r'<input[^>]*name="' + re.escape(name) + r'"[^>]*>', html)
    value = re.search(r'value="([^"]*)"', tag.group(0)) if tag else None
    return value.group(1) if value else None


def open_form():
    session = requests.Session()  # keeps the session cookie
    return session, session.get(FORM_URL, timeout=30).text


def send_form(session, html, extra):
    fields = {"_token": read_input(html, "_token"), "email": "[email protected]", "message": "Hello"}
    fields.update(extra)
    return session.post(FORM_URL, data=fields, headers={"Referer": FORM_URL}, timeout=30)

चरण 2: error को दोहराएँ

फ़ॉर्म को वैसे post करें जैसे कोई script आम तौर पर पहली बार करती है, सिर्फ़ आपके अपने फ़ील्ड के साथ और कुछ नहीं। यह ब्लॉक अगला जोड़ें। मेरे mock के सामने जवाब status 200 था, पेज फिर से दिखा और संदेश उसकी error सूची में था। आपकी साइट redirect कर सकती है या 422 दे सकती है, इसलिए body में वह वाक्य ढूँढें।

session, html = open_form()
reply = send_form(session, html, {})  # no cf-turnstile-response at all
print(reply.status_code, re.findall(r"<li>(.*?)</li>", reply.text))
# 200 ['The cf-turnstile-response field is required.']

चरण 3: CapSkip के token से ठीक करें

sitekey को widget के data-sitekey attribute से पढ़ें, सॉल्वर के turnstile method से CapSkip से token माँगें, और नतीजे का code मान ठीक उसी फ़ील्ड नाम से भेजें। CapSkip API दस्तावेज़ कहते हैं कि सॉल्वर Turnstile के लिए एक खास ब्राउज़र User-Agent इस्तेमाल करता है और token के साथ वही भेजना ज़रूरी है, और जवाब में वह शामिल होता है। ब्लॉक उसे, जब वह हो, session पर कॉपी कर देता है। मेरा mock एक लौटाता था, और मैंने नहीं देखा कि असली ऐप किसी widget के लिए क्या लौटाता है।

token एक ही बार काम करता है। Cloudflare कहता है कि हर token 300 सेकंड के लिए वैध है और एक ही इस्तेमाल के लिए है, इसलिए उसे form post से ठीक पहले माँगें, किसी लंबी script के शुरू में नहीं। अगर sitekey data-sitekey attribute में इसलिए नहीं है कि पेज render function को बुलाता है, तो उसे उस call से एक बार कॉपी कर लें।

session, html = open_form()
sitekey = re.search(r'data-sitekey="([^"]+)"', html).group(1)

result = solver.turnstile(sitekey, FORM_URL)
if result.get("userAgent"):  # the docs say the answer names the browser to present
    session.headers["User-Agent"] = result["userAgent"]

reply = send_form(session, html, {"cf-turnstile-response": result["code"]})
print(reply.status_code, re.findall(r"<p>(.*?)</p>", reply.text))
# 200 ['Message sent. Thank you.']  (your site's success text will differ)

mock के सामने तीनों Python versions ने ये नतीजे दिए:

mock सेटिंगक्या हुआ
चरण 2, कोई फ़ील्ड नहीं भेजासंदेश आया और CapSkip mock को कोई task नहीं मिला
चरण 3, token सही नाम से भेजाएक task, form post स्वीकार हुआ
साइट को कोई दूसरा फ़ील्ड नाम चाहिएसंदेश ने वह दूसरा फ़ील्ड नाम बताया, और token को उसी नाम से भेजने पर स्वीकार हुआ
token दूसरी बार भेजाएक अलग संदेश, "The captcha could not be verified", यानी फ़ील्ड मौजूद था पर token खर्च हो चुका था
फ़ील्ड खाली मान के साथ भेजावही required संदेश, यानी खाली फ़ील्ड गायब माना जाता है
mock को User-Agent जाँचने पर सेट कियालौटाया गया User-Agent कॉपी किए बिना भेजा गया token ठुकराया गया, और कॉपी के साथ स्वीकार हुआ
वही token, Referer header के बिनाmock से 403, जिसका अपना नियम है कि same-origin Referer ज़रूरी है

इस तालिका को मेरे mock का टेस्ट मानकर पढ़ें। संदेश के शब्द, एक बार का इस्तेमाल और Referer का नियम मेरे हैं, और असली साइट अपना फ़ैसला खुद करती है।

अगर token जोड़ने के बाद भी संदेश बना रहे

  • एक अलग संदेश, जैसे verification फेल होने के बारे में, का मतलब है कि फ़ील्ड पहुँच गया। token को देखें: दो बार इस्तेमाल हुआ, पाँच मिनट से पुराना, या किसी दूसरे पेज के address के लिए माँगा गया।

FAQ

क्या cf-turnstile-response required error Cloudflare की error है?

नहीं। यह साइट की validation है जो एक गायब फ़ॉर्म फ़ील्ड की सूचना देती है। Cloudflare तभी शामिल होता है जब साइट कोई token अपने verification endpoint को भेजती है।

क्या यह Cloudflare की challenge पेज पर लागू होता है?

नहीं। पूरे पेज वाला challenge कोई फ़ॉर्म फ़ील्ड नहीं है। CapSkip उसका जवाब एक cookie से देता है, और API दस्तावेज़ उस method को अलग से बताते हैं। PHP और Node.js की गाइड वे दो अतिरिक्त मान दिखाती हैं जो Turnstile challenge पेज को चाहिए। इन्हें भेजने का तरीका PHP में Turnstile हल करना में है। Node.js वाला संस्करण इसमें है: Node.js में Turnstile हल करना.

क्या script CapSkip से अलग मशीन पर चल सकती है?

हाँ, Server mode के ज़रिए। CapSkip वाले PC का address host के रूप में दें। सेटअप गाइड कहती है कि server सेटअप के लिए स्थिर public IP सबसे स्थिर रिमोट एक्सेस देता है, और Server mode के लिए CapSkip का administrator के रूप में चलना ज़रूरी है। आपका सॉल्वर फिर भी आपके अपने Windows हार्डवेयर पर चलता है, प्रति हल बिलिंग के बिना।

संक्षेप में

error का मतलब है कि server को कोई cf-turnstile-response मान नहीं दिखा। ब्राउज़र में widget को render करवाएँ। script में form post से ठीक पहले token माँगें और उसे उसी नाम से भेजें जो संदेश दिखाता है। क्योंकि CapSkip एक लोकल captcha सॉल्वर है जो आपके अपने PC पर चलता है, लाइसेंस वाली कॉपी पर हर retry का कोई अतिरिक्त शुल्क नहीं लगता। बाकी SDK calls की सूची Python कैप्चा सॉल्वर पेज पर है, और raw request API दस्तावेज़ में है।