Konten mit entsprechenden Verhaltensweisen identifizieren

In diesem Dokument wird beschrieben, wie Sie Konten mit ähnlichem Verhalten ermitteln. So lassen sich beispielsweise alle Nutzerkonten ermitteln, die von einem böswilligen Nutzer erstellt wurden. Sie können nach Konten, Kontogruppen und Kontogruppenmitgliedschaften suchen, die Verhaltensweisen zeigen.

Wenn Sie Konten kennen, die Verhaltensweisen zeigen, lassen sich gefälschte Konten und Kontoübernahmen leichter finden, wenn ein zuvor legitimes Konto mit Konten mit missbräuchlichem Verhalten in Verbindung steht.

Dieses Feature ist nur über die reCAPTCHA Enterprise REST API und Clientbibliotheken verfügbar.

Wenn Sie eine Liste der Konten für ein bestimmtes Konto abrufen möchten, verwenden Sie die Methode relatedaccountgroupmemberships.search.

Bevor Sie eine der Anfragedaten verwenden, nehmen Sie folgende Ersetzungen vor:

  • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
  • HASHED_ACCOUNT_ID: Eine stabile, gehashte Nutzerkennung, die mit der SHA256-HMAC-Methode für ein Nutzerkonto auf Ihrer Website generiert wurde.
  • PAGE_SIZE: optional. Die Anzahl der Kontomitgliedschaften, die in die Antwort aufgenommen werden sollen. Der Standardwert ist 50 und der Maximalwert ist 1.000. Wenn die Anzahl der Kontomitgliedschaften größer als die Seitengröße ist, enthält die Antwort einen Seitenumbruch, mit dem du die nächste Seite mit Ergebnissen abrufen kannst.
  • NEXT_PAGE_TOKEN: optional. Der Wert von nextPageToken, der in der früheren Antwort dieser Methode zurückgegeben wurde. Geben Sie diesen Parameter an, um weitere 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:

{
  "hashedAccountId": "HASHED_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 application-default 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 application-default 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 in etwa folgende JSON-Antwort erhalten:

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

  "nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}

Codebeispiel

Zugehörige Kontogruppen abrufen

Wenn Sie eine Liste von Kontogruppen mit ähnlichen Verhaltensweisen abrufen möchten, verwenden Sie die Methode relatedaccountgroups.list.

Bevor Sie eine der Anfragedaten verwenden, nehmen Sie folgende Ersetzungen vor:

  • PROJECT_ID ist 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 Maximalwert ist 1.000. Wenn die Anzahl der Kontogruppen die Seitengröße überschreitet, enthält die Antwort ein Paginierungstoken, mit dem du die nächste Seite mit Ergebnissen abrufen kannst.
  • NEXT_PAGE_TOKEN: optional. Der Wert von nextPageToken wurde in einer früheren Antwort auf diese Methode zurückgegeben. Geben Sie diesen Parameter an, um weitere 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 application-default 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 application-default 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 in etwa folgende JSON-Antwort erhalten:

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

Codebeispiel

Zugehörige Mitgliedschaften der Kontogruppe abrufen

Mit der Methode relatedaccountgroupmemberships.list können Sie eine Liste von Kontogruppenmitgliedschaften mit ähnlichen Verhaltensweisen abrufen.

Bevor Sie eine der Anfragedaten verwenden, nehmen Sie folgende Ersetzungen vor:

  • PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
  • GROUP_ID: Der Name der Kontogruppe, für die du ähnliche Mitgliedschaften finden möchtest.
  • PAGE_SIZE: optional. Die Anzahl der Kontogruppenmitgliedschaften, die in der Antwort enthalten sein sollen. Der Standardwert ist 50 und der Maximalwert ist 1.000. Wenn die Anzahl der Kontogruppenmitgliedschaften die Seitengröße überschreitet, enthält die Antwort ein Seitenumbruch-Token, mit dem du die nächste Seite mit Ergebnissen abrufen kannst.
  • NEXT_PAGE_TOKEN: optional. Der Wert von nextPageToken, der in der früheren Antwort dieser Methode zurückgegeben wurde. Verwenden Sie diesen Parameter, um weitere 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 application-default 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 application-default 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 in etwa folgende JSON-Antwort erhalten:

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

Codebeispiel

Weitere Informationen