Terminologie der Admin Console und der Google Cloud Console abstimmen

In diesem Dokument wird beschrieben, wie Sie Ihre reCAPTCHA-Schlüsselversion (v2 oder v3) ermitteln, die Terminologie der alten reCAPTCHA-Admin-Konsole derGoogle Cloud Console zuordnen und die Websiteschlüssel und geheimen Schlüssel abrufen, die für Content-Management-Systeme (CMS) und Drittanbieter-Plug-ins wie WordPress- oder Shopify-Integrationen erforderlich sind.

Legacy-Terminologie der Google Cloud Console zuordnen

Wenn Sie Ihre Schlüssel nur in der reCAPTCHA-Admin-Konsole verwalten, verwenden Sie reCAPTCHA Classic. Wenn Sie Ihre Schlüssel in der Google Cloud Console auf der Seite Google Cloud Fraud Defense verwalten, verwenden Sie Fraud Defense. Beide Konsolen unterstützen v2- und v3-Websiteschlüssel.

Viele CMS-Plattformen und ‑Plug-ins verweisen auf reCAPTCHA-Schlüssel mit Legacy-Versionsnummern wie v2 Checkbox, v2 Invisible und v3. In derGoogle Cloud Console werden plattformbasierte Deskriptoren anstelle von Versionsnummern verwendet.

In der folgenden Tabelle wird die Terminologie des alten CMS und der Admin-Konsole der Terminologie derGoogle Cloud Console zugeordnet:

CMS- oder Admin-Konsolen-Terminologie Google Cloud -Konsole (Plattformdetails) Schlüssel bearbeiten (Feld Typ) Bestätigungsmechanismus und CMS-Kompatibilität
Punktebasiert (v3) Website • score Website • Score Reibungslose, punktebasierte Bestätigung. Verwenden Sie diesen Schlüsseltyp für CMS-Plug-ins, die reCAPTCHA V3 erfordern.
Aufgabe (v2) Website • checkbox Website • Checkbox challenge Der Nutzer muss das Kästchen „Ich bin kein Roboter“ anklicken. Verwendung für CMS-Plug-ins, die das reCAPTCHA V2-Kästchen erfordern.
Unsichtbar (v2) Website • invisible Website • Invisible integration Analysiert das Risiko im Hintergrund und zeigt möglicherweise eine Aufforderung an. Verwendung für CMS-Plug-ins, die reCAPTCHA V2 Invisible erfordern.
– Website • policy-based challenge Website • Policy-based challenge Löst Aufgaben anhand eines konfigurierten Schwellenwerts für den Wert aus. Erfordert eine benutzerdefinierte CreateAssessment-Integration.
– iOS iOS app Mobiler iOS-Schlüssel ohne Challenge.
– Android Android app Android-Mobilgeräteschlüssel ohne Challenge.

Schlüsselversion in der Google Cloud Console ansehen

So rufen Sie die Version Ihres Schlüssels in der Google Cloud Console auf:

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

    Zu Fraud Defense

  2. Wählen Sie den Tab Keys aus.

  3. Wenn Ihre Schlüssel in der Kartenansicht angezeigt werden, wechseln Sie zur Tabellenansicht.

  4. Suchen Sie in der Spalte Plattformdetails nach Ihrem Schlüssel. Website • score entspricht beispielsweise v3 und Website • checkbox entspricht v2 Checkbox.

  5. Optional. Klicken Sie in der Ansicht Karten auf einer Schlüsselkarte auf Schlüsseldetails und wählen Sie dann Schlüssel bearbeiten aus. Im Feld Typ wird die Schlüsselkonfiguration angezeigt, z. B. Website • Score für v3 oder Website • Checkbox challenge für v2 Checkbox.

Websiteschlüssel und geheimen Schlüssel finden

Für die Integration von reCAPTCHA in Plug-ins von Drittanbietern und CMS-Plattformen sind häufig ein Websiteschlüssel und ein geheimer Schlüssel erforderlich:

  • Websiteschlüssel: In der Google Cloud Console entspricht die Schlüssel-ID dem Websiteschlüssel.
  • Geheimer Schlüssel: In der Google Cloud Console wird der geheime Schlüssel standardmäßig nicht angezeigt, da für die Authentifizierung in Google Cloud normalerweise API-Schlüssel oder Identity and Access Management-Rollen verwendet werden. Sie können jedoch den alten geheimen Schlüssel für Plug-ins abrufen, die ihn benötigen. In einigen Bibliotheken oder Dokumentationen von Drittanbietern wird der Legacy-Secret-Key möglicherweise als privater Schlüssel bezeichnet.

Geheimen Schlüssel in der Google Cloud Console abrufen

