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

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.
| Variante | An in.php gesendete Felder | Python-Aufruf | Node.js-Aufruf |
|---|---|---|---|
| v2 checkbox | googlekey, pageurl | recaptcha(sitekey, url) | recaptcha(sitekey, url) |
| v2 Invisible | fügt invisible=1 hinzu | fügt invisible=1 hinzu | Optionen mit invisible auf 1 |
| v3 | fügt version=v3 und eine action hinzu | version="v3", action="login" | Optionen mit version auf v3 und einer action |
| Enterprise v2 | fügt enterprise=1 hinzu | fügt enterprise=1 hinzu | Optionen mit enterprise auf 1 |
| Enterprise v2 Invisible | fügt enterprise=1 und invisible=1 hinzu | beide Schlüsselwortargumente | beide Optionen |
| Enterprise v3 | fügt version=v3, eine action und enterprise=1 hinzu | alle drei Schlüsselwortargumente | alle 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 fieldFü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 namedDas 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.
| Variante | Woher der Token kommt | Backend-Prüfung | Felder, die es lesen kann |
|---|---|---|---|
| v2 checkbox | Das Widget, gesendet als g-recaptcha-response | Klassische Verifizierung | Success, Challenge-Zeit, Hostname |
| v2 Invisible | Ein execute-Aufruf oder eine gebundene Schaltfläche, an den Callback übergeben | Klassische Verifizierung | Success, Challenge-Zeit, Hostname |
| v3 | Ein execute-Aufruf, der eine action nennt | Klassische Verifizierung | Ergänzt Score und action |
| Enterprise, Key mit Score | Der enterprise-execute-Aufruf | Ein Assessment im Backend | Token-Gültigkeit, action, Risiko-Score |
| Enterprise, Checkbox-Key | Das aus dem enterprise-Skript gerenderte Widget | Ein Assessment im Backend | Token-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:
- Der Löser für reCAPTCHA v2, gedacht für Checkbox-, Invisible- und Callback-Widgets
- Der Löser für reCAPTCHA v3, gedacht für Seiten mit Score
- Der Löser für reCAPTCHA Enterprise, gedacht für beide Stile
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.
