Von reCAPTCHA migrieren (nicht Enterprise-Version)

In diesem Dokument erfahren Sie, wie Sie mit einem aktiven Websiteschlüssel von reCAPTCHA (nicht Unternehmensversion) zu reCAPTCHA Enterprise migrieren. Die Migration dauert 5 bis 10 Minuten und erfordert keine Codeänderungen.

Wenn Sie derzeit auf die reCAPTCHA-Admin-Konsole zugreifen, verwenden Sie die Drittanbieter-Enterpriseversion von reCAPTCHA, die eingeschränkte Funktionalität und strenge Beschränkungen für die monatliche Nutzung hat. Weitere Informationen zum Funktionsvergleich finden Sie unter Vergleich der Funktionen zwischen reCAPTCHA-Versionen.

Nach der Migration werden Sie Nutzer von reCAPTCHA Enterprise und Ihnen werden Kosten in Rechnung gestellt, wenn Sie 1.000.000 Anfragen pro Monat überschreiten. Weitere Informationen finden Sie unter Preise für reCAPTCHA Enterprise.

Hinweis: Android-Schlüssel von reCAPTCHA v2 können nicht migriert werden.

Hinweis: Der Migrationsprozess bietet keinen Zugriff auf zusätzliche reCAPTCHA Enterprise-Funktionen wie die Multi-Faktor-Authentifizierung (MFA) oder die Erkennung von Passwortlecks. Informationen zur Verwendung dieser zusätzlichen Features finden Sie unter reCAPTCHA Enterprise-Features nach der Migration verwenden.

Hinweis: Die Zugriffssteuerung des Google Cloud-Zielprojekts hindert Sie möglicherweise daran, nach der Migration auf den Schlüssel in der reCAPTCHA-Admin-Konsole zuzugreifen. In diesem Fall müssen Sie stattdessen die Google Cloud Console verwenden.

Hinweise

1. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Zur Projektauswahl

2. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

   Für reCAPTCHA Enterprise muss die Abrechnung für die Migration verknüpft und aktiviert sein. Sie können die Abrechnung entweder mithilfe einer Kreditkarte oder anhand einer vorhandenen Abrechnungs-ID im Google Cloud-Projekt aktivieren. Wenn Sie Hilfe bei der Abrechnung benötigen, wenden Sie sich an den Cloud Billing-Support.

3. Wenn Sie die gcloud CLI außerhalb der Google Cloud Console ausführen möchten, installieren und initialisieren Sie die gcloud CLI. Eine Anleitung finden Sie unter

   Installieren Sie die Google Cloud CLI und initialisieren Sie sie mit folgendem Befehl:

   gcloud init

reCAPTCHA Enterprise API aktivieren

Console

1. Rufen Sie in der Google Cloud Console die Seite reCAPTCHA Enterprise API auf.

   Zur reCAPTCHA Enterprise API

2. Prüfen Sie, ob der Name Ihres Projekts in der Projektauswahl oben auf der Seite angezeigt wird.

   Wenn Sie den Namen Ihres Projekts nicht sehen, klicken Sie auf die Projektauswahl und wählen Sie Ihr Projekt aus.

3. Klicken Sie auf Aktivieren.

gcloud

1. Aktivieren Sie Cloud Shell in der Google Cloud Console.

   Cloud Shell aktivieren

   Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

2. Führen Sie den Befehl gcloud config set project aus, um Ihr Google Cloud-Projekt in der gcloud-Sitzung festzulegen. Ersetzen Sie PROJECT_ID durch Ihre Google Cloud-Projekt-ID.

          gcloud config set project PROJECT_ID
          

3. Führen Sie den Befehl gcloud services enable aus, um die reCAPTCHA Enterprise API zu aktivieren:

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. Führen Sie den Befehl gcloud services list aus, um zu prüfen, ob die reCAPTCHA Enterprise API aktiviert ist:

            gcloud services list --enabled
          

   Prüfen Sie, ob die reCAPTCHA Enterprise API in der Liste der aktivierten APIs aufgeführt ist.

Zu reCAPTCHA Enterprise migrieren

Die Migration von einer Drittanbieter-Enterprise-Version von reCAPTCHA zu reCAPTCHA Enterprise umfasst das Auswählen eines aktiven Websiteschlüssels aus der reCAPTCHA-Admin-Konsole und das Migrieren des Websiteschlüssels. Sie können einen oder mehrere aktive Websiteschlüssel migrieren. Sie können jedoch jeweils nur einen Websiteschlüssel migrieren.

