Perbaikan: Error Field cf-turnstile-response Wajib Diisi

Pesan "The cf-turnstile-response field is required" berasal dari validasi formulir milik situs itu sendiri, dan artinya POST formulir tiba tanpa field dengan nama itu, atau dengan field kosong. Perbaikannya bergantung pada siapa yang mengirim formulir. Di browser, widget Turnstile tidak menghasilkan token. Di skrip Anda sendiri, tidak ada yang memintanya. Panduan ini menunjukkan kedua penyebab, lalu memperbaiki kasus skrip dalam Python dengan token dari CapSkip.
Apa arti pesan itu
Ini bukan error Cloudflare. Lapisan validasi seperti yang ada di Laravel menyusun kalimat ini dari nama field, dengan pola "The :attribute field is required", jadi nama di dalam pesan adalah nama yang dicari server tetapi tidak ditemukan. Pemeriksaan berjalan sebelum server memanggil Cloudflare sama sekali. Saat server memang memanggil Cloudflare di endpoint siteverify tanpa nilai response, Cloudflare menjawab dengan kodenya sendiri, missing-input-response, yang merupakan pesan berbeda.
Dokumentasi widget Cloudflare menyatakan bahwa sebuah input tersembunyi bernama cf-turnstile-response dibuat untuk widget yang ditempatkan di dalam formulir, dan input itu ikut terkirim bersama field lainnya. Jadi field itu baru ada setelah widget berjalan dan menghasilkan token.
Mengapa field itu hilang
| Penyebab | Cara mengetahuinya | Perbaiki |
|---|---|---|
| Widget tidak pernah dirender | Tidak ada kotak Turnstile di halaman, dan ada request yang diblokir untuk skrip widget di tab network browser | Izinkan skripnya, dan muat dari URL persis yang diberikan Cloudflare, karena Cloudflare menyatakan salinan yang diproksikan atau di-cache rusak saat ada pembaruan |
| Widget berada di luar formulir | Kotaknya tampil, tetapi input tersembunyi tidak berada di dalam elemen form | Pindahkan widget ke dalam formulir, atau salin token ke sebuah field sendiri |
| Formulir terkirim sebelum widget selesai | Error muncul hanya ketika pengunjung mengirim seketika, dan percobaan kedua berhasil | Nonaktifkan tombol kirim sampai widget menghasilkan tokennya |
| Field memiliki nama lain | Pesan menyebut field yang berbeda, atau halaman menetapkan nama field response kustom | Kirim nama yang ditampilkan pesan. Cloudflare mendokumentasikan opsi response-field-name yang defaultnya cf-turnstile-response |
| Field response milik widget dimatikan | Kotaknya tampil, tetapi formulir tidak punya input bernama cf-turnstile-response, dan halaman menetapkan data-response-field ke false | Hapus pengaturan itu, atau baca token dari callback widget dan masukkan ke sebuah field sendiri |
| Sebuah skrip mengirim formulir | Tidak ada browser yang terlibat, dan pengiriman hanya membawa field Anda sendiri | Dapatkan token dan kirim, yang menjadi sisa panduan ini |
Baris terakhir adalah yang bisa Anda perbaiki lewat kode, dan pesan membantu soal nama field: ia mencetak nama yang diinginkan server, jadi salin persis. Kolom "cara mengetahuinya" adalah pembacaan saya atas cara kerja widget. Cloudflare mendokumentasikan input tersembunyi, opsi response-field dan response-field-name, serta aturan tentang URL skrip.
Apa yang Anda butuhkan
- PC Windows dengan CapSkip yang berjalan. Halaman pemecah Cloudflare Turnstile memuat request widget: sebuah sitekey dan alamat halaman.
- Python 3.10 atau lebih baru, yang merupakan batas minimum yang dinyatakan capskip 1.7.0, ditambah requests. Baris pertama blok pertama menunjukkan perintah pip yang menginstal keduanya. Saya menjalankan blok-blok ini di Python 3.11.7, 3.13.7, dan 3.14.0 dengan capskip 1.7.0 dan requests 2.34.2.
- Sebuah formulir yang Anda diizinkan untuk dikirimi data. Contoh memakai alamat placeholder https://example.com/contact, formulir dengan field CSRF tersembunyi bernama _token, sebuah field email, dan sebuah field message.
- Untuk skrip di mesin lain, alihkan CapSkip ke mode Server dan berikan alamat PC itu sebagai host. Panduan penyiapan menjelaskan cara beralihnya di bagian pengaturan koneksi. Memulai mode Server membuat CapSkip menerima koneksi dari alamat mana pun. Untuk menjaga port hanya untuk mesin yang Anda percaya, tambahkan aturan blokir Windows Firewall untuk sisanya.
Saya menjalankan semuanya terhadap dua mock yang saya tulis: satu memerankan CapSkip, satu memerankan situs formulir. Situs mock menolak pengiriman formulir tanpa field itu dan mencetak pesan dari tulisan ini. Setiap aturan di dalamnya adalah buatan saya, dan saya tidak mengirim task ke aplikasi CapSkip yang asli, jadi tidak ada di sini yang menunjukkan bahwa situs sungguhan menerima token.
Langkah 1: siapkan session
Simpan blok pertama sebagai turnstile_form.py. Dua blok sesudahnya diletakkan di akhir file yang sama. Helper bernama read_input membaca input tersembunyi, dan send_form mengirim field Anda lewat POST. Ia mengatur header Referer ke halaman formulir, seperti yang dilakukan browser, karena requests tidak mengirimnya sendiri.
# 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)Langkah 2: reproduksi error-nya
Kirim formulir dengan cara yang biasanya dilakukan skrip pertama kali, dengan field Anda sendiri dan tidak ada yang lain. Tambahkan blok ini berikutnya. Terhadap mock saya, balasannya berstatus 200 dengan halaman ditampilkan lagi dan pesan ada di daftar error-nya. Situs Anda mungkin mengalihkan atau menjawab 422, jadi cari kalimat itu di 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.']Langkah 3: perbaiki dengan token dari CapSkip
Baca sitekey dari atribut data-sitekey milik widget, minta token ke CapSkip dengan method turnstile milik pemecah, dan kirim nilai code dari hasilnya dengan nama field yang persis. Dokumentasi API CapSkip menyatakan pemecah memakai User-Agent browser tertentu untuk Turnstile dan bahwa Anda harus mengirim yang sama bersama token, dan bahwa jawabannya menyertakannya. Blok ini menyalinnya ke session bila ada. Mock saya mengembalikannya, dan saya belum melihat apa yang dikembalikan aplikasi asli untuk sebuah widget.
Sebuah token hanya berfungsi sekali. Cloudflare menyatakan setiap token berlaku 300 detik dan dimaksudkan untuk sekali pakai, jadi mintalah tepat sebelum POST formulir, bukan di bagian atas skrip yang panjang. Jika sitekey tidak ada di atribut data-sitekey karena halaman memanggil fungsi render, salin dari panggilan itu sekali.
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)Terhadap mock, ketiga versi Python memberikan hasil ini:
| Pengaturan mock | Apa yang terjadi |
|---|---|
| Langkah 2, tidak ada field yang dikirim | Pesan muncul dan mock CapSkip tidak menerima task |
| Langkah 3, token dikirim dengan nama yang benar | Satu task, POST formulir diterima |
| Situs mengharapkan nama field lain | Pesan menyebut field lain itu, dan mengirim token dengan nama itu diterima |
| Token dikirim untuk kedua kalinya | Pesan berbeda, "The captcha could not be verified", jadi field-nya ada tetapi token sudah terpakai |
| Field dikirim dengan nilai kosong | Pesan required yang sama, jadi field kosong dianggap hilang |
| Mock diatur untuk memeriksa User-Agent | Token yang dikirim tanpa menyalin User-Agent yang dikembalikan ditolak, dan dengan salinannya diterima |
| Token sama, tanpa header Referer | 403 dari mock, yang aturannya sendiri adalah mewajibkan Referer same-origin |
Baca tabel ini sebagai pengujian mock saya. Kata-kata pesan, pemakaian sekali, dan aturan Referer adalah buatan saya, dan situs sungguhan menentukan sendiri.
Jika pesan tetap muncul setelah Anda menambahkan token
- Pesan yang berbeda, seperti pesan tentang verifikasi yang gagal, berarti field-nya sudah tiba. Periksa tokennya: dipakai dua kali, lebih tua dari lima menit, atau diminta untuk alamat halaman lain.
FAQ
Apakah error cf-turnstile-response required adalah error Cloudflare?
Bukan. Itu validasi milik situs yang melaporkan field formulir yang hilang. Cloudflare baru terlibat ketika situs mengirim token ke endpoint verifikasinya.
Apakah ini berlaku untuk halaman challenge Cloudflare?
Tidak. Challenge satu halaman penuh bukan sebuah field formulir. CapSkip menjawabnya dengan cookie, dan Dokumentasi API menjelaskan method itu secara terpisah. Panduan PHP dan Node.js menunjukkan dua nilai tambahan yang dibutuhkan halaman challenge Turnstile. Lihat panduan memecahkan Turnstile di PHP untuk cara pengirimannya. Versi Node.js ada di panduan memecahkan Turnstile di Node.js.
Bisakah skrip berjalan di mesin yang berbeda dari CapSkip?
Bisa, lewat mode Server. Berikan alamat PC CapSkip sebagai host. Panduan penyiapan menyatakan IP publik statis memberi akses jarak jauh yang paling stabil untuk penyiapan server, dan mode Server mengharuskan CapSkip berjalan sebagai administrator. Pemecah Anda tetap berjalan di perangkat keras Windows Anda sendiri, tanpa penagihan per pemecahan.
Versi singkatnya
Error itu berarti server tidak melihat nilai cf-turnstile-response. Di browser, pastikan widget dirender. Di skrip, minta token tepat sebelum POST formulir dan kirim dengan nama yang ditampilkan pesan. Karena CapSkip adalah pemecah captcha lokal yang berjalan di PC Anda sendiri, setiap percobaan ulang tidak dikenai biaya tambahan pada salinan berlisensi. Halaman pemecah CAPTCHA Python memuat panggilan SDK lainnya, dan Dokumentasi API memberikan request mentahnya.