So rufen Sie den Websiteschlüssel und den geheimen Schlüssel ab:

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

    Zu Fraud Defense

  2. Wählen Sie den Tab Keys aus.

  3. Gehen Sie im Abschnitt reCAPTCHA-Schlüssel zu dem Schlüssel, für den Sie den geheimen Schlüssel benötigen:

    • Wenn Sie sich in der Ansicht Karten befinden, klicken Sie auf der Schlüsselkarte auf Schlüsseldetails. Die Schlüssel-ID wird oben auf der Seite angezeigt.
    • In der Tabellenansicht wird die Schlüssel-ID in der Tabelle angezeigt. Klicken Sie auf den Schlüssel, um die zugehörige Detailseite aufzurufen.

  4. Kopieren Sie die Schlüssel-ID, die oben auf der Seite angezeigt wird. Dieser Wert ist Ihr Websiteschlüssel.

  5. Rufen Sie den Tab Integration auf.

  6. Führen Sie je nach Status des Schlüssels einen der folgenden Schritte aus:

    • Wenn der Schlüssel für die Legacy-Verwendung konfiguriert ist, klicken Sie auf Legacy-Schlüssel verwenden.
    • Wenn der Schlüssel nicht in einen Legacy-Dienst eingebunden ist, klicken Sie auf Drittanbieterdienst oder Plug‑in einbinden.

  7. Ein Dialogfeld mit Ihrem geheimen Schlüssel wird angezeigt. Kopieren Sie diesen Wert und bewahren Sie ihn an einem sicheren Ort auf. Behandeln Sie dieses Secret als sensible Daten.

    Alternativ können Sie auf der Seite Schlüsseldetails auf Schlüssel bearbeiten und dann neben dem Feld Geheimer Schlüssel auf Anzeigen klicken.

In WordPress, Shopify oder andere CMS-Plattformen einbinden

Wenn Sie einen Website-Builder, eine E-Commerce-Plattform oder ein CMS-Plug-in verwenden, lädt die Plattform oder das Plug-in das reCAPTCHA-Script und verifiziert Nutzer-Tokens automatisch. Sie müssen keine reCAPTCHA-Clientbibliotheken installieren oder benutzerdefinierten Backend-Code schreiben.

So konfigurieren Sie reCAPTCHA in einem CMS oder Drittanbieter-Plug-in:

  1. Prüfen Sie, welche reCAPTCHA-Version für Ihr CMS oder Plug-in erforderlich ist: Öffnen Sie die reCAPTCHA-Integrationseinstellungen in Ihrem CMS oder Plug-in und prüfen Sie, welcher Schlüsseltyp unterstützt wird (normalerweise reCAPTCHA V3 oder reCAPTCHA V2-Kästchen).

  2. Wählen Sie einen Abgleichsschlüssel aus oder erstellen Sie einen:

    • Wenn Sie bereits einen Schlüssel haben, sehen Sie sich die Schlüsselversion an, um zu prüfen, ob sie mit der in Ihrem Plug-in ausgewählten Version übereinstimmt (Website • score für v3 oder Website • checkbox für v2 Checkbox).
    • Wenn Sie einen neuen Schlüssel benötigen, erstellen Sie einen Schlüssel für Ihre Website, der der erforderlichen Version entspricht, und fügen Sie die Domain Ihrer Website (z. B. example.com) zur Domainliste des Schlüssels hinzu.

  3. Websiteschlüssel und alten geheimen Schlüssel kopieren: Folgen Sie der Anleitung unter Geheimen Schlüssel in derGoogle Cloud Console abrufen, um die Schlüssel-ID (Websiteschlüssel) und den geheimen Schlüssel abzurufen.

  4. Geben Sie die Schlüssel in den Einstellungen Ihres CMS oder Plug-ins ein:

    • Fügen Sie die Schlüssel-ID in das Feld Websiteschlüssel ein.
    • Fügen Sie den geheimen Schlüssel in das Feld Geheimer Schlüssel (oder Privater Schlüssel) ein und speichern Sie die Einstellungen.

Benutzerdefinierte Websites mithilfe von Bewertungen einbinden

Die Methode CreateAssessment bietet detaillierte Risikoanalysen und Ursachencodes und ermöglicht den Zugriff auf erweiterte Fraud Defense-Funktionen. Sie können die Methode CreateAssessment mit den reCAPTCHA-Clientbibliotheken oder der REST API aufrufen.

Weitere Informationen finden Sie unter Bewertung für Ihre Website erstellen.

Legacy-SiteVerify-Methode

Wir empfehlen die Methode CreateAssessment für neue und benutzerdefinierte Integrationen. Einige vorhandene Systeme oder Drittanbieter-Plug-ins sind jedoch weiterhin auf die Legacy-Methode SiteVerify angewiesen. Für diese Methode ist ein geheimer Schlüssel erforderlich, der mit Ihrem reCAPTCHA-Schlüssel verknüpft ist.

Wenn Sie eine Integration in ein System benötigen, für das die Legacy-API SiteVerify erforderlich ist, lesen Sie den Hilfeartikel Nutzerantwort-Tokens mit Legacy-SiteVerify verifizieren.

Nächste Schritte