Von reCAPTCHA Classic migrieren

In diesem Dokument erfahren Sie, wie Sie mit einem aktiven Websiteschlüssel von reCAPTCHA Classic zu reCAPTCHA migrieren. Der Migrationsprozess dauert fünf bis zehn Minuten und erfordert keine Codeänderungen.

Wenn Sie auf die reCAPTCHA-Admin-Konsole zugreifen, verwenden Sie reCAPTCHA Classic, das eingeschränkte Funktionen 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 und Ihnen werden Kosten in Rechnung gestellt, wenn Sie 10.000 Anfragen pro Monat überschreiten. Weitere Informationen finden Sie unter Preise für reCAPTCHA.

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

Hinweis: Im Migrationsprozess haben Sie keinen Zugriff auf die zusätzlichen reCAPTCHA-Features wie die Multi-Faktor-Authentifizierung (MFA) oder Passwortleck-Erkennung. Informationen zur Verwendung dieser zusätzlichen Funktionen finden Sie unter reCAPTCHA-Funktionen nach der Migration verwenden.

Hinweis: Zugriffssteuerungen für das Google Cloud-Zielprojekt verhindern möglicherweise den Zugriff auf den Schlüssel in der reCAPTCHA-Admin-Konsole nach der Migration. In diesem Fall müssen Sie stattdessen die Google Cloud Console verwenden.

Hinweise

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

2. Make sure that billing is enabled for your Google Cloud project.

   Für reCAPTCHA muss die Abrechnung für das Projekt verknüpft und aktiviert sein, damit die Migration durchgeführt werden kann. 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. Wie das geht, erfahren Sie unter

   Install the Google Cloud CLI, then initialize it by running the following command:

   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. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

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 migrieren

Wenn Sie von reCAPTCHA Classic zu reCAPTCHA migrieren möchten, wählen Sie einen aktiven Websiteschlüssel aus der reCAPTCHA-Admin-Konsole aus und migrieren Sie den Websiteschlüssel. 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-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.

   Die Migration des Websiteschlüssels hat keine Auswirkungen auf den Schlüssel oder die API-Endpunkte. Der Schlüssel wird der Enterprise-Lizenz hinzugefügt.

   Google Cloud Console

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

      Zu reCAPTCHA

   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 Ihr Projekt aus.

   3. Wählen Sie im Bereich Klassische Schlüssel den Schlüssel aus, den Sie migrieren möchten, und klicken Sie auf Schlüssel aktualisieren.

      

   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. Für die Migration werden die folgenden reCAPTCHA-Websiteschlüssel 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.

      Ersetzen Sie diese Werte in den folgenden Anfragedaten:

      • PROJECT_ID ist die ID des Google Cloud-Projekts, für das die reCAPTCHA 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 bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei 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 bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. 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 eine JSON-Antwort ähnlich wie diese 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 auf und suchen Sie nach dem migrierten Websiteschlüssel im Abschnitt reCAPTCHA-Schlüssel.

   Zu reCAPTCHA

   Cloud Shell

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

   gcloud-CLI

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

Nach der Migration zu reCAPTCHA 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-Seite der Google Cloud Console löschen. Wenn Sie einen Websiteschlüssel löschen, wird er aus beiden Konsolen gelöscht und der von reCAPTCHA angebotene Schutz wird entfernt.

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-Funktionen nach der Migration.