reCAPTCHA v2 vs v3 vs Enterprise: Welche CapSkip-Felder Sie senden

recaptcha v2 vs v3 - reCAPTCHA v2 vs v3 vs Enterprise: CapSkip Fields to Send

Die Frage reCAPTCHA v2 gegen v3 hat für alle, die Token im Code abrufen, eine praktische Antwort: Sie entscheidet, welche Felder in die Löser-Anfrage gehören. v2 braucht einen Sitekey und eine Seitenadresse, v3 zusätzlich einen action-Namen, und Enterprise ist ein zusätzliches Flag bei beiden. Dieser Beitrag ist der Spickzettel für die Anfrage. Für die Widget-Seite, also woran Sie jedes erkennen, lesen Sie zuerst, was reCAPTCHA ist und danach geht es hier mit den Feldern weiter.

Welche CapSkip-Felder jede reCAPTCHA-Variante braucht

CapSkip ist mit 2captcha kompatibel, daher besteht jede Variante aus einer Aufgabe mit der Methode userrecaptcha und die Flags wählen die Variante aus. Die Namen stammen aus der API-Dokumentation und wurden am Quellcode des Python- und des Node.js-SDK in Version 1.7.0 geprüft.

VarianteAn in.php gesendete FelderPython-AufrufNode.js-Aufruf
v2 checkboxgooglekey, pageurlrecaptcha(sitekey, url)recaptcha(sitekey, url)
v2 Invisiblefügt invisible=1 hinzufügt invisible=1 hinzuOptionen mit invisible auf 1
v3fügt version=v3 und eine action hinzuversion="v3", action="login"Optionen mit version auf v3 und einer action
Enterprise v2fügt enterprise=1 hinzufügt enterprise=1 hinzuOptionen mit enterprise auf 1
Enterprise v2 Invisiblefügt enterprise=1 und invisible=1 hinzubeide Schlüsselwortargumentebeide Optionen
Enterprise v3fügt version=v3, eine action und enterprise=1 hinzualle drei Schlüsselwortargumentealle drei Optionen

Drei Details sparen Zeit bei der Fehlersuche. Erstens nennt die API-Dokumentation action=verify als Standardwert für v3. Keines der SDKs sendet eine action, wenn Sie sie weglassen, der Standardwert wird also von der App angewendet, und das konnte ich nicht testen. Wenn eine Seite auf action=login prüft, müssen Sie den Wert übergeben. Zweitens gehört der Callback nicht zur Anfrage: CapSkip gibt den Token zurück, und bei einem Callback- oder Invisible-Widget ruft Ihr Seitencode den Callback damit auf. Drittens sagt die API-Dokumentation, dass eine v2-Enterprise-Seite eine zusätzliche eigene Zeichenfolge in einem Parameter s oder data-s tragen kann. Hat die Seite eine, senden Sie sie als Feld data-s, das die SDKs unter dem Schlüsselwort datas akzeptieren.

Hier sind die v2-Varianten in Python. Der Token kommt unter dem Schlüssel code des Ergebnisses zurück.

# pip install capskip
from capskip import CapSkip

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"
KEY = "YOUR_SITEKEY"

# Checkbox v2, then the invisible flavour of v2.
v2 = solver.recaptcha(sitekey=KEY, url=PAGE)
invisible = solver.recaptcha(sitekey=KEY, url=PAGE, invisible=1)

# Enterprise is a flag. Add the page's data-s value if it has one.
ent = solver.recaptcha(sitekey=KEY, url=PAGE, enterprise=1,
                       datas="YOUR_DATA_S")
ent_inv = solver.recaptcha(sitekey=KEY, url=PAGE, enterprise=1, invisible=1)

print(v2["code"][:20])   # token, ready for the form field

Für v3 nennen Sie die Version und die action, die die Seite an ihren execute-Aufruf übergibt.

# pip install capskip
from capskip import CapSkip

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"
KEY = "YOUR_SITEKEY"

v3 = solver.recaptcha(sitekey=KEY, url=PAGE, version="v3", action="login")

