Identificare gli account che mostrano comportamenti correlati

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questo documento descrive come identificare gli account che mostrano comportamenti correlati. Ad esempio, potresti voler identificare tutti gli account utente creati da un utente malintenzionato. Puoi trovare account, gruppi di account e iscrizioni a gruppi di account che mostrano comportamenti correlati.

Identificare gli account che mostrano comportamenti correlati ti aiuta a trovare gruppi di account falsi e violazioni di account quando un account precedentemente legittimo è correlato ad account con comportamenti illeciti.

Questa funzionalità è disponibile solo utilizzando l'API REST Enterprise di reCAPTCHA e le librerie client.

Per recuperare un elenco di account relativi a un account specificato, utilizza il metodo relatedaccountgroupmemberships.search.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud.
  • HASHED_ACCOUNT_ID: un identificatore utente sottoposto ad hashing stabile generato utilizzando il metodo SHA256-HMAC per un account utente sul tuo sito web.
  • PAGE_SIZE: facoltativo. Il numero di abbonamenti all'account da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 1000. Se il numero di iscrizioni all'account è maggiore delle dimensioni della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il valore di nextPageToken restituito nella risposta precedente di questo metodo. Specifica questo parametro per eseguire query su altri membri dell'account.

Metodo HTTP e URL:

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

Corpo JSON richiesta:

{
  "hashedAccountId": "HASHED_ACCOUNT_ID"
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

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

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

  "nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}

Esempio di codice

Recuperare gruppi di account correlati

Per recuperare un elenco di gruppi di account con comportamenti simili, utilizza il metodo relatedaccountgroups.list.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud.
  • PAGE_SIZE: facoltativo. Il numero di gruppi di account da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 1000. Se il numero di gruppi di account è maggiore delle dimensioni della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il valore di nextPageToken restituito in una risposta precedente di questo metodo. Specifica questo parametro per eseguire query su altri gruppi di account.

Metodo HTTP e URL:

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

Esegui questo comando:

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

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Esempio di codice

Recuperare le appartenenze a gruppi di account correlati

Per recuperare un elenco di appartenenze a gruppi di account con comportamenti simili, utilizza il metodo relatedaccountgroupmemberships.list.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: il tuo ID progetto Google Cloud.
  • GROUP_ID: nome del gruppo di account per cui vuoi trovare gli abbonamenti correlati.
  • PAGE_SIZE: facoltativo. Il numero di iscrizioni ai gruppi di account da includere nella risposta. Il valore predefinito è 50 e il valore massimo è 1000. Se il numero di iscrizioni ai gruppi di account è maggiore delle dimensioni della pagina, la risposta contiene un token di impaginazione che puoi utilizzare per recuperare la pagina successiva dei risultati.
  • NEXT_PAGE_TOKEN: facoltativo. Il valore di nextPageToken restituito nella risposta precedente di questo metodo. Specifica questo parametro per eseguire query su un numero maggiore di gruppi di account.

Metodo HTTP e URL:

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

Per inviare la richiesta, scegli una delle seguenti opzioni:

ricciolo

Esegui questo comando:

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

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Esempio di codice

Passaggi successivi