Von reCAPTCHA Classic migrieren

In diesem Dokument wird beschrieben, wie Sie einen aktiven Websiteschlüssel aus reCAPTCHA Classic in reCAPTCHA-Versionen in einemGoogle Cloud -Projekt migrieren. Sie können den Websiteschlüssel entweder über die reCAPTCHA-Admin-Konsole (empfohlen) oder über die Google Cloud -Konsole migrieren. Der Migrationsprozess dauert fünf bis zehn Minuten und erfordert keine Codeänderungen.

Wenn Sie Ihre Schlüssel in der reCAPTCHA-Admin-Konsole verwalten, verwenden Sie reCAPTCHA Classic, das eingeschränkte Funktionen und strenge Beschränkungen für die monatliche Nutzung hat. Die neuesten reCAPTCHA-Funktionen sind nur für Websiteschlüssel verfügbar, die in einem Google Cloud -Projekt verwaltet werden. Weitere Informationen zu den verfügbaren Funktionen finden Sie unter reCAPTCHA-Stufen vergleichen.

Nach Abschluss der Migration ergeben sich folgende Änderungen:

• Ihre Websiteschlüssel sind in einem Google Cloud -Projekt ohne Änderungen verfügbar.
• Ihre vorhandene reCAPTCHA-Integration funktioniert weiterhin, ohne dass Codeänderungen erforderlich sind. Sie können dieselbe Instrumentation für Webseiten und dieselben Backend-Aufrufe beibehalten. Wenn Sie jedoch auf Funktionen wie „Kontoschutz“ oder „Passwortschutz“ zugreifen möchten, müssen Sie die Instrumentierung Ihrer Webseite und die Backend-Aufrufe ändern. Weitere Informationen finden Sie unter reCAPTCHA-Funktionen nach der Migration verwenden.
• Ihnen werden Kosten in Rechnung gestellt, wenn Sie das kostenlose monatliche Kontingent von reCAPTCHA überschreiten,das 10.000 Bewertungen pro Monat beträgt. Weitere Informationen finden Sie unter Abrechnungsinformationen.

Über die reCAPTCHA-Admin-Konsole migrieren

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

   Zur reCAPTCHA-Admin-Konsole

2. Wählen Sie das Projekt aus, in das Sie die Schlüssel migrieren möchten.

3. Wählen Sie die Schlüssel aus, die migriert werden sollen.

4. Klicken Sie auf Senden.

Die Google Cloud Console wird mit Ihrem Projekt und den migrierten Schlüsseln geöffnet.

Mit der Google Cloud Console migrieren

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 die Migration von reCAPTCHA muss die Abrechnung mit dem Projekt verknüpft und für das Projekt 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 -Konsole ausführen möchten, installieren und initialisieren Sie die gcloud CLI. Eine Anleitung dazu finden Sie unter

   After installing the Google Cloud CLI, initialize it by running the following command:

   gcloud init

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

reCAPTCHA Enterprise API aktivieren

Alle reCAPTCHA-Stufen (Essentials, Standard und Enterprise) basieren auf der reCAPTCHA Enterprise API.

Zu reCAPTCHA migrieren

Wenn Sie 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 unter Zugriff gewähren, ändern und aufheben.

1. Migrieren Sie den Websiteschlüssel über die Google Cloud -Konsole, die Google Cloud CLI oder die reCAPTCHA Enterprise API.

   Die Migration des Website-Schlüssels hat keine Auswirkungen auf den Schlüssel oder die API-Endpunkte. Der Schlüssel wird lediglich der Unternehmenslizenz 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. Suchen Sie im Abschnitt Klassische Schlüssel nach dem Schlüssel, den Sie migrieren möchten, und klicken Sie auf Schlüssel upgraden.

      

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

   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 settings .

      2. Wählen Sie einen Website-Schlüssel aus. Die folgenden reCAPTCHA-Websiteschlüssel werden für die Migration unterstützt: reCAPTCHA v2 Checkbox, reCAPTCHA v2 Invisible und reCAPTCHA v3.

      3. Klicken Sie auf Websiteschlüssel kopieren, um den Schlü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: 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 settings .

      2. Wählen Sie einen Website-Schlüssel aus. Die folgenden reCAPTCHA-Websiteschlüssel werden für die Migration unterstützt: reCAPTCHA v2 Checkbox, reCAPTCHA v2 Invisible und reCAPTCHA v3.

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

   2. Migrieren Sie den Websiteschlüssel.

      Ersetzen Sie diese Werte in den folgenden Anfragedaten:

      • PROJECT_ID: 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

      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

      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 im Bereich reCAPTCHA-Schlüssel nach dem migrierten Websiteschlüssel.

   Zu reCAPTCHA

   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 können Sie weiterhin die Methode siteverify verwenden, um das reCAPTCHA-Antworttoken eines Nutzers zu bewerten. Informationen zur Antwort finden Sie unter Antwort von siteverify method.

Nachdem ein Websiteschlüssel zu reCAPTCHA migriert wurde, wird seine Verwendung innerhalb von einer Stunde in der Google Cloud -Konsole aufgezeichnet, einschließlich der Dashboards für Nutzung und Punktzahl. Die Nutzung vor der Migration wird in der Google Cloud Console in der Regel nicht angezeigt.

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

• reCAPTCHA-Funktionen nach der Migration verwenden