reCAPTCHA-Schlüssel für Websites erstellen

Auf dieser Seite wird erläutert, wie Sie reCAPTCHA-Schlüssel (auch Schlüssel genannt) erstellen, um Nutzerinteraktionen auf Ihren Webseiten zu überprüfen.

reCAPTCHA-Schlüssel stellen dar, wie reCAPTCHA Enterprise für eine Website konfiguriert wird. Die Konfiguration enthält wichtige Optionen, z. B. ob CAPTCHA-Herausforderungen angezeigt werden sollen.

Hinweise

• Bereiten Sie Ihre Umgebung für reCAPTCHA Enterprise vor.
• Sie benötigen die folgende Rolle für Identity and Access Management: reCAPTCHA Enterprise-Administrator (roles/recaptchaenterprise.admin).
• Wählen Sie den Schlüsseltyp aus, der sich für Ihren Anwendungsfall am besten eignet.

reCAPTCHA-Schlüssel erstellen

Die Anzahl der reCAPTCHA-Schlüssel, die Sie für ein Google Cloud-Projekt erstellen können, ist nicht begrenzt. Es empfiehlt sich, einen reCAPTCHA-Schlüssel pro Website zu erstellen.

Wir empfehlen, für Staging- und Produktionsumgebungen separate reCAPTCHA-Schlüssel zu erstellen. Andernfalls riskieren Sie, die reCAPTCHA-Risikoanalyse mit Daten aus Ihrer Testumgebung zu verschmutzen.

Am einfachsten erstellen Sie einen reCAPTCHA-Schlüssel über die Google Cloud Console. Alternativ können Sie die reCAPTCHA Enterprise API oder die Google Cloud CLI verwenden.

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

3. Klicken Sie auf Schlüssel erstellen.

   
4. Geben Sie im Feld Anzeigename einen Anzeigenamen für den Schlüssel ein.

5. Wählen Sie im Menü Plattformtyp auswählen die Option Website aus.

   

   Der Abschnitt Domainliste wird angezeigt.

6. Geben Sie den Domainnamen für Ihre Website ein:

   1. Klicken Sie im Abschnitt Domainliste auf Domain hinzufügen.

      
   2. Geben Sie im Feld Domain den Namen Ihrer Domain ein.

   3. Optional: Klicken Sie zum Hinzufügen einer zusätzlichen Domain auf Domain hinzufügen und geben Sie den Namen einer anderen Domain in das Feld Domain ein. Sie können bis zu 250 Domains hinzufügen.

      Bei Websites gilt der reCAPTCHA-Schlüssel nur für die von Ihnen angegebenen Domains und Subdomains. Sie können mehrere Domains angeben, wenn Sie Ihre Website von mehreren Domains bereitstellen. Wenn Sie eine Domain angeben (z. B. examplepetstore.com), müssen Sie ihre Subdomains nicht angeben (z. B. subdomain.examplepetstore.com).

7. Führen Sie je nach reCAPTCHA-Schlüsseltyp, den Sie für Ihre Website erstellen möchten, die entsprechende Aktion aus:

Punktzahlbasierte reCAPTCHA-Schlüssel erstellen

Hinweis: Das Erstellen eines wertbasierten Schlüssels ist die Standardoption in der Google Cloud Console.

1. Optional: Wenn Sie die Domainbestätigung deaktivieren oder AMP-Seiten zulassen möchten, maximieren Sie den Abschnitt Web Application Firewall (WAF), Domainbestätigung, AMP-Seiten und Herausforderung.
   
   1. Achten Sie darauf, dass die Ein-/Aus-Schaltfläche Domainbestätigung deaktivieren deaktiviert ist, um den reCAPTCHA-Schlüssel für Ihre Domain und Subdomains zu schützen.

      Die Deaktivierung der Domainbestätigung stellt ein Sicherheitsrisiko dar, da für die Website keine Einschränkungen gelten. Ihr reCAPTCHA-Schlüssel kann also von allen Personen abgerufen und verwendet werden.

      
   2. Wenn der auf Punktzahlen basierende Schlüssel für Accelerated Mobile Pages (AMP) verwendet werden soll, aktivieren Sie die Ein-/Aus-Schaltfläche Diesen Schlüssel für AMP-Seiten zulassen.

   3. Wenn Sie für Ihre Nicht-Produktionsumgebung eine Punktzahl angeben möchten, die der Schlüssel zurückgeben soll, wenn Bewertungen dafür erstellt werden, gehen Sie so vor:

      1. Klicken Sie auf die Ein-/Aus-Schaltfläche Dies ist ein Testschlüssel.
      2. Geben Sie im Feld Punktzahl einen Wert zwischen 0 und 1, 0 ein.
      
   4. Klicken Sie auf Schlüssel erstellen.

   Der neu erstellte Schlüssel wird auf der Seite reCAPTCHA-Schlüssel aufgeführt.

