reCAPTCHA-Messwerte überwachen

In diesem Dokument werden die reCAPTCHA-Messwerte beschrieben, die Ihre Identity Platform aufgrund der Integration von Identity Platform in die reCAPTCHA Enterprise API ausgibt, und wie Sie sie mit Cloud Monitoring aufrufen können.

reCAPTCHA-Messwerte

Nachdem Sie die Identity Platform-Integration mit der reCAPTCHA Enterprise API eingerichtet und optional reCAPTCHA SMS Defense aktiviert haben, können Sie die reCAPTCHA-Messwerte Ihres Projekts überwachen, um sicherzustellen, dass Ihre Authentifizierungsabläufe geschützt sind. Wenn die Bereitstellung des reCAPTCHA-Schlüssels fehlschlägt oder die erforderlichen Dienstkonten nicht erstellt wurden, schlägt die reCAPTCHA-Authentifizierung fehl.

Wenn Sie den reCAPTCHA-Botschutz im Prüfmodus für E‑Mail-Passwort-Authentifizierungsabläufe aktiviert haben, können Sie anhand der reCAPTCHA-Messwerte feststellen, ob Sie die Erzwingung aktivieren können. Bevor Sie die Erzwingung aktivieren, sollten Sie Folgendes beachten:

  • Wenn die meisten der letzten Anfragen gültige Tokens haben und das Verhältnis von PASSED- zu FAILED_AUDIT- oder FAILED_ENFORCE-Ergebnissen für Ihren Anwendungsfall akzeptabel ist, sollten Sie die Erzwingung aktivieren.
  • Wenn ein Großteil der letzten Anfragen wahrscheinlich von veralteten Clients stammt, solltest du warten, bis mehr Nutzer ihre App aktualisiert haben, bevor du die Erzwingung aktivierst. Wenn Sie die Identity Platform-Integration mit der reCAPTCHA Enterprise API erzwingen, funktionieren frühere App-Versionen, die nicht in reCAPTCHA eingebunden sind, nicht mehr.

Damit die Integrationsfunktionen wie vorgesehen funktionieren, können Sie die folgenden Messwerte prüfen, die Ihr Projekt an Cloud Monitoring sendet.

identitytoolkit.googleapis.com/recaptcha/verdict_count

Mit diesem Messwert werden die verschiedenen von reCAPTCHA zurückgegebenen Ergebnisse erfasst. Wenn ein Token vorhanden ist, wird ein Urteil generiert. Sie können nach den folgenden Ergebnissen filtern:

  • PASSED: Gibt an, dass eine bestimmte Anfrage zulässig ist, wenn die Erzwingung aktiviert ist.
  • FAILED_AUDIT: Gibt an, dass eine bestimmte Anfrage zur Authentifizierung mit E-Mail-Adresse und Passwort abgelehnt wird, wenn der reCAPTCHA-Prüfmodus aktiviert ist.
  • FAILED_ENFORCE: Gibt an, dass eine bestimmte Anfrage abgelehnt wird, wenn die reCAPTCHA-Erzwingung aktiviert ist.
  • CLIENT_TYPE_MISSING: Gibt an, dass bei einer bestimmten Anfrage der Clienttyp fehlt, wenn die reCAPTCHA-Erzwingung aktiviert ist. Dieser Fehler tritt in der Regel auf, wenn eine Anfrage mit einer veralteten Client-SDK-Version gesendet wurde, die reCAPTCHA nicht unterstützt.
  • KEYS_MISSING: Gibt an, dass eine bestimmte Anfrage nicht verifiziert werden kann, weil Identity Platform keine gültigen reCAPTCHA-Schlüssel abrufen kann, wenn die reCAPTCHA-Erzwingung aktiviert ist.

Informationen zum Ändern der Punktzahlbereiche, um das Verhältnis von bestandenen zu nicht bestandenen Prüfungen zu ändern, finden Sie unter reCAPTCHA-Bot-Schutz aktivieren.

identitytoolkit.googleapis.com/recaptcha/token_count

Dieser Messwert erfasst die Anzahl und den Status der reCAPTCHA-Tokens, die vom Identity Platform-Backend empfangen wurden. Sie können nach den folgenden Status filtern:

  • VALID: Gibt an, dass das übergebene reCAPTCHA-Token gültig ist.
  • EXPIRED: Gibt an, dass das übergebene reCAPTCHA-Token abgelaufen ist. Ein abgelaufenes Token kann auf Netzwerkprobleme des Clients oder Missbrauch hinweisen.
  • DUPLICATE: Gibt an, dass das übergebene reCAPTCHA-Token ein Duplikat ist. Ein doppeltes Token kann auf Netzwerkprobleme des Clients oder Missbrauch hinweisen.
  • INVALID: Gibt an, dass das übergebene reCAPTCHA-Token ungültig ist. Ein ungültiges Token kann auf Missbrauch hindeuten.
  • MISSING: Gibt an, dass das reCAPTCHA-Token in der angegebenen Anfrage nicht vorhanden ist. Fehlende Tokens können auf eine veraltete Client-App hinweisen.
  • UNCHECKED: Gibt an, dass das reCAPTCHA-Token aufgrund von CLIENT_TYPE_MISSING- oder KEYS_MISSING-Ergebnissen nicht geprüft wurde.

Wenn Ihre App erfolgreich für Nutzer eingeführt wurde, sehen Sie Traffic mit gültigen Tokens. Die Anzahl der gültigen Tokens ist wahrscheinlich proportional zur Anzahl der Nutzer, die Ihre aktualisierte App verwenden.

identitytoolkit.googleapis.com/recaptcha/risk_scores

Mit diesem Messwert wird die Verteilung der reCAPTCHA-Werte erfasst. So können Sie die optimalen Punktzahlbereiche für Ihre Bot-Schutzkonfiguration definieren.

identitytoolkit.googleapis.com/recaptcha/sms_tf_risk_scores

Mit diesem Messwert wird die Verteilung der Risikobewertung für reCAPTCHA SMS Defense für ein bestimmtes Identity Platform-Projekt erfasst. So können Sie die optimalen Punktzahlbereiche für Ihre reCAPTCHA SMS Defense-Konfiguration definieren.

reCAPTCHA-Messwerte ansehen

So rufen Sie die reCAPTCHA-Messwerte mit Cloud Monitoring auf:

  1. Wechseln Sie in der Google Cloud Console zur Seite Metrics Explorer.

    Zu Metrics Explorer

  2. Geben Sie unter Messwert auswählen den Wert Identity Toolkit-Mandant ein. Wenn Sie die Mehrmandantenfähigkeit verwenden, können Sie Messwerte für jeden Mandanten sowie für das übergeordnete Projekt aufrufen, indem Sie tenant_name leer lassen.

Nächste Schritte