Perbaikan: Error Field cf-turnstile-response Wajib Diisi

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

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

PenyebabCara mengetahuinyaPerbaiki
Widget tidak pernah direnderTidak ada kotak Turnstile di halaman, dan ada request yang diblokir untuk skrip widget di tab network browserIzinkan 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 formulirKotaknya tampil, tetapi input tersembunyi tidak berada di dalam elemen formPindahkan widget ke dalam formulir, atau salin token ke sebuah field sendiri
Formulir terkirim sebelum widget selesaiError muncul hanya ketika pengunjung mengirim seketika, dan percobaan kedua berhasilNonaktifkan tombol kirim sampai widget menghasilkan tokennya
Field memiliki nama lainPesan menyebut field yang berbeda, atau halaman menetapkan nama field response kustomKirim nama yang ditampilkan pesan. Cloudflare mendokumentasikan opsi response-field-name yang defaultnya cf-turnstile-response
Field response milik widget dimatikanKotaknya tampil, tetapi formulir tidak punya input bernama cf-turnstile-response, dan halaman menetapkan data-response-field ke falseHapus pengaturan itu, atau baca token dari callback widget dan masukkan ke sebuah field sendiri
Sebuah skrip mengirim formulirTidak ada browser yang terlibat, dan pengiriman hanya membawa field Anda sendiriDapatkan 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 mockApa yang terjadi
Langkah 2, tidak ada field yang dikirimPesan muncul dan mock CapSkip tidak menerima task
Langkah 3, token dikirim dengan nama yang benarSatu task, POST formulir diterima
Situs mengharapkan nama field lainPesan menyebut field lain itu, dan mengirim token dengan nama itu diterima
Token dikirim untuk kedua kalinyaPesan berbeda, "The captcha could not be verified", jadi field-nya ada tetapi token sudah terpakai
Field dikirim dengan nilai kosongPesan required yang sama, jadi field kosong dianggap hilang
Mock diatur untuk memeriksa User-AgentToken yang dikirim tanpa menyalin User-Agent yang dikembalikan ditolak, dan dengan salinannya diterima
Token sama, tanpa header Referer403 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.