reCAPTCHA-Schlüssel für mobile Anwendungen erstellen

Mit mobilen Schlüsseln in reCAPTCHA können Sie die Anwendungsidentität und Risikoparameter für Android- und iOS-Bereitstellungen konfigurieren. Erstellen Sie dedizierte mobile Schlüssel, um die Client-Server-Kommunikation zu sichern und automatisierten Bot-Traffic in mobilen Anwendungen zu verhindern.

reCAPTCHA-Schlüssel stellen dar, wie reCAPTCHA für eine mobile Anwendung konfiguriert ist.

Hinweis

• Umgebung für Google Cloud Fraud Defense vorbereiten
• Sie benötigen die folgende Identity and Access Management-Rolle: reCAPTCHA Enterprise-Administrator (roles/recaptchaenterprise.admin).

reCAPTCHA-Schlüssel erstellen

Für mobile Anwendungen können Sie nur punktzahlbasierte Schlüssel erstellen.

Wir empfehlen Folgendes, wenn Sie reCAPTCHA-Schlüssel für mobile Anwendungen erstellen:

• Erstellen Sie für jede mobile Anwendung einen reCAPTCHA-Schlüssel.

• Erstellen Sie für Android separate Schlüssel für die folgenden Szenarien:

  • Das Android-Paket ist nur im Google Play Store verfügbar.
  • Das Android-Paket ist nur in App-Shops verfügbar, die nicht zum Google Play Store gehören.

• Erstellen Sie separate reCAPTCHA-Schlüssel für Staging- und Produktionsumgebungen. Andernfalls riskieren Sie, dass die reCAPTCHA-Risikoanalyse mit Daten aus Ihrer Testumgebung verunreinigt wird.

Am einfachsten lässt sich ein reCAPTCHA-Schlüssel über dieGoogle Cloud Console erstellen. 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 Google Cloud Fraud Defense auf.

   Zu Google Cloud Fraud Defense

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 den Tab Keys aus.
4. Klicken Sie auf Schlüssel erstellen.
5. Geben Sie im Feld Anzeigename einen Anzeigenamen für den Schlüssel ein.
6. Führen Sie je nach Art des reCAPTCHA-Schlüssels, den Sie für Ihre mobile Anwendung erstellen möchten, die entsprechende Aktion aus:

reCAPTCHA-Schlüssel für iOS-Anwendungen erstellen

Wir empfehlen, einen reCAPTCHA-Schlüssel pro iOS-Anwendung zu erstellen.

1. Wählen Sie als Anwendungstyp die Option iOS aus.
1. Klicken Sie im Abschnitt iOS-Bundle-ID-Liste auf iOS-Bundle-ID hinzufügen.

2. Geben Sie im Feld Paket-ID den Namen Ihrer iOS-Paket-ID ein.

3. Optional: Wenn Sie eine weitere Paket-ID hinzufügen möchten, klicken Sie auf iOS-Paket-ID hinzufügen und geben Sie den Namen der iOS-Paket-ID in das Feld Paket-ID ein.
4. Zum Schutz des reCAPTCHA-Schlüssels für Ihre Paket-IDs müssen Sie den Ein/Aus-Button Bestätigung der Paket-ID deaktivieren deaktivieren. Wenn Sie die Bestätigung der Paket-ID deaktivieren, müssen Sie das Feld tokenProperties.iosBundleId in den von Ihnen erstellten Bewertungen prüfen.

5. Optional: Geben Sie die Apple Developer-Einstellungen an.

   Wir empfehlen, diese Daten bereitzustellen, da Fraud Defense so genauere Risikobewertungen für Ihren Traffic liefern kann.

   Geben Sie die folgenden Informationen ein:

   • Privater Schlüssel (.p8): Dieser wird im Apple Developer Center unter „Certificates, Identifiers & Profiles“ (Zertifikate, Kennungen und Profile) generiert.
   • Schlüsselkennung: Die Apple-Entwicklerschlüsselkennung (String mit 10 Zeichen).
   • Team-ID: Die Apple-Team-ID (10-stelliger String) des Inhabers des Bereitstellungsprofils, das zum Erstellen Ihrer Anwendung verwendet wird.
6. Optional: Klicken Sie auf Nächster Schritt (optional).

1. Wenn Sie für Ihre Nicht-Produktionsumgebung einen Wert angeben möchten, den der Schlüssel zurückgeben soll, wenn dafür Bewertungen erstellt werden, gehen Sie so vor:

   1. Klicken Sie unter Weitere Einstellungen auf die Ein/Aus-Schaltfläche Erstellen Sie diesen Schlüssel nur zu Testzwecken?.
   2. Verwenden Sie den Schieberegler Wert festlegen, um einen Wert zwischen 0 und 1,0 anzugeben.
7. 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 Android-Apps erstellen

1. Wählen Sie als Anwendungstyp die Option Android aus.
   