# v3 Enterprise adds the same flag as v2 Enterprise.
ent_v3 = solver.recaptcha(sitekey=KEY, url=PAGE, version="v3",
                          action="login", enterprise=1)

print(v3["code"][:20])   # token for the action you named

Das Node.js-SDK nimmt dieselben Entscheidungen als Options-Objekt nach dem Sitekey und der Seitenadresse entgegen.

// npm install capskip
const { CapSkip } = require('capskip');

const solver = new CapSkip({ host: '127.0.0.1', port: 8080 });
const PAGE = 'https://example.com/page-with-recaptcha';

(async () => {
  const v3 = await solver.recaptcha('YOUR_SITEKEY', PAGE,
    { version: 'v3', action: 'login' });
  const ent = await solver.recaptcha('YOUR_SITEKEY', PAGE,
    { enterprise: 1, invisible: 1 });
  console.log(v3.code.slice(0, 20), ent.code.slice(0, 20));
})();

Beide SDKs lehnen außerdem vermischte Anfragen ab, bevor etwas gesendet wird. Eine action bei einer v2-Aufgabe und das Invisible-Flag bei einer v3-Aufgabe lösen jeweils die Validierungs-Exception aus, was günstiger ist, als es an einem fehlgeschlagenen Formular-POST zu merken.

# pip install capskip
from capskip import CapSkip, ValidationException

solver = CapSkip(host="127.0.0.1", port=8080)
PAGE = "https://example.com/page-with-recaptcha"

try:
    # An action only exists on v3, so this v2 task is refused locally.
    solver.recaptcha(sitekey="YOUR_SITEKEY", url=PAGE, action="login")
except ValidationException as err:
    print("refused:", err)

Ich habe diese Blöcke gegen einen Mock von in.php und res.php ausgeführt, nicht gegen die echte App, auf Python 3.11.7, 3.13.7 und 3.14.0 sowie auf Node.js 24.22.0, alles mit capskip 1.7.0. Der Mock hat die Felder aufgezeichnet, die jeder Aufruf gesendet hat, und sie stimmten mit der Tabelle überein: Jeder Aufruf trug die Methode, den Sitekey und die Seitenadresse, dazu einen ausdrücklichen enterprise-Wert von 0 oder 1, den das SDK einfügt, und die anderen Varianten fügten genau die aufgeführten Flags hinzu. Das belegt die Form der Anfrage, nicht eine Lösung.

Was der Server bei jeder Variante prüft

Die Unterschiede auf der Empfangsseite machen die Flags nötig. Diese Tabelle vergleicht nur, was das Backend einer Website sieht.

VarianteWoher der Token kommtBackend-PrüfungFelder, die es lesen kann
v2 checkboxDas Widget, gesendet als g-recaptcha-responseKlassische VerifizierungSuccess, Challenge-Zeit, Hostname
v2 InvisibleEin execute-Aufruf oder eine gebundene Schaltfläche, an den Callback übergebenKlassische VerifizierungSuccess, Challenge-Zeit, Hostname
v3Ein execute-Aufruf, der eine action nenntKlassische VerifizierungErgänzt Score und action
Enterprise, Key mit ScoreDer enterprise-execute-AufrufEin Assessment im BackendToken-Gültigkeit, action, Risiko-Score
Enterprise, Checkbox-KeyDas aus dem enterprise-Skript gerenderte WidgetEin Assessment im BackendToken-Gültigkeit, Risiko-Score

Für alle gilt dieselbe Regel: Ein Token ist zwei Minuten gültig und lässt sich nur einmal verifizieren. Der Verifizierungsleitfaden von Google sagt das für den klassischen Endpunkt, und sein Assessment-Leitfaden wiederholt es für Enterprise, deshalb sollten Sie den Leitfaden zum Token-Ablauf für jede Zeile beachten. Die v3-Dokumentation von Google ergänzt, dass die Website die zurückgegebene action mit der erwarteten abgleichen soll, und der Assessment-Leitfaden sagt, dass Assessments ins Backend gehören.

