Bewertungen für mobile Apps interpretieren

Auf dieser Seite wird erläutert, wie Sie einen Wert interpretieren, um das Risiko von Nutzerinteraktionen zu verstehen und geeignete Maßnahmen für Ihre mobile Anwendung zu ergreifen.

reCAPTCHA gibt für jede Anfrage einen Wert auf Basis der Interaktionen mit Ihrer mobilen Anwendung zurück. Nachdem Sie den Score von reCAPTCHA erhalten haben, müssen Sie ihn interpretieren und entsprechende Maßnahmen für Ihre mobile Anwendung ergreifen.

Hinweis

Erstellen Sie eine Bewertung für Ihre mobile Anwendung.

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. Wenn valid = false, wird der Grund in invalidReason angegeben. valid = false kann auch darauf hinweisen, dass ein Nutzer eine Aufgabe nicht gelöst hat oder dass ein sitekey-Konflikt vorliegt.
  • invalidReason: Grund für die Antwort, wenn valid = 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.

  • extendedVerdictReasons: Erweiterte logische Schlussfolgerungen, die zum Ergebnis der Risikoanalyse beigetragen haben.

    Ursachencodes sind verfügbar, nachdem Sie eine automatische Sicherheitsüberprüfung ausgelöst haben, indem Sie Ihrem Projekt ein Rechnungskonto hinzugefügt haben. Wenn Sie Zugriff auf Ursachencodes anfordern möchten, fügen Sie Ihrem Projekt ein Rechnungskonto hinzu.

    Bewertungen aus Projekten mit einem Enterprise-Abo erhalten auch erweiterte Ursachencodes. Wenden Sie sich an Ihren Kundenbetreuer oder das Google Cloud -Vertriebsteam, um die vollständige Liste der erweiterten logischen Schlussfolgerungen und Informationen zu deren Interpretation zu erhalten.

    {
 "event":{
    "expectedAction":"EXPECTED_ACTION",
    "userInfo":{
      "accountId":"ACCOUNT_ID"
    },
    "siteKey":"KEY_ID",
    "token":"TOKEN",
    "userAgent":"(USER-PROVIDED STRING)",
    "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
 },
 "name":"ASSESSMENT_ID",
 "riskAnalysis":{
   "reasons":[],
   "extendedVerdictReasons":[],
   "score":"SCORE"
 },
 "tokenProperties":{
   "action":"USER_INTERACTION",
   "androidPackageName":"ANDROID_PACKAGE_NAME",
   "createTime":"TIMESTAMP",
   "invalidReason":"(ENUM)",
   "iosBundleId":"IOS_BUNDLE_ID",
   "valid":(BOOLEAN)
 }
}

Aktionen überprü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. Beispielsweise sollte auf der Anmeldeseite die Aktion login zurückgegeben werden. Wenn es eine Abweichung gibt, bedeutet dies, dass ein Angreifer versucht, Aktionen zu fälschen. Sie können Maßnahmen gegen die Nutzerinteraktion ergreifen, 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 früherer Versionen von reCAPTCHA, um eine größere Granularität bei den Antworten zu ermöglichen. reCAPTCHA hat 11 Bewertungsstufen mit Werten von 0,0 bis 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 Stufen sind nur die folgenden vier Punktzahlen verfügbar, bevor eine automatische Sicherheitsüberprüfung ausgelöst wird, indem Sie Ihrem Projekt ein Rechnungskonto 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, indem es den tatsächlichen Traffic in Ihrer mobilen Anwendung überwacht. Daher können die Werte in einer Staging-Umgebung und innerhalb von 7 Tagen nach der Implementierung von den langfristigen Produktionswerten abweichen.

Da reCAPTCHA-Schlüssel für mobile Anwendungen die Aufrufabfolge von Webseiten nicht unterbrechen, können Sie reCAPTCHA zuerst ohne Maßnahmen ausführen und dann auf Grundlage des Traffics Grenzwerte festlegen.

Abhängig von der Punktzahl können Sie in Ihrer mobilen Anwendung entsprechende Maßnahmen ergreifen. Zum besseren Schutz Ihrer mobilen Anwendung empfehlen wir, die Aktion im Hintergrund auszuführen, anstatt den Traffic zu blockieren.

In folgender Tabelle sind einige der Aktionen aufgeführt, die Sie ausführen können:

Anwendungsfall Aktion
Anmeldung Bei niedrigen Punktzahlen ist eine MFA 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.
ecommerce Stellen Sie Ihren realen Umsatz vor Bots und identifizieren Sie riskante Transaktionen.

Ursachencodes

Ursachencodes sind verfügbar, nachdem Sie durch Hinzufügen eines Rechnungskontos eine automatische Sicherheitsüberprüfung ausgelöst haben. Wenn Sie Zugriff auf Ursachencodes anfordern möchten, fügen Sie Ihrem Projekt ein Rechnungskonto hinzu.

Einige Werte werden möglicherweise mit Ursachencodes zurückgegeben, die zusätzliche Informationen darüber 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.