reCAPTCHA Enterprise-Features 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

Zu reCAPTCHA Enterprise migrieren

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. 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 Enterprise:

  1. Prüfen Sie, ob Sie enterprise.js asynchron laden. Weitere Informationen finden Sie unter Asynchron 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>

Back-End-Aufrufe migrieren

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

  1. Ersetzen Sie Back-End-Aufrufe von https://www.google.com/recaptcha/api/siteverify durch https://recaptchaenterprise.googleapis.com.

  2. Wählen Sie den Endpunkt und die Authentifizierungsmethode aus, mit denen Sie Bewertungen erstellen möchten:

    Endpunkt Authentifizierungsmethode Hinweise
    v1beta1 API-Schlüssel

    Dies ist die schnellste Methode für die Migration des Back-End-Aufrufs.

    v1 Dienstkonto Dies ist die bevorzugte Methode. Allerdings kann die Migration von Back-End-Aufrufen länger dauern, da Sie zur Authentifizierung das Cloud SDK oder die Clientbibliotheken verwenden müssen.
  3. Erstellen Sie je nach ausgewähltem Endpunkt einen API-Schlüssel oder ein Dienstkonto.

Nächste Schritte