2. Klicken Sie im Abschnitt Android-Paketliste auf Android-Paket hinzufügen.
3. Geben Sie im Feld Android-Paket den Namen Ihres Android-Pakets ein.
4. Optional: Klicken Sie auf Android-Paket hinzufügen, um ein zusätzliches Paket hinzuzufügen, und geben Sie im Feld Android-Paket den Namen eines anderen Android-Pakets ein.
5. Wenn Sie erzwingen möchten, dass der reCAPTCHA-Schlüssel nur in Ihrer App verwendet wird, deaktivieren Sie die Option Bestätigung des Paketnamens deaktivieren. Wenn Sie die Bestätigung des Paketnamens deaktivieren, müssen Sie das Feld tokenProperties.androidPackageName in den von Ihnen erstellten Bewertungen prüfen.
6. Wenn Sie einen Schlüssel für eine Anwendung erstellen möchten, die neben dem Google Play Store auch in anderen App-Stores verfügbar ist, aktivieren Sie Anwendungen unterstützen, die außerhalb des Google Play Store vertrieben werden.
7. Optional: Klicken Sie auf Nächster Schritt (optional).

1. Wenn Sie für Ihre Nicht-Produktionsumgebung einen Wert angeben möchten, den der Schlüssel zurückgeben soll, wenn dafür Bewertungen erstellt werden, gehen Sie so vor:

   1. Klicken Sie unter Weitere Einstellungen auf die Ein/Aus-Schaltfläche Erstellen Sie diesen Schlüssel nur zu Testzwecken?.
   2. Verwenden Sie den Schieberegler Wert festlegen, um einen Wert zwischen 0 und 1,0 anzugeben.
8. Klicken Sie auf Schlüssel erstellen.

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

gcloud (iOS)

Verwenden Sie zum Erstellen von reCAPTCHA-Schlüsseln den Befehl gcloud recaptcha keys create.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• DISPLAY_NAME: Name für den Schlüssel. In der Regel der Name einer Website.
• BUNDLE_IDs: iOS-Bundle-IDs von Apps, die den Schlüssel verwenden dürfen. Geben Sie mehrere Bundle-IDs als durch Kommas getrennte Liste an.

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

Linux, macOS oder Cloud Shell

gcloud recaptcha keys create \
--display-name=DISPLAY_NAME  \
--ios --bundle-ids=BUNDLE_IDs

Windows (PowerShell)

gcloud recaptcha keys create `
--display-name=DISPLAY_NAME  `
--ios --bundle-ids=BUNDLE_IDs

Windows (cmd.exe)

gcloud recaptcha keys create ^
--display-name=DISPLAY_NAME  ^
--ios --bundle-ids=BUNDLE_IDs

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

gcloud (Android)

Verwenden Sie zum Erstellen von reCAPTCHA-Schlüsseln den Befehl gcloud recaptcha keys create.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• DISPLAY_NAME: Name für den Schlüssel. In der Regel der Name einer Website.
• PACKAGE_NAMES: Android-Paketnamen von Apps, die den Schlüssel verwenden dürfen. Geben Sie mehrere Paketnamen als durch Kommas getrennte Liste an.

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

Linux, macOS oder Cloud Shell

gcloud recaptcha keys create \
--display-name=DISPLAY_NAME  \
--android --package-names=PACKAGE_NAMES

Windows (PowerShell)

gcloud recaptcha keys create `
--display-name=DISPLAY_NAME  `
--android --package-names=PACKAGE_NAMES

Windows (cmd.exe)

gcloud recaptcha keys create ^
--display-name=DISPLAY_NAME  ^
--android --package-names=PACKAGE_NAMES

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

REST (iOS)

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DISPLAY_NAME: Name für den Schlüssel. In der Regel ein Anwendungsname.
• BUNDLE_IDs: iOS-Bundle-IDs von Apps, die den Schlüssel verwenden dürfen. Geben Sie mehrere Bundle-IDs als durch Kommas getrennte Liste an.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
   "allowedBundleIds":"BUNDLE_IDs"

  }
}

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-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile 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-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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 eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/project-id/keys/6LfhtywnAAAAABY3sCS2duZ6A55kmDXz-PNEgKgT",
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
    "allowAllBundleIds": false,
    "allowedBundleIds": [
        BUNDLE_IDS
    ]
  },
  "labels": {},
}

REST (Android)

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• DISPLAY_NAME: Name für den Schlüssel. In der Regel ein Anwendungsname.
• PACKAGE_NAMES: Android-Paketnamen von Apps, die den Schlüssel verwenden dürfen. Geben Sie mehrere Paketnamen als durch Kommas getrennte Liste an.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
  "allowedPackageNames":"PACKAGE_NAMES"
  }
}

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-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile 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-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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 eine JSON-Antwort ähnlich wie diese erhalten:

{
  "name": "projects/project-id/keys/6LcioSknAAAAABrjlMuZv2fjIGYMqwaAFC9izhoy",
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
      "allowAllPackageNames": false,
      "allowedPackageNames": [
          PACKAGE_NAMES
      ],
      "supportNonGoogleAppStoreDistribution": false
  },
  "labels": {},
}

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. Außerdem können Sie reCAPTCHA-Schlüssel nicht von einem Google Cloud Projekt in ein anderes migrieren.

Nächste Schritte

• Schlüssel unter iOS installieren
• Schlüssel auf Android-Geräten installieren