Fix: Der Fehler zum Pflichtfeld cf-turnstile-response

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

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

UrsacheWoran Sie es erkennenBeheben
Das Widget wurde nie gerendertKein Turnstile-Kästchen auf der Seite und eine blockierte Anfrage für das Widget-Skript im Netzwerk-Tab des BrowsersErlauben 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 FormularsDas Kästchen wird angezeigt, aber das versteckte Eingabefeld liegt nicht im FormularelementVerschieben Sie das Widget ins Formular oder kopieren Sie den Token selbst in ein Feld
Das Formular wurde gesendet, bevor das Widget fertig warDer Fehler tritt nur auf, wenn der Besucher sofort absendet, und ein zweiter Versuch funktioniertDeaktivieren Sie die Senden-Schaltfläche, bis das Widget seinen Token erzeugt hat
Das Feld hat einen anderen NamenDie Meldung nennt ein anderes Feld, oder die Seite setzt einen eigenen Namen für das AntwortfeldSenden 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 ausgeschaltetDas Kästchen wird angezeigt, aber das Formular hat kein Eingabefeld namens cf-turnstile-response, und die Seite setzt data-response-field auf falseEntfernen 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 FormularEs ist kein Browser beteiligt, und die Übermittlung enthält nur Ihre eigenen FelderHolen 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-EinstellungWas passiert ist
Schritt 2, kein Feld gesendetDie Meldung erschien, und der CapSkip-Mock erhielt keine Aufgabe
Schritt 3, Token unter dem richtigen Namen gesendetEine Aufgabe, der Formular-POST wurde angenommen
Die Website erwartet einen anderen FeldnamenDie Meldung nannte den anderen Namen, und das Senden des Tokens darunter wurde angenommen
Token ein zweites Mal gesendetEine andere Meldung, "The captcha could not be verified", das Feld war also vorhanden, aber der Token war verbraucht
Feld mit leerem Wert gesendetDieselbe Pflichtmeldung, ein leeres Feld zählt also als fehlend
Mock so eingestellt, dass er den User-Agent prüftDer Token wurde ohne Übernahme des zurückgegebenen User-Agent abgelehnt und mit Übernahme angenommen
Derselbe Token, kein Referer-Header403 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.