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 Backend-Aufrufe migriert werden.

Hinweise

Zu reCAPTCHA Enterprise migrieren

Webseiten instrumentieren

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

  1. Prüfen Sie, ob das folgende Skript in Ihren Webseiten enthalten 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. enterprise.js muss asynchron geladen werden. 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>

Back-End-Aufrufe migrieren

Wenn Sie reCAPTCHA Enterprise-Features 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 durch https://www.google.com/recaptcha/api/siteverify durch entsprechende recaptchaenterprise.googleapis.com-Aufrufe. Die vollständige URL und das POST-Datenformat finden Sie unter Bewertung für Ihre Website erstellen.

  2. Richten Sie die Authentifizierung bei reCAPTCHA Enterprise ein.

    Welche Authentifizierungsmethode Sie auswählen, hängt von der Umgebung ab, in der reCAPTCHA Enterprise eingerichtet ist. Die folgende Tabelle hilft Ihnen bei der Auswahl der geeigneten Authentifizierungsmethode und der unterstützten Schnittstelle zum Einrichten der Authentifizierung:

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

    Wenn Sie API-Schlüssel verwenden möchten, sollten Sie Einschränkungen für API-Schlüssel festlegen.
    Clientbibliotheken

    Verwenden Sie:

Nächste Schritte