Fix: Der Fehler zum Pflichtfeld cf-turnstile-response

Die Meldung "The cf-turnstile-response field is required" stammt aus der eigenen Formularvalidierung der Website und bedeutet, dass der Formular-POST ohne ein Feld dieses Namens oder mit einem leeren eingetroffen ist. Die Lösung hängt davon ab, wer das Formular gesendet hat. In einem Browser hat das Turnstile-Widget keinen Token erzeugt. In Ihrem eigenen Skript hat niemand einen angefordert. Dieser Leitfaden zeigt beide Ursachen und behebt dann den Skriptfall in Python mit einem Token von CapSkip.
Was die Meldung bedeutet
Es ist kein Cloudflare-Fehler. Validierungsschichten wie die in Laravel bilden diesen Satz aus dem Feldnamen nach dem Muster "The :attribute field is required", daher ist der Name in der Meldung der Name, den der Server gesucht und nicht gefunden hat. Die Prüfung läuft, bevor der Server überhaupt Cloudflare aufruft. Ruft ein Server den Cloudflare siteverify-Endpunkt ohne Antwortwert auf, antwortet Cloudflare mit einem eigenen Code, missing-input-response, und das ist eine andere Meldung.
Die Cloudflare Widget-Dokumentation sagt, dass für ein Widget innerhalb eines Formulars ein unsichtbares Eingabefeld namens cf-turnstile-response angelegt wird und dass es mit den anderen Feldern mitgesendet wird. Das Feld existiert also erst, nachdem das Widget gelaufen ist und einen Token erzeugt hat.
Warum das Feld fehlt
| Ursache | Woran Sie es erkennen | Beheben |
|---|---|---|
| Das Widget wurde nie gerendert | Kein Turnstile-Kästchen auf der Seite und eine blockierte Anfrage für das Widget-Skript im Netzwerk-Tab des Browsers | Erlauben Sie das Skript und laden Sie es von der genauen URL, die Cloudflare angibt, denn laut Cloudflare bricht eine über einen Proxy gelieferte oder zwischengespeicherte Kopie bei Updates |
| Das Widget sitzt außerhalb des Formulars | Das Kästchen wird angezeigt, aber das versteckte Eingabefeld liegt nicht im Formularelement | Verschieben Sie das Widget ins Formular oder kopieren Sie den Token selbst in ein Feld |
| Das Formular wurde gesendet, bevor das Widget fertig war | Der Fehler tritt nur auf, wenn der Besucher sofort absendet, und ein zweiter Versuch funktioniert | Deaktivieren Sie die Senden-Schaltfläche, bis das Widget seinen Token erzeugt hat |
| Das Feld hat einen anderen Namen | Die Meldung nennt ein anderes Feld, oder die Seite setzt einen eigenen Namen für das Antwortfeld | Senden Sie den Namen, den die Meldung zeigt. Cloudflare dokumentiert eine Option response-field-name, deren Standardwert cf-turnstile-response ist |
| Das Antwortfeld des Widgets ist ausgeschaltet | Das Kästchen wird angezeigt, aber das Formular hat kein Eingabefeld namens cf-turnstile-response, und die Seite setzt data-response-field auf false | Entfernen Sie diese Einstellung oder lesen Sie den Token aus dem Widget-Callback und tragen Sie ihn selbst in ein Feld ein |
| Ein Skript sendet das Formular | Es ist kein Browser beteiligt, und die Übermittlung enthält nur Ihre eigenen Felder | Holen Sie einen Token und senden Sie ihn, was der Rest dieses Leitfadens zeigt |
Die letzte Zeile ist die, die Sie im Code beheben können, und die Meldung hilft beim Feldnamen: Sie gibt den Namen aus, den der Server will, kopieren Sie ihn also genau. Die Spalte "Woran Sie es erkennen" ist meine Deutung, wie sich das Widget verhält. Cloudflare dokumentiert das versteckte Eingabefeld, die Optionen response-field und response-field-name und die Regel zur Skript-URL.
Was Sie brauchen
- Ein Windows-PC, auf dem CapSkip läuft. Die Seite Löser für Cloudflare Turnstile listet die Widget-Anfrage auf: einen Sitekey und die Seitenadresse.
- Python 3.10 oder neuer, die von capskip 1.7.0 vorgegebene Untergrenze, dazu requests. Die erste Zeile des ersten Blocks zeigt den pip-Befehl, der beides installiert. Ich habe die Blöcke auf Python 3.11.7, 3.13.7 und 3.14.0 mit capskip 1.7.0 und requests 2.34.2 ausgeführt.
- Ein Formular, an das Sie senden dürfen. Das Beispiel nutzt die Platzhalteradresse https://example.com/contact, ein Formular mit einem versteckten CSRF-Feld namens _token, einem E-Mail-Feld und einem Nachrichtenfeld.
- Für ein Skript auf einem anderen Rechner schalten Sie CapSkip in den Server-Modus und übergeben die Adresse dieses PCs als host. Die Einrichtungsanleitung beschreibt den Wechsel unter Verbindungseinstellungen. Das Starten des Server-Modus lässt CapSkip Verbindungen von jeder Adresse annehmen. Um den Port den Rechnern vorzubehalten, denen Sie vertrauen, fügen Sie eine Windows-Firewall-Blockregel für alle übrigen hinzu.
Ich habe alles gegen zwei Mocks ausgeführt, die ich selbst geschrieben habe: einer spielt CapSkip, einer spielt eine Formular-Website. Der Mock der Website lehnt ein Formular ohne das Feld ab und gibt die Meldung aus diesem Beitrag aus. Jede Regel darauf stammt von mir, und ich habe keine Aufgabe an die echte CapSkip-App gesendet, daher zeigt nichts hier, dass eine echte Website einen Token akzeptiert.
Schritt 1: Die Session einrichten
Speichern Sie den ersten Block als turnstile_form.py. Die zwei Blöcke danach kommen ans Ende derselben Datei. Die Hilfsfunktion read_input liest ein verstecktes Eingabefeld, und send_form sendet Ihre Felder per POST. Sie setzt den Header Referer auf die Formularseite, wie es ein Browser täte, weil requests von sich aus keinen sendet.
# 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)Schritt 2: Den Fehler reproduzieren
Senden Sie das Formular so, wie es ein Skript meist zuerst tut, mit Ihren eigenen Feldern und sonst nichts. Fügen Sie als Nächstes diesen Block hinzu. Gegen meinen Mock war die Antwort Status 200, mit erneut angezeigter Seite und der Meldung in ihrer Fehlerliste. Ihre Website leitet eventuell weiter oder antwortet mit 422, suchen Sie den Satz also im 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.']Schritt 3: Mit einem Token von CapSkip beheben
Lesen Sie den Sitekey aus dem Attribut data-sitekey des Widgets, fordern Sie bei CapSkip mit der Methode turnstile des Lösers einen Token an und senden Sie den Wert code des Ergebnisses unter dem genauen Feldnamen. Die CapSkip-API-Dokumentation sagt, dass der Löser für Turnstile einen bestimmten Browser-User-Agent verwendet, dass Sie denselben mit dem Token senden müssen und dass die Antwort ihn enthält. Der Block kopiert ihn auf die Session, wenn er vorhanden ist. Mein Mock hat einen zurückgegeben, und ich habe nicht gesehen, was die echte App für ein Widget zurückgibt.
Ein Token funktioniert nur einmal. Laut Cloudflare ist jeder Token 300 Sekunden gültig und für eine einmalige Verwendung gedacht, fordern Sie ihn also direkt vor dem Formular-POST an und nicht am Anfang eines langen Skripts. Steht der Sitekey nicht in einem Attribut data-sitekey, weil die Seite stattdessen die Funktion render aufruft, kopieren Sie ihn einmal aus diesem Aufruf.
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)Gegen den Mock lieferten alle drei Python-Versionen diese Ergebnisse:
| Mock-Einstellung | Was passiert ist |
|---|---|
| Schritt 2, kein Feld gesendet | Die Meldung erschien, und der CapSkip-Mock erhielt keine Aufgabe |
| Schritt 3, Token unter dem richtigen Namen gesendet | Eine Aufgabe, der Formular-POST wurde angenommen |
| Die Website erwartet einen anderen Feldnamen | Die Meldung nannte den anderen Namen, und das Senden des Tokens darunter wurde angenommen |
| Token ein zweites Mal gesendet | Eine andere Meldung, "The captcha could not be verified", das Feld war also vorhanden, aber der Token war verbraucht |
| Feld mit leerem Wert gesendet | Dieselbe Pflichtmeldung, ein leeres Feld zählt also als fehlend |
| Mock so eingestellt, dass er den User-Agent prüft | Der Token wurde ohne Übernahme des zurückgegebenen User-Agent abgelehnt und mit Übernahme angenommen |
| Derselbe Token, kein Referer-Header | 403 vom Mock, dessen eigene Regel einen Referer derselben Herkunft verlangt |
Lesen Sie die Tabelle als Test meines Mocks. Der Wortlaut der Meldung, die einmalige Verwendung und die Referer-Regel stammen von mir, und eine echte Website entscheidet selbst.
Wenn die Meldung nach dem Hinzufügen des Tokens bleibt
- Eine andere Meldung, etwa zu fehlgeschlagener Verifizierung, bedeutet, dass das Feld angekommen ist. Sehen Sie sich den Token an: zweimal verwendet, älter als fünf Minuten oder für eine andere Seitenadresse angefordert.
FAQ
Ist der Fehler zu cf-turnstile-response ein Cloudflare-Fehler?
Nein. Es ist die Validierung der Website, die ein fehlendes Formularfeld meldet. Cloudflare wird erst beteiligt, wenn die Website einen Token an ihren Verifizierungs-Endpunkt sendet.
Gilt das auch für eine Cloudflare-Challenge-Seite?
Nein. Eine ganzseitige Challenge ist kein Formularfeld. CapSkip beantwortet sie mit einem Cookie, und die API-Dokumentation beschreibt diese Methode gesondert. Die Leitfäden für PHP und Node.js zeigen die beiden zusätzlichen Werte, die eine Turnstile-Challenge-Seite braucht. Wie sie gesendet werden, steht in Turnstile in PHP lösen sowie für die Node.js-Version in Turnstile in Node.js lösen.
Kann das Skript auf einem anderen Rechner laufen als CapSkip?
Ja, über den Server-Modus. Übergeben Sie die Adresse des CapSkip-PCs als host. Die Einrichtungsanleitung sagt, dass eine statische öffentliche IP den stabilsten Fernzugriff für ein Server-Setup bietet, und der Server-Modus verlangt, dass CapSkip als Administrator läuft. Ihr Löser läuft weiterhin auf Ihrer eigenen Windows-Hardware, ohne Abrechnung pro Lösung.
Die Kurzfassung
Der Fehler bedeutet, dass der Server keinen Wert für cf-turnstile-response gesehen hat. Sorgen Sie im Browser dafür, dass das Widget gerendert wird. Fordern Sie in einem Skript direkt vor dem Formular-POST einen Token an und senden Sie ihn unter dem Namen, den die Meldung zeigt. Da CapSkip ein lokaler Captcha-Löser ist, der auf Ihrem eigenen PC läuft, kostet jeder erneute Versuch mit einer lizenzierten Kopie keine zusätzliche Gebühr. Die Python-Captcha-Solver-Seite listet die weiteren SDK-Aufrufe auf, und die API-Dokumentation enthält die Rohanfrage.
