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

Um die Webseiten mit reCAPTCHA-Skripts und aufrufen, gehen Sie so vor:

  1. Prüfen Sie, ob auf Ihren Webseiten das folgende Skript 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: Folgendes:

  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>

Back-End-Aufrufe 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. Für die vollständige URL und POST-Datenformat (siehe Bewertung für Ihre Website erstellen).

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

    Welche Authentifizierungsmethode Sie auswählen, hängt von der Umgebung ab, in der reCAPTCHA ist eingerichtet. 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 ein anderer Cloud-Anbieter REST Verwenden Sie API-Schlüssel oder die Workload Identity-Föderation.

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

    Verwenden Sie:

Nächste Schritte