reCAPTCHA-Schlüssel für Kästchen erstellen

Wir raten davon ab, Kästchenschlüssel zu verwenden, da sie für den Nutzer einen reibungslosen Ablauf ermöglichen und die Genauigkeit nicht wesentlich verbessern.

1. Maximieren Sie den Abschnitt Web Application Firewall (WAF), Domainbestätigung, AMP-Seiten und Herausforderung.
   
2. Achten Sie darauf, dass die Ein-/Aus-Schaltfläche Domainbestätigung deaktivieren deaktiviert ist, um den reCAPTCHA-Schlüssel für Ihre Domain und Subdomains zu schützen.

   Die Deaktivierung der Domainbestätigung stellt ein Sicherheitsrisiko dar, da für die Website keine Einschränkungen gelten. Ihr reCAPTCHA-Schlüssel kann also von allen Personen abgerufen und verwendet werden.

   
3. Aktivieren Sie die Option Herausforderung durch Kästchen verwenden.
   
4. Wählen Sie die entsprechende Option für die Bestätigungssicherheit aus.

   Die Sicherheitsoption für die Identitätsbestätigung steuert die Wahrscheinlichkeit, mit der ein Nutzer zur Eingabe einer sekundären Identitätsbestätigung aufgefordert wird. Dabei werden Nutzer aufgefordert, Bilder basierend auf einer identifizierten Kategorie auszuwählen, z. B. die Bilder mit einem Motorrad oder Straßenspiegel.

   

   Wenn Sie bestmöglichen Schutz vor Betrug wünschen, wählen Sie Härterer Schwierigkeitsgrad (höher vor Bots) aus.

   Wenn du Einfachster Schwierigkeitsgrad auswählst, ist die Wahrscheinlichkeit geringer, dass die Nutzer zur visuellen Aufgabe aufgefordert werden.

5. Wenn Sie für Ihre Nicht-Produktionsumgebung eine Punktzahl angeben möchten, die der Schlüssel zurückgeben soll, wenn Bewertungen dafür erstellt werden, gehen Sie so vor:

   1. Klicken Sie auf die Ein-/Aus-Schaltfläche Dies ist ein Testschlüssel.
   2. Geben Sie im Feld Punktzahl einen Wert zwischen 0 und 1, 0 ein.
   3. Wähle die entsprechende Option unter Art der Herausforderung aus.
      • Automatisch wird manchmal eingeblendet.
      • Kein CAPTCHA zeigt keine Herausforderung an.
      • Unter Nicht lösbarer Herausforderung werden die Bilder angezeigt, aber die Herausforderung wurde nicht bestanden.
      
   4. Klicken Sie auf Schlüssel erstellen.

   Der neu erstellte Schlüssel wird auf der Seite reCAPTCHA-Schlüssel aufgeführt.

gcloud

Verwenden Sie den Befehl gcloud retrotcha keys create, um reCAPTCHA-Schlüssel zu erstellen.

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

• DISPLAY_NAME: Name des Schlüssels. In der Regel ein Websitename.
• INTEGRATION_TYPE: Integrationstyp. Geben Sie je nach Schlüsseltyp die folgenden Werte an:
  • score für wertbasierte Schlüssel.
  • checkbox für Kästchenschlüssel.
  Hinweis:Wir raten von der Verwendung von CHECKBOX ab, da dies die Nutzerfreundlichkeit erhöht und die Genauigkeit nicht wesentlich verbessert. Weitere Informationen finden Sie in den FAQs.
