Die Aufgabe ist fertig. Warum wird das reCAPTCHA-Token abgelehnt?

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

In diesem Beispiel ist solution.token der Wert, der dort zu übermitteln ist, wo die Zielwebsite ihr reCAPTCHA-Token erwartet. id identifiziert die solvethree-Aufgabe; es ist kein Token. Senden Sie auch nicht das gesamte Lösungsobjekt.

Prüfen Sie die endgültige ausgehende Anfrage, nicht nur die Variable mit der Antwort. Stellen Sie sicher, dass sie das aktuelle Token enthält und nicht einen leeren Wert oder ein älteres Token, das im Formular verblieben ist. Halten Sie Tokens aus gemeinsam genutzten Protokollen fern.

Das übermittelte Token ist korrekt, aber die Zielwebsite lehnt es weiterhin ab.

Vergleichen Sie den Website-Hostnamen der Aufgabe mit dem Hostnamen der geschützten Anfrage. Achten Sie auf eine abweichende Subdomain oder Umgebung.

Probiere Folgendes: Fordern Sie das Token für den vorgesehenen Hostnamen an und senden Sie es an dieses Ziel. Für die Zielwebsite muss in Ihrem Workspace ein aktives Profil verfügbar sein.

Ein für eine Interaktion angefordertes Token wird für eine andere verwendet.

Vergleichen Sie die Aktion der Aufgabe mit der genauen Aktion, die für diese geschützte Anfrage erwartet wird.

Probiere Folgendes: Verwenden Sie die Aktion, die zu der von Ihnen übermittelten Interaktion gehört.

Die Integration verwendet die falsche reCAPTCHA-Variante.

Prüfen Sie recaptchaType in der Aufgabenanfrage. Der Standardwert ist enterprise-v3; das Gateway akzeptiert auch v3.

Probiere Folgendes: Geben Sie das Produkt des Ziels explizit an. Verwenden Sie für Enterprise v3 enterprise-v3.

Sowohl klassische reCAPTCHA-Tokens als auch Website-Antworttokens von reCAPTCHA Enterprise laufen nach zwei Minuten ab und sind nur einmal verwendbar. Klassische Tokens können einmal verifiziert werden; Enterprise-Tokens können einmal bewertet werden. Lassen Sie das Token zeitnah zur geschützten Anfrage lösen, statt einen Vorrat fertiger Tokens anzulegen.

• Wenn die Übermittlung verzögert erfolgt, prüfen Sie, wie viel Zeit zwischen dem Lösen und dem Senden des Tokens vergangen ist.
• Wenn das Token bereits verifiziert oder bewertet wurde, verwenden Sie es nicht für eine weitere Übermittlung.
• Führen Sie keine separate Verifizierung oder Enterprise-Bewertung durch, nur um das Token vor dem Senden an das Ziel zu testen. Dieser Test kann es verbrauchen.

Das Lösen gelingt, aber die Übermittlung verwendet eine andere Verbindung.

Vergleichen Sie den beim Lösen erfolgreichen Proxy mit dem Proxy für die geschützte Anfrage. Wenn Sie proxyCandidates angegeben haben, gehen Sie nicht davon aus, dass der erste Kandidat erfolgreich war.

Probiere Folgendes: Übermitteln Sie die Anfrage über den erfolgreichen Proxy. Ein Wechsel der IP-Adresse zwischen Lösen und Übermittlung kann die Anfrage scheitern lassen.

Der übermittelnde Client verwendet seine eigenen Standard-Browserheader.

Vergleichen Sie die ausgehenden Werte von User-Agent und Sec-CH-UA mit solution.userAgent und solution.secChUa.

Probiere Folgendes: Verwenden Sie die zurückgegebene Browseridentität zusammen mit dem erfolgreichen Proxy. Kombinieren Sie das Token nicht mit fremden User-Agent- oder Client-Hint-Werten.

Prüfen Sie sowohl den Antworttext des Ziels als auch dessen HTTP-Status. Ein 403 allein zeigt nicht, welcher Schutz die Anfrage abgelehnt hat. Suchen Sie nach einem expliziten Tokenfehler oder einer Abweichung bei Hostname oder Aktion, bevor Sie ein weiteres Token anfordern.

Wenn Verifizierungsdetails verfügbar sind, prüfen Sie bei klassischem reCAPTCHA das Ergebnis success sowie die zurückgegebenen Kontext- und Fehlerinformationen. Prüfen Sie bei Enterprise die Token-Gültigkeit und die relevanten Bewertungsgründe. Gehen Sie nicht davon aus, dass ein Score allein die Ablehnung erklärt: Die Website entscheidet, wie sie die Bewertung verwendet.

Wenn Sie die Ursache weiterhin nicht ermitteln können, wenden Sie sich an [email protected] und geben Sie die Aufgaben-ID sowie, falls verwendet, requestId, Produkt, Zeitstempel, Zielhostname und Aktion, HTTP-Status oder Aufgabenfehler sowie eine bereinigte Beschreibung der Antwort an. Entfernen Sie API-Schlüssel, Proxy-Passwörter, Tokens, Cookies und Kundendaten.