Auf dieser Seite erfahren Sie, wie Sie einen Wert interpretieren, das Risiko von Nutzerinteraktionen einschätzen und geeignete Maßnahmen für Ihre Website ergreifen.
reCAPTCHA gibt für jede Anfrage einen Wert zurück, der auf den Interaktionen mit Ihrer Website basiert, unabhängig vom Schlüsseltyp. Nachdem Sie den Wert von reCAPTCHA erhalten haben, müssen Sie ihn interpretieren und geeignete Maßnahmen für Ihre Website ergreifen.
Hinweise
Erstellen Sie eine Bewertung für Ihre Website.
Bewertung interpretieren
Nachdem Ihr Backend das reCAPTCHA-Antworttoken eines Nutzers an reCAPTCHA gesendet hat, erhalten Sie eine Bewertung als JSON-Antwort, wie im folgenden Beispiel gezeigt.
Berücksichtigen Sie bei der Interpretation einer Bewertung folgende Parameter:
valid
: Gibt an, ob das bereitgestellte Nutzerantworttoken gültig ist. Wennvalid = false
, wird der Grund ininvalidReason
angegeben.valid = false
kann auch darauf hinweisen, dass ein Nutzer eine Herausforderung nicht gelöst hat oder es einesiteKey
-Abweichung gibt.invalidReason
: Grund für die Antwort, wennvalid = false
.action
: Eine Nutzerinteraktion, die die reCAPTCHA-Überprüfung ausgelöst hat.expectedAction
: Die erwartete Aktion des Nutzers, den Sie beim Erstellen der Bewertung angegeben haben.score
: Risikograd, der die Nutzerinteraktion darstellt.reasons
: Zusätzliche Informationen dazu, wie reCAPTCHA die Nutzerinteraktion interpretiert hat.{ "event":{ "expectedAction":"EXPECTED_ACTION", "hashedAccountId":"ACCOUNT_ID", "siteKey":"KEY_ID", "token":"TOKEN", "userAgent":"(USER-PROVIDED STRING)", "userIpAddress":"USER_PROVIDED_IP_ADDRESS" }, "name":"ASSESSMENT_ID", "riskAnalysis":{ "reasons":[], "score":"SCORE" }, "tokenProperties":{ "action":"USER_INTERACTION", "createTime":"TIMESTAMP", "hostname":"HOSTNAME", "invalidReason":"(ENUM)", "valid":(BOOLEAN) } }
Aktionen prüfen
Die JSON-Antwort enthält den action
-Parameter, den Sie beim Aufrufen von execute()
für eine Nutzerinteraktion angegeben haben, und den expectedAction
-Parameter, den Sie beim Erstellen der Bewertung angegeben haben.
Prüfen Sie, ob action
mit expectedAction
übereinstimmt.
Beispiel: Eine login
-Aktion sollte auf Ihrer Anmeldeseite zurückgegeben werden.
Wenn es eine Abweichung gibt, bedeutet dies, dass ein Angreifer versucht, Aktionen zu fälschen. Sie können Aktionen gegen die Nutzerinteraktion ausführen, z. B. zusätzliche Bestätigungen hinzufügen oder die Interaktion blockieren, um betrügerische Aktivitäten zu verhindern.
Bewertungen interpretieren
Das Bewertungssystem von reCAPTCHA ist eine Erweiterung von früheren Versionen von reCAPTCHA, um eine höhere Genauigkeit bei Antworten zu ermöglichen. reCAPTCHA bietet 11 Grade für Punktzahlen mit Werten zwischen 0,0 und 1,0. Der Wert 1,0 gibt an, dass die Interaktion ein geringes Risiko darstellt und sehr wahrscheinlich legitim ist. 0,0 gibt jedoch an, dass die Interaktion ein hohes Risiko darstellt und betrügerisch sein kann. Von den 11 Graden sind nur die folgenden vier Punktzahl-Stufen verfügbar, bevor eine automatische Sicherheitsüberprüfung ausgelöst wird, wenn Sie Ihrem Projekt ein Abrechnungskonto hinzufügen: 0,1, 0,3, 0,7 und 0,9.
Wenn Sie Zugriff auf 11 Bewertungsstufen anfordern möchten, fügen Sie Ihrem Projekt ein Rechnungskonto hinzu.
reCAPTCHA lernt durch das Überwachen des tatsächlichen Traffics auf Ihrer Website. Daher können die Werte in einer Staging-Umgebung und innerhalb von sieben Tagen nach der Implementierung von den langfristigen Produktionswerten abweichen.
Wenn Sie punktzahlbasierte Schlüssel installiert haben, können Sie reCAPTCHA zuerst ausführen, ohne Maßnahmen zu ergreifen, und dann anhand des Traffics Schwellenwerte festlegen.
Basierend auf der Punktzahl können Sie im Kontext Ihrer Website geeignete Maßnahmen ergreifen. Um Ihre Website besser zu schützen, sollten Sie die Aktion im Hintergrund ausführen, statt den Traffic zu blockieren.
In folgender Tabelle sind einige der Aktionen aufgeführt, die Sie ausführen können:
Anwendungsfall | Aktion |
---|---|
Startseite | Zeigen Sie eine zusammenhängende Ansicht Ihres Traffics auf der Admin-Konsole an, während Sie Scraper filtern. |
login | Bei niedrigen Punktzahlen ist eine Multi-Faktor-Authentifizierung oder eine E-Mail-Bestätigung erforderlich, um Credential Stuffing-Angriffe zu verhindern. |
social | Begrenzen Sie unbeantwortete Freundschaftsanfragen von missbräuchlichen Nutzern und senden Sie riskante Kommentare zur Moderation. |
E-Commerce | Stellen Sie Ihren realen Umsatz vor Bots und identifizieren Sie riskante Transaktionen. |
Ursachencodes
Grundcodes sind verfügbar, nachdem Sie eine automatische Sicherheitsüberprüfung ausgelöst haben, indem Sie Ihrem Projekt ein Abrechnungskonto hinzugefügt haben. Wenn Sie Zugriff auf Grundcodes anfordern möchten, fügen Sie Ihrem Projekt ein Rechnungskonto hinzu.
Einige Ergebnisse werden möglicherweise mit Ursachencodes zurückgegeben, die zusätzliche Informationen dazu enthalten, wie reCAPTCHA die Interaktionen interpretiert hat.
In folgender Tabelle sind die Ursachencodes und ihre Beschreibungen aufgeführt:
Ursachencode | Beschreibung |
---|---|
AUTOMATION | Die Interaktion entspricht dem Verhalten eines automatisierten Agents. |
UNEXPECTED_ENVIRONMENT | Das Ereignis stammte aus einer unzulässigen Umgebung. |
TOO_MUCH_TRAFFIC | Das Trafficvolumen von der Ereignisquelle ist höher als normal. |
UNEXPECTED_USAGE_PATTERNS | Die Interaktion mit Ihrer Website weicht erheblich von den erwarteten Mustern ab. |
LOW_CONFIDENCE_SCORE | Von dieser Website wurde zu wenig Traffic empfangen, um eine qualitative Risikoanalyse zu erstellen. |
Nächste Schritte
- Wenn Sie Ihr website-spezifisches Modell optimieren möchten, können Sie die Bewertungs-IDs an Google zurückschicken, um echte positive und echte negative Ergebnisse zu bestätigen oder Fehler zu korrigieren. Weitere Informationen finden Sie unter Bewertungen annotieren.