• DOMAIN_NAME: Domains oder Subdomains von Websites, die den Schlüssel verwenden dürfen.

  Geben Sie mehrere Domains als durch Kommas getrennte Liste an.

  Die Deaktivierung der Domainbestätigung stellt ein Sicherheitsrisiko dar, da für die Website keine Einschränkungen gelten. Ihr reCAPTCHA-Schlüssel kann also von allen Personen abgerufen und verwendet werden.

  Hinweis: Der reCAPTCHA-Schlüssel gilt nur für die von Ihnen angegebenen Domains und Subdomains. Du kannst mehr als eine Domain angeben, wenn du deine Website über mehrere Domains bereitstellst. Wenn Sie eine Domain angeben (z. B. examplepetstore.com), müssen Sie die zugehörigen Subdomains (z. B. subdomain.examplepetstore.com) nicht angeben.

Führen Sie den Befehl gcloud retrotcha keys create aus:

Linux, macOS oder Cloud Shell

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME

Windows (PowerShell)

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME

Windows (cmd.exe)

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME

Die Antwort enthält den neu erstellten reCAPTCHA-Schlüssel.

REST

API-Referenzinformationen zu Schlüsseltypen und Integrationstypen finden Sie unter Schlüssel und Integrationstyp.

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

• DISPLAY_NAME: Name des Schlüssels. In der Regel ein Websitename.
• INTEGRATION_TYPE: Integrationstyp. Geben Sie je nach Schlüsseltyp die folgenden Werte an:
  • score für wertbasierte Schlüssel.
  • checkbox für Kästchenschlüssel.
  Hinweis:Wir raten von der Verwendung von CHECKBOX ab, da dies die Nutzerfreundlichkeit erhöht und die Genauigkeit nicht wesentlich verbessert. Weitere Informationen finden Sie in den FAQs.
• DOMAIN_NAME: Domains oder Subdomains von Websites, die den Schlüssel verwenden dürfen.

  Geben Sie mehrere Domains als durch Kommas getrennte Liste an.

  Die Deaktivierung der Domainbestätigung stellt ein Sicherheitsrisiko dar, da für die Website keine Einschränkungen gelten. Ihr reCAPTCHA-Schlüssel kann also von allen Personen abgerufen und verwendet werden.

  Hinweis: Der reCAPTCHA-Schlüssel gilt nur für die von Ihnen angegebenen Domains und Subdomains. Du kannst mehr als eine Domain angeben, wenn du deine Website über mehrere Domains bereitstellst. Wenn Sie eine Domain angeben (z. B. examplepetstore.com), müssen Sie die zugehörigen Subdomains (z. B. subdomain.examplepetstore.com) nicht angeben.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "TYPE_OF_INTEGRATION"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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

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.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

Hinweis: Nachdem Sie reCAPTCHA-Schlüssel erstellt haben, können Sie sie bearbeiten oder löschen. Gelöschte Schlüssel können nicht wiederhergestellt werden.

(Optional) Legacy-reCAPTCHA-Secret-Schlüssel suchen

Wenn Sie eine Drittanbieteranwendung einbinden möchten, die die Nicht-Enterprise-Version von reCAPTCHA verwendet, benötigen Sie den geheimen Legacy-Schlüssel.

Für jeden Websiteschlüssel, den Sie erstellen, erstellt reCAPTCHA Enterprise einen alten reCAPTCHA-Secret-Schlüssel, den Sie mit Ihrer Drittanbieteranwendung verwenden können.

So finden Sie den geheimen Legacy-Schlüssel:

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

   Zur Seite „reCAPTCHA Enterprise“

2. Suchen Sie im Abschnitt Enterprise Keys (Unternehmensschlüssel) den von Ihnen erstellten reCAPTCHA-Schlüssel und klicken Sie auf den Schlüssel.

   

3. Klicken Sie auf der Seite Wichtige Details im Tab Integration auf Legacy-Schlüssel verwenden. Es wird ein Dialogfeld mit einer Anleitung zur Verwendung des geheimen Legacy-Schlüssels geöffnet.

   

Nächste Schritte

• Punktzahlbasierte Schlüssel auf Ihren Webseiten installieren
• Installieren Sie Kästchenschlüssel auf Ihren Webseiten.