Zur Frage Enterprise gegen v3: Google beschreibt zwei Arten von Enterprise-Keys. Keys mit Score rufen die enterprise-execute-Funktion auf, wie es v3 tut. Checkbox-Keys rendern ein Widget aus dem enterprise-Skript, wie es v2 tut, und rufen sie nie auf. Deshalb ist Enterprise ein Flag in der Anfrage und keine dritte Version.

Der Score gehört Google und ist keine CapSkip-Option

Google bewertet einen v3-Besuch von 0,0 für sehr wahrscheinlich ein Bot bis 1,0 für sehr wahrscheinlich eine gute Interaktion und schlägt 0,5 als Standard-Schwellenwert vor. CapSkip hat keine Einstellung, die einen Score anfordert, daher kann nichts in Ihrem Lösungscode eine Zahl versprechen. Sie steuern die action, die Sie übergeben, und den Zeitpunkt der Anfrage.

Die Werte von der Seite ablesen

Der Sitekey steht im Attribut data-sitekey oder im Parameter k der Frame-Adresse des Widgets. Bei v3 und Enterprise-Keys mit Score ist die action die Zeichenfolge im execute-Aufruf der Seite. Enterprise verrät sich durch das enterprise-Skript und durch Aufrufe am enterprise-Objekt. Die Löser-Leitfäden pro Variante gehen tiefer:

Von einem anderen Rechner aus aufrufen

CapSkip ist eine Windows-Anwendung, und die Beispiele oben sprechen es unter 127.0.0.1 an. Laufen Ihre Skripte woanders, schalten Sie CapSkip in den Server-Modus und richten die Host-Einstellung auf diesen Windows-PC. Die Einrichtungsanleitung beschreibt den Wechsel unter Verbindungseinstellungen und empfiehlt eine statische öffentliche IP für stabilen Fernzugriff. Der Server-Modus lässt den Port von jeder Adresse aus erreichbar, weil CapSkip bei jedem Start eine Erlauben-Regel dafür hinzufügt. Um Aufrufer einzuschränken, fügen Sie eine Windows-Firewall-Blockregel für die Adressen hinzu, denen Sie nicht vertrauen.

FAQ

Ist reCAPTCHA v2 oder v3 schwerer zu automatisieren?

Keines braucht andere Werkzeuge: Beide sind eine Aufgabe mit unterschiedlichen Flags. Der praktische Unterschied ist, dass v3 kein Widget hat, das Sie beobachten können. Sie finden die action im Seitenskript, und das Ergebnis hängt von einem Google-Score ab, den Sie nicht festlegen können.

Zeigt v3 jemals eine Challenge?

Laut Google nicht, denn v3 unterbricht Nutzer nie. Eine Website, die nach einem niedrigen Score einen sichtbaren Schritt will, muss ihn selbst bauen.

Ist Enterprise v2 oder v3?

Beides. Enterprise ist die Produktstufe, die Seite bestimmt also den Stil. In CapSkip fügen Sie das Flag enterprise zu einer v2-Aufgabe oder zu einer v3-Aufgabe hinzu, und sonst ändert sich nichts an der Anfrage.

Kann ich den Score wählen, den CapSkip erhält?

Nein. CapSkip hat dafür keine Einstellung. Übergeben Sie die richtige action, fordern Sie den Token direkt vor der Anfrage an, die ihn nutzt, und lesen Sie das Ergebnis von der Website ab.

Welchen lösen Sie gerade?

Sehen Sie sich zuerst die Seite an: Ein Kästchen oder ein unsichtbarer Auslöser bedeutet v2, ein execute-Aufruf mit einer action bedeutet v3, und das enterprise-Skript bedeutet ein Flag bei einem von beiden. Gleichen Sie dann die Zeile in der Anfragetabelle ab. Da CapSkip auf Ihrem eigenen Windows-PC als unbegrenzter Captcha-Löserläuft, erhöht das keine Rechnung, wenn Sie für jede Variante einen frischen Token anfordern oder nach Ablauf erneut.