Fehlerbehebung bei der Integration von Identity Platform in die reCAPTCHA Enterprise API

In diesem Dokument finden Sie eine Anleitung zur Fehlerbehebung bei potenziellen Problemen, die bei der Verwendung der Identity Platform-Integration mit der reCAPTCHA Enterprise API auftreten können, einschließlich der reCAPTCHA-Bot-Schutz- und reCAPTCHA SMS Defense-Funktionen.

Fehlerbehebung bei der Integration

Ihre Nutzer haben möglicherweise Probleme, weil bei der Einrichtung der Identity Platform-Integration mit der reCAPTCHA Enterprise API Fehler aufgetreten sind. Hier sind einige häufige Gründe:

  • Möglicherweise haben Sie bei der Einrichtung der Identity Platform-Integration mit der reCAPTCHA Enterprise API einen Schritt übersehen. Beispielsweise kann es sein, dass das Dienstkonto nicht eingerichtet oder die reCAPTCHA Enterprise API für das Projekt nicht aktiviert wurde. Prüfen Sie, ob Sie alle Integrationsanforderungen erfüllt haben. Eine Einrichtungsanleitung finden Sie unter Identity Platform in die reCAPTCHA Enterprise API einbinden.
  • Wenn Sie Ihren eigenen Schlüssel für reCAPTCHA verwenden, ist der von Ihnen hochgeladene reCAPTCHA-Schlüssel möglicherweise nicht gültig oder funktioniert nicht mehr. Prüfen Sie, ob der Schlüssel funktioniert und für die Identity Platform zugänglich ist.
  • Nutzer verwenden möglicherweise eine veraltete Version Ihrer App. Stellen Sie eine aktualisierte Version Ihrer App bereit, die das Client SDK verwendet, und bitten Sie Ihre Nutzer, ihre App zu aktualisieren. Informationen zum Einrichten des Client SDK für Ihre App finden Sie unter Client SDK konfigurieren.

Nutzer können sich nicht über die von der reCAPTCHA Enterprise API unterstützten Abläufe authentifizieren.

Wenn Sie Probleme mit von der reCAPTCHA Enterprise API unterstützten Abläufen haben, z. B. mit dem reCAPTCHA-Bot-Schutz oder der reCAPTCHA SMS Defense, finden Sie in den folgenden Abschnitten funktionsspezifische Anleitungen.

Fehlerbehebung für den reCAPTCHA-Schutz vor Bots

In den folgenden Themen werden mögliche Probleme beschrieben, die bei der Verwendung des Botschutzes auftreten können, und wie Sie diese beheben können.

Nutzer können sich nicht authentifizieren, wenn der Botschutz für die E‑Mail-Passwort- oder Telefonanbieter verwendet wird.

Wenn Sie festgestellt haben, dass die Integration der Identity Platform in die reCAPTCHA Enterprise API korrekt eingerichtet wurde, können Nutzer aufgrund Ihrer aktuellen Konfiguration möglicherweise keine Authentifizierungsaktionen über die E-Mail-Passwort- oder Telefonanbieter ausführen. Nutzer können beispielsweise die folgenden Aktionen nicht ausführen:

  • Anmeldung, Registrierung oder Zurücksetzen eines Passworts über eine E‑Mail-Adresse
  • Fordern Sie einen SMS-Code an, um sich mit einer Telefonnummer anzumelden.
  • Registrieren Sie sich für die SMS-basierte Multi-Faktor-Authentifizierung oder melden Sie sich damit an.

Versuchen Sie Folgendes, um diese Authentifizierungsprobleme zu beheben:

  • Wenn Nutzeranfragen mit ERROR_CAPTCHA_CHECK_FAILED fehlschlagen, sollten Sie eine weniger restriktive Konfiguration in Betracht ziehen, indem Sie die für managedRules festgelegten Schwellenwerte anpassen. Alle Anfragen, die unter dem von Ihnen festgelegten Schwellenwert liegen, werden als Bot eingestuft. Wenn Sie beispielsweise einen Schwellenwert von 0.6 festlegen, schlägt reCAPTCHA bei allen Anfragen mit einem Wert von 0.5 oder niedriger fehl. Je höher Sie den Wert festlegen, desto strenger sind die Regeln.
  • Bitte den Nutzer, ein anderes Gerät, einen anderen Browser oder ein anderes Netzwerk zu verwenden.
  • Setzen Sie bei Authentifizierungsabläufen mit E-Mail-Adresse und Passwort emailPasswordEnforcementState auf den Modus AUDIT zurück und beobachten Sie die Messwerte, bevor Sie den Modus ENFORCE wieder aktivieren.
  • Passen Sie für die Telefonauthentifizierung die managedRules-Punkteschwellenwerte an oder deaktivieren Sie den Botschutz für den Telefonanbieter, während Sie das Problem beheben. Wenn reCAPTCHA SMS Defense ebenfalls aktiviert ist und Sie es aktiv lassen möchten, setzen Sie useSmsBotScore auf false und lassen Sie phoneEnforcementState auf ENFORCE gesetzt. Wenn Sie den gesamten reCAPTCHA-Schutz für Smartphones deaktivieren möchten, setzen Sie phoneEnforcementState auf OFF, useSmsBotScore auf false und useSmsTollFraudProtection auf false.

Fehlerbehebung für reCAPTCHA SMS Defense

In den folgenden Abschnitten werden mögliche Probleme beschrieben, die bei der Verwendung von reCAPTCHA SMS Defense auftreten können, und wie Sie diese beheben können.

Nutzer können sich nicht authentifizieren, wenn reCAPTCHA SMS Defense für den Telefonanbieter verwendet wird

Wenn Sie festgestellt haben, dass die Integration der Identity Platform in die reCAPTCHA Enterprise API korrekt eingerichtet wurde, können Nutzer aufgrund Ihrer aktuellen Konfiguration möglicherweise keine SMS-basierten Authentifizierungsaktionen über den Telefonanbieter ausführen. Beispielsweise können Nutzer möglicherweise keinen SMS-Code anfordern, um sich mit einer Telefonnummer anzumelden, sich für die Multi-Faktor-Authentifizierung zu registrieren oder sich mit ihr anzumelden. Das kann passieren, wenn der von Ihnen festgelegte reCAPTCHA SMS Defense-Wert zu streng ist.

Um dieses Problem zu beheben, sollten Sie eine weniger restriktive Konfiguration in Betracht ziehen, indem Sie den für tollFraudManagedRules festgelegten Schwellenwert anpassen. Jeder Wert über dem von Ihnen festgelegten Schwellenwert wird als SMS-Gebührenbetrug betrachtet. Wenn Sie beispielsweise einen Schwellenwert von 0.3 festlegen, schlägt jede Anfrage mit einem Wert von 0.4 oder höher fehl. Je niedriger Sie den Wert festlegen, desto strenger sind die Regeln.

Beobachten Sie die von Ihrem Projekt ausgegebenen reCAPTCHA-Messwerte, um zu prüfen, ob Ihre Anwendung nach der Anpassung des Schwellenwerts für die Punktzahl akzeptablen Nutzertraffic erhält.

Nächste Schritte