reCAPTCHA Enterprise-Funktionen nach der Migration verwenden

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

Hinweis

Migration zu reCAPTCHA Enterprise

Webseiten instrumentieren

So instrumentieren Sie die Webseiten mit den reCAPTCHA Enterprise-Skripts und -Aufrufen:

  1. Prüfen Sie, ob folgendes Skript auf Ihren Webseiten vorhanden ist: https://www.google.com/recaptcha/api.js.
  2. Ersetze https://www.google.com/recaptcha/api.js auf deinen Webseiten 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 Enterprise:

  1. Prüfe, ob du enterprise.js asynchron lädst. Weitere Informationen finden Sie unter Asynchrones Laden von reCAPTCHA.

  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>

Back-End-Aufrufe migrieren

Damit Sie reCAPTCHA Enterprise-Features verwenden können, müssen Sie Ihre Back-End-Aufrufe an die neuen Endpunkte migrieren und die Authentifizierung einrichten:

  1. Ersetze in deinen Back-End-Aufrufen https://www.google.com/recaptcha/api/siteverify durch https://recaptchaenterprise.googleapis.com.

  2. Wählen Sie die Authentifizierungsmethode aus, mit der Sie Bewertungen erstellen möchten:

    Authentifizierungsmethode Hinweise
    API-Schlüssel

    Dies ist die schnellste Methode, um den Back-End-Aufruf zu migrieren.

    Dienstkonto Diese Methode wird bevorzugt, allerdings kann die Migration von Back-End-Aufrufen länger dauern, da Sie entweder die Google Cloud-Befehlszeile oder Clientbibliotheken für die Authentifizierung verwenden müssen.
  3. Erstellen Sie je nach Authentifizierungsmethode einen API-Schlüssel oder erstellen und konfigurieren Sie ein Dienstkonto.

Weitere Informationen