Zum Ausführen des Migrationsprozesses benötigen Sie ein reCAPTCHA-Nutzerkonto, das die folgenden Anforderungen erfüllt:

• In der reCAPTCHA-Admin-Konsole wird das Nutzerkonto als Inhaber für den zu migrierenden Websiteschlüssel aufgeführt.
• Das Nutzerkonto hat eine der folgenden IAM-Rollen für das Google Cloud-Projekt, für das die reCAPTCHA Enterprise API aktiviert ist:
  • Projektinhaber (roles/owner)
  • Projektbearbeiter (roles/editor)
  • reCAPTCHA Enterprise-Administrator (roles/recaptchaenterprise.admin)
  Wenn Ihr Nutzerkonto keine dieser Rollen hat, bitten Sie Ihren Administrator, die Rolle zu gewähren, oder folgen Sie der Anleitung inZugriff gewähren, ändern und aufheben.

1. Migrieren Sie den Websiteschlüssel mithilfe der Google Cloud Console, Cloud Shell, der Google Cloud CLI oder der reCAPTCHA Enterprise API:

   Google Cloud Console

   1. Rufen Sie in der Google Cloud Console die Seite reCAPTCHA Enterprise auf.

      Zur Seite „reCAPTCHA Enterprise“

   2. Prüfen Sie, ob der Name Ihres Projekts in der Ressourcenauswahl oben auf der Seite angezeigt wird. Wenn Sie den Namen Ihres Projekts nicht sehen, klicken Sie auf die Ressourcenauswahl und wählen Sie dann Ihr Projekt aus.

   3. Identifizieren Sie im Abschnitt Klassische Schlüssel den Schlüssel, den Sie migrieren möchten, und klicken Sie auf Upgradeschlüssel.

      

   4. Klicken Sie auf Bestätigen, um die Migration des ausgewählten Schlüssels abzuschließen.

   Cloud Shell

   1. Rufen Sie in der Google Cloud Console Cloud Shell auf.

      Zu Cloud Shell

   2. Wenn Sie dazu aufgefordert werden, klicken Sie auf Autorisieren.

   3. Wählen Sie einen aktiven Websiteschlüssel aus, den Sie zum Einbinden von reCAPTCHA in Ihre Webseiten verwendet haben, und kopieren Sie diesen:

      1. Rufen Sie die reCAPTCHA-Admin-Konsole auf und klicken Sie auf .

      2. Wählen Sie einen Websiteschlüssel aus. Die folgenden reCAPTCHA-Websiteschlüssel werden für die Migration unterstützt: reCAPTCHA V2 – Kästchen, reCAPTCHA V2 (Unsichtbar) und reCAPTCHA V3.

      3. Klicken Sie auf Websiteschlüssel kopieren, um den Websiteschlüssel zu kopieren.

   4. Migrieren Sie den Websiteschlüssel.

      Verwenden Sie den Befehl gcloud recaptcha keys migrate wie im folgenden Beispiel:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Geben Sie folgende Werte an:

      • SITE_KEY ist der aktive Websiteschlüssel, den Sie aus der reCAPTCHA-Admin-Konsole kopiert haben.
      • PROJECT-ID ist die ID des Google Cloud-Projekts, für das die reCAPTCHA Enterprise API aktiviert ist.

   gcloud-CLI

   1. Führen Sie den folgenden gcloud-Befehl aus, um die Authentifizierung zu konfigurieren:

      gcloud auth login
      

      Melden Sie sich mit dem reCAPTCHA-Nutzerkonto an, das den ausgewählten Websiteschlüssel besitzt und eine der folgenden Rollen hat: Projektinhaber, Projektbearbeiter oder reCAPTCHA Enterprise-Administrator.

   2. Wählen Sie einen aktiven Websiteschlüssel aus, den Sie zum Einbinden von reCAPTCHA in Ihre Webseiten verwendet haben, und kopieren Sie diesen:

      1. Rufen Sie die reCAPTCHA-Admin-Konsole auf und klicken Sie auf .

      2. Wählen Sie einen Websiteschlüssel aus. Die folgenden reCAPTCHA-Websiteschlüssel werden für die Migration unterstützt: reCAPTCHA V2 – Kästchen, reCAPTCHA V2 (Unsichtbar) und reCAPTCHA V3.

      3. Klicken Sie auf Websiteschlüssel kopieren, um den Websiteschlüssel zu kopieren.

   3. Migrieren Sie den Websiteschlüssel.

      Verwenden Sie den Befehl gcloud recaptcha keys migrate wie im folgenden Beispiel:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Geben Sie folgende Werte an:

      • SITE_KEY ist der aktive Websiteschlüssel, den Sie aus der reCAPTCHA-Admin-Konsole kopiert haben.
      • PROJECT-ID ist die ID des Google Cloud-Projekts, für das die reCAPTCHA Enterprise API aktiviert ist.

   REST API

   1. Wählen Sie einen aktiven Websiteschlüssel aus, den Sie zum Einbinden von reCAPTCHA in Ihre Webseiten verwendet haben, und kopieren Sie diesen:

      1. Rufen Sie die reCAPTCHA-Admin-Konsole auf und klicken Sie auf .

      2. Wählen Sie einen Websiteschlüssel aus. Die folgenden reCAPTCHA-Websiteschlüssel werden für die Migration unterstützt: reCAPTCHA V2 – Kästchen, reCAPTCHA V2 (Unsichtbar) und reCAPTCHA V3.

      3. Klicken Sie auf Websiteschlüssel kopieren, um den Websiteschlüssel zu kopieren.

   2. Migrieren Sie den Websiteschlüssel.

      Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

      • PROJECT_ID ist die ID des Google Cloud-Projekts, für das die reCAPTCHA Enterprise API aktiviert ist.
      • SITE_KEY ist der aktive Websiteschlüssel, den Sie aus der reCAPTCHA-Admin-Konsole kopiert haben.

      HTTP-Methode und URL:

      POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate

      Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

      curl

      Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

      Führen Sie folgenden Befehl aus:

      curl -X POST \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json; charset=utf-8" \
          -d "" \
          "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate"

      PowerShell

      Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch in der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

      Führen Sie folgenden Befehl aus:

      $cred = gcloud auth print-access-token
      $headers = @{ "Authorization" = "Bearer $cred" }
      
      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand Content

      Sie sollten in etwa folgende JSON-Antwort erhalten:

      {
        "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
        "displayName": "My site key",
        "webSettings": {
          "allowAllDomains": false,
          "allowedDomains": [
            recaptcha.net
          ],
          "allowAmpTraffic": false,
          "integrationType": "SCORE",
          "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
        }
      }
      

