Konten mit ähnlichen Verhaltensmustern identifizieren

In diesem Dokument wird beschrieben, wie Sie Konten mit ähnlichem Verhalten identifizieren. Beispielsweise möchten Sie alle Nutzerkonten ermitteln, die von einem böswilligen Nutzer erstellt wurden. Sie können Konten, Kontogruppen und Kontogruppenmitgliedschaften finden, die ähnliches Verhalten zeigen.

Wenn Sie Konten mit ähnlichem Verhalten identifizieren, können Sie Gruppen von gefälschten Konten und Kontoübernahmen finden, wenn ein zuvor legitimes Konto mit Konten mit missbräuchlichem Verhalten in Verbindung steht.

Diese Funktion ist nur mit der reCAPTCHA REST API und den Clientbibliotheken verfügbar.

Mit der Methode relatedaccountgroupmemberships.search können Sie eine Liste der Konten abrufen, die mit einem bestimmten Konto verknüpft sind.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • ACCOUNT_ID: Die Kennung, die dem Nutzerkonto für ein Nutzerkonto auf Ihrer Website eindeutig zugeordnet ist.
  • PAGE_SIZE: Optional. Die Anzahl der Kontomitgliedschaften, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 1.000. Wenn die Anzahl der Kontomitgliedschaften die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
  • NEXT_PAGE_TOKEN: Optional. Der Wert von nextPageToken, der in der vorherigen Antwort dieser Methode zurückgegeben wurde. Geben Sie diesen Parameter an, um mehr Kontomitgliedschaften abzufragen.

HTTP-Methode und URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN

JSON-Text der Anfrage:

{
  "accountId": "ACCOUNT_ID"
}

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

curl

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/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"

PowerShell

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/relatedaccountgroupmemberships:search?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "relatedAccountGroupMemberships": [
    {
      "name": "projects/projectId/relatedaccountgroups/groupId187/memberships/membershipId95",
      "accountId": "4RopXS59"
    },
    {
      "name": "projects/projectId/relatedaccountgroups/groupId91/memberships/membershipId23",
      "accountId": "HVMv1DTb"
    }
  ],

  "nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}

Codebeispiel

Zugehörige Kontogruppen abrufen

Mit der Methode relatedaccountgroups.list können Sie eine Liste von Kontogruppen mit ähnlichen Verhaltensmustern abrufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • PAGE_SIZE: Optional. Die Anzahl der Kontogruppen, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 1.000. Wenn die Anzahl der Kontogruppen die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
  • NEXT_PAGE_TOKEN: Optional. Der Wert von nextPageToken, der in einer früheren Antwort dieser Methode zurückgegeben wurde. Geben Sie diesen Parameter an, um mehrere Kontogruppen abzufragen.

HTTP-Methode und URL:

GET https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

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

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "relatedAccountGroups": [
    {
      "name": "projects/projectId/relatedaccountgroups/groupId1"
    },
    {
      "name": "projects/projectId/relatedaccountgroups/groupId2"
    }
  ],
  "nextPageToken": "BenimQwKzIOibbOO2Lhisw"
}

Codebeispiel

Zugehörige Kontogruppenmitgliedschaften abrufen

Verwenden Sie die Methode relatedaccountgroupmemberships.list, um eine Liste der Kontogruppenmitgliedschaften mit ähnlichen Verhaltensmustern abzurufen.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID.
  • GROUP_ID: Name der Kontogruppe, für die Sie zugehörige Mitgliedschaften finden möchten.
  • PAGE_SIZE: Optional. Die Anzahl der Kontogruppenmitgliedschaften, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Höchstwert 1.000. Wenn die Anzahl der Kontogruppenmitgliedschaften die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem Sie die nächste Ergebnisseite abrufen können.
  • NEXT_PAGE_TOKEN: Optional. Der Wert von nextPageToken, der in der vorherigen Antwort dieser Methode zurückgegeben wurde. Geben Sie diesen Parameter an, um mehr Kontogruppenmitgliedschaften abzufragen.

HTTP-Methode und URL:

GET https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

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

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/relatedaccountgroups/GROUP_ID/memberships?page_size=PAGE_SIZE&page_token=NEXT_PAGE_TOKEN" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "relatedAccountGroupMemberships": [
    {
      "name": "projects/projectId/relatedaccountgroups/groupId/memberships/membershipId1",
      "accountId": "4RopXS59"
    },
    {
      "name": "projects/projectId/relatedaccountgroups/groupId/memberships/membershipId2",
      "accountId": "HVMv1DTb"
    }
  ],
  "nextPageToken": "WPuIn8GHU3JvcJqgvmE7Aw"
}

Codebeispiel

Nächste Schritte