reCAPTCHA-Funktionen nach der Migration verwenden

Auf dieser Seite wird erläutert, wie Sie eine bestehende reCAPTCHA-Integration ändern können, um reCAPTCHA-Funktionen wie die Multi-Faktor-Authentifizierung (MFA) und die Erkennung von Passwortlecks zu nutzen, nachdem Sie von reCAPTCHA Classic migriert haben. Zum Ändern einer bestehenden reCAPTCHA-Integration müssen die Webseiten instrumentiert und die Backend-Aufrufe migriert werden.

Hinweise

Zu reCAPTCHA migrieren

Webseiten instrumentieren

So instrumentieren Sie die Webseiten mit den reCAPTCHA-Scripts und ‑Aufrufen:

  1. Prüfen Sie, ob folgendes Skript auf Ihren Webseiten vorhanden ist: https://www.google.com/recaptcha/api.js.

  2. Ersetzen Sie auf Ihren Webseiten https://www.google.com/recaptcha/api.js durch https://www.google.com/recaptcha/enterprise.js.

  3. Wenn Sie die API programmatisch aufrufen, ersetzen Sie folgende Aufrufe:

    • grecaptcha.execute() -> grecaptcha.enterprise.execute()
    • grecaptcha.getResponse() -> grecaptcha.enterprise.getResponse()
    • grecaptcha.ready() -> grecaptcha.enterprise.ready()
    • grecaptcha.render() -> grecaptcha.enterprise.render()
    • grecaptcha.reset() -> grecaptcha.enterprise.reset()

Optional: So verbessern Sie die Ladeleistung von reCAPTCHA:

  1. Prüfen Sie, ob enterprise.js asynchron geladen wird. Weitere Informationen finden Sie unter reCAPTCHA asynchron laden.

  2. Fügen Sie dem <head>-Tag der Seiten, die enterprise.js laden, folgende Ressourcenhinweise hinzu:

    • <link rel="preconnect" href="https://www.google.com">
    • <link rel="preconnect" href="https://www.gstatic.com" crossorigin>

Backendaufrufe migrieren

Wenn Sie reCAPTCHA-Funktionen verwenden möchten, müssen Sie Ihre Backendaufrufe zu den neuen Endpunkten migrieren und die Authentifizierung einrichten:

  1. Ersetzen Sie Back-End-Aufrufe von https://www.google.com/recaptcha/api/siteverify durch entsprechende Aufrufe von recaptchaenterprise.googleapis.com. Die vollständige URL und das POST-Datenformat finden Sie unter Bewertung für Ihre Website erstellen.

  2. Richten Sie die Authentifizierung für reCAPTCHA ein.

    Die Authentifizierungsmethode, die Sie auswählen, hängt von der Umgebung ab, in der reCAPTCHA eingerichtet ist. In der folgenden Tabelle finden Sie Informationen zur Auswahl der geeigneten Authentifizierungsmethode und der unterstützten Benutzeroberfläche für die Authentifizierung:

    Umgebung Schnittstelle Authentifizierungsmethode
    Google Cloud
    • REST
    • Clientbibliotheken
    		 Verwenden Sie angehängte Dienstkonten.
    Lokal oder bei einem anderen Cloud-Anbieter REST Verwenden Sie API-Schlüssel oder die Workload Identity-Föderation.

    Wenn Sie API-Schlüssel verwenden möchten, empfehlen wir, sie durch Einschränkungen für API-Schlüssel zu sichern.
    Clientbibliotheken

    Verwenden Sie:

Nächste Schritte