2. So prüfen Sie, ob der Websiteschlüssel migriert wurde:

   Google Cloud Console

   Rufen Sie die Seite reCAPTCHA Enterprise auf und suchen Sie im Abschnitt Enterprise-Schlüssel nach dem migrierten Websiteschlüssel.

   Zu reCAPTCHA Enterprise

   Cloud Shell

   Führen Sie den Befehl gcloud recaptcha keys list aus und suchen Sie in der Liste der Schlüssel nach dem migrierten Websiteschlüssel.

   gcloud-CLI

   Führen Sie den Befehl gcloud recaptcha keys list aus und suchen Sie in der Liste der Schlüssel nach dem migrierten Websiteschlüssel.

Nach der Migration zu reCAPTCHA Enterprise können Sie weiterhin die Methode siteverify verwenden, um das reCAPTCHA-Antworttoken eines Nutzers zu bewerten.

Hinweis: Sie sollten Websiteschlüssel nicht aus der reCAPTCHA-Admin-Konsole oder der reCAPTCHA Enterprise-Seite der Google Cloud Console löschen. Wenn Sie einen Websiteschlüssel löschen, wird er aus beiden Konsolen gelöscht und der Schutz von reCAPTCHA Enterprise entfällt.

Sie können die IAM-Rolle reCAPTCHA Enterprise Admin (roles/recaptchaenterprise.admin) für Ihr reCAPTCHA-Nutzerkonto widerrufen. Sie können entweder Ihren Administrator bitten, den Zugriff zu widerrufen, oder der Anleitung unter Zugriff gewähren, ändern und entziehen folgen.

Nächste Schritte

• Verwenden Sie reCAPTCHA Enterprise-Features nach der Migration.