Düzeltme: cf-turnstile-response alanı zorunludur hatası

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

"The cf-turnstile-response field is required" mesajı sitenin kendi form doğrulamasından gelir ve form gönderiminin o adda bir alan olmadan ya da boş bir alanla geldiği anlamına gelir. Çözüm, formu kimin gönderdiğine bağlıdır. Bir tarayıcıda Turnstile widget’ı token üretmedi. Kendi script’inizde ise kimse token istemedi. Bu kılavuz iki nedeni de gösterir, sonra script durumunu Python’da CapSkip’ten alınan bir token ile düzeltir.

Mesajın anlamı

Bu bir Cloudflare hatası değildir. Laravel’dekine benzer doğrulama katmanları bu cümleyi alan adından, "The :attribute field is required" kalıbıyla kurar; yani mesajın içindeki ad, sunucunun aradığı ve bulamadığı addır. Denetim, sunucu Cloudflare’i hiç çağırmadan önce çalışır. Bir sunucu gerçekten Cloudflare siteverify endpoint’ini response değeri olmadan çağırdığında Cloudflare kendi koduyla, missing-input-response ile yanıt verir; bu farklı bir mesajdır.

Cloudflare widget dokümantasyonu bir formun içine yerleştirilmiş bir widget için cf-turnstile-response adlı görünmez bir input oluşturulduğunu ve bunun diğer alanlarla birlikte gittiğini söyler. Yani alan ancak widget çalışıp bir token ürettikten sonra var olur.

Alanın eksik olmasının nedeni

NedenNasıl anlaşılırDüzeltme
Widget hiç oluşturulmadıSayfada Turnstile kutusu yok ve tarayıcının ağ sekmesinde widget script’i için engellenmiş bir istek varScript’e izin verin ve onu Cloudflare’in verdiği tam URL’den yükleyin, çünkü Cloudflare proxy’lenmiş ya da önbelleğe alınmış bir kopyanın güncellemelerde bozulduğunu söyler
Widget formun dışında duruyorKutu görünüyor ama gizli input form öğesinin içinde değilWidget’ı forma taşıyın ya da token’ı kendiniz bir alana kopyalayın
Form, widget bitmeden gönderildiHata yalnızca ziyaretçi hemen gönderdiğinde çıkar ve ikinci deneme çalışırWidget token’ını üretene kadar gönder düğmesini devre dışı bırakın
Alanın adı başkaMesaj farklı bir alanı adlandırıyor ya da sayfa özel bir yanıt alanı adı ayarlıyorMesajın gösterdiği adı gönderin. Cloudflare, varsayılanı cf-turnstile-response olan bir response-field-name seçeneğini belgeler
Widget’ın yanıt alanı kapatılmışKutu görünüyor ama formda cf-turnstile-response adlı input yok ve sayfa data-response-field değerini false yapıyorBu ayarı kaldırın ya da token’ı widget callback’inden okuyup kendiniz bir alana koyun
Formu bir script gönderiyorHiçbir tarayıcı yok ve gönderim yalnızca sizin kendi alanlarınızı taşıyorBir token alıp gönderin; kılavuzun geri kalanı bu

Son satır, kodla düzeltebileceğiniz satırdır ve mesaj alan adı konusunda yardımcı olur: sunucunun istediği adı yazdırır, o yüzden onu aynen kopyalayın. "Nasıl anlaşılır" sütunu, widget’ın nasıl davrandığına dair benim yorumumdur. Cloudflare gizli input’u, response-field ve response-field-name seçeneklerini ve script URL’si kuralını belgeler.

Neye ihtiyacınız var

  • CapSkip çalışan bir Windows bilgisayarı. Cloudflare Turnstile çözücü sayfası widget isteğini listeler: bir sitekey ve sayfa adresi.
  • Python 3.10 veya üzeri, ki bu capskip 1.7.0’ın bildirdiği alt sınırdır, artı requests. İlk bloğun ilk satırı ikisini birden kuran pip komutunu gösterir. Blokları Python 3.11.7, 3.13.7 ve 3.14.0 üzerinde, capskip 1.7.0 ve requests 2.34.2 ile çalıştırdım.
  • Göndermenize izin verilen bir form. Örnek, https://example.com/contact yer tutucu adresini; _token adlı gizli bir CSRF alanı, bir e-posta alanı ve bir mesaj alanı olan bir formu kullanır.
  • Başka bir makinedeki bir script için CapSkip’i Server moduna alın ve o bilgisayarın adresini host olarak verin. Kurulum kılavuzu bu geçişi şu başlık altında anlatır: bağlantı ayarları. Server modunu başlatmak CapSkip’in her adresten gelen bağlantıları kabul etmesini sağlar. Portu güvendiğiniz makinelere ayırmak için geri kalanlar için bir Windows Güvenlik Duvarı engelleme kuralı ekleyin.

Her şeyi kendi yazdığım iki mock’a karşı çalıştırdım: biri CapSkip’i, biri bir form sitesini oynuyor. Mock site, alan olmadan gelen bir form gönderimini reddeder ve bu yazıdaki mesajı yazdırır. Üzerindeki her kural benimdir ve gerçek CapSkip uygulamasına hiçbir görev göndermedim, bu yüzden buradaki hiçbir şey gerçek bir sitenin bir token’ı kabul ettiğini göstermez.

1. Adım: oturumu hazırlayın

İlk bloğu turnstile_form.py olarak kaydedin. Ondan sonraki iki blok aynı dosyanın sonuna girer. read_input adlı yardımcı gizli bir input’u okur, send_form ise alanlarınızı gönderir. Referer başlığını, bir tarayıcının yapacağı gibi form sayfasına ayarlar, çünkü requests kendiliğinden hiç Referer göndermez.

# 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. Adım: hatayı yeniden üretin

Formu bir script’in genellikle ilk yaptığı gibi, yalnızca kendi alanlarınızla gönderin. Bu bloğu sonrasına ekleyin. Mock’uma karşı yanıt, sayfanın yeniden gösterilmesi ve mesajın hata listesinde olmasıyla 200 durumuydu. Sitenizde yönlendirme olabilir ya da 422 dönebilir, bu yüzden cümleyi gövdede arayın.

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. Adım: CapSkip’ten bir token ile düzeltin

Sitekey’i widget’ın data-sitekey özniteliğinden okuyun, çözücünün turnstile metoduyla CapSkip’ten bir token isteyin ve sonucun code değerini tam alan adıyla gönderin. CapSkip API belgeleri, çözücünün Turnstile için belirli bir tarayıcı User-Agent’ı kullandığını, token ile aynısını göndermeniz gerektiğini ve yanıtın onu içerdiğini söyler. Blok, varsa onu oturuma kopyalar. Mock’um bir tane döndürdü ve gerçek uygulamanın bir widget için ne döndürdüğünü görmedim.

Bir token bir kez çalışır. Cloudflare her token’ın 300 saniye geçerli olduğunu ve tek kullanım için tasarlandığını söyler, bu yüzden onu uzun bir script’in başında değil, form gönderiminden hemen önce isteyin. Sayfa render fonksiyonunu çağırdığı için sitekey bir data-sitekey özniteliğinde değilse, onu o çağrıdan bir kez kopyalayın.

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’a karşı üç Python sürümü de şu sonuçları verdi:

Mock ayarıNe oldu
2. Adım, hiç alan gönderilmediMesaj göründü ve CapSkip mock’u hiç görev almadı
3. Adım, token doğru adla gönderildiBir görev, form gönderimi kabul edildi
Site başka bir alan adı bekliyorMesaj o diğer alanı adlandırdı ve token’ı onun altında göndermek kabul edildi
Token ikinci kez gönderildiFarklı bir mesaj, "The captcha could not be verified"; yani alan vardı ama token harcanmıştı
Alan boş değerle gönderildiAynı required mesajı, yani boş bir alan eksik sayılıyor
Mock, User-Agent’ı denetleyecek şekilde ayarlandıDöndürülen User-Agent kopyalanmadan gönderilen token reddedildi, kopyayla kabul edildi
Aynı token, Referer başlığı yokMock’tan 403; kendi kuralı aynı kaynaklı bir Referer istemek

Tabloyu mock’umun bir testi olarak okuyun. Mesaj ifadesi, tek kullanım ve Referer kuralı benimdir; gerçek bir site kendi başına karar verir.

Token’ı ekledikten sonra mesaj kalıyorsa

  • Doğrulama başarısızlığı gibi farklı bir mesaj, alanın ulaştığı anlamına gelir. Token’a bakın: iki kez kullanılmış, beş dakikadan eski ya da başka bir sayfa adresi için istenmiş olabilir.

FAQ

cf-turnstile-response required hatası bir Cloudflare hatası mı?

Hayır. Bu, sitenin doğrulamasının eksik bir form alanını bildirmesidir. Cloudflare yalnızca site bir token’ı doğrulama endpoint’ine gönderdiğinde devreye girer.

Bu bir Cloudflare challenge sayfası için de geçerli mi?

Hayır. Tam sayfa challenge bir form alanı değildir. CapSkip onu bir cookie ile yanıtlar ve API belgeleri bu yöntemi ayrı olarak anlatır. PHP ve Node.js kılavuzları, bir Turnstile challenge sayfasının ihtiyaç duyduğu iki ek değeri gösterir. Nasıl gönderildiklerini şurada görebilirsiniz: PHP’de Turnstile çözme Node.js sürümü ise şurada: Node.js’te Turnstile çözme.

Script, CapSkip’ten farklı bir makinede çalışabilir mi?

Evet, Server modu ile. CapSkip bilgisayarının adresini host olarak verin. Kurulum kılavuzu, statik bir genel IP’nin sunucu kurulumu için en kararlı uzak erişimi sağladığını söyler ve Server modu CapSkip’in yönetici olarak çalışmasını gerektirir. Çözücünüz yine kendi Windows donanımınızda çalışır, çözüm başına faturalandırma olmadan.

Kısa özet

Hata, sunucunun bir cf-turnstile-response değeri görmediği anlamına gelir. Bir tarayıcıda widget’ın oluşmasını sağlayın. Bir script’te form gönderiminden hemen önce bir token isteyin ve mesajın gösterdiği adla gönderin. CapSkip kendi bilgisayarınızda çalışan bir yerel captcha çözücü olduğu için lisanslı bir kopyada her yeniden deneme ek ücret getirmez. Python CAPTCHA çözücü sayfası diğer SDK çağrılarını listeler ve API belgeleri ham isteği verir.