Como identificar contas que mostram comportamentos relacionados

Neste documento, descrevemos como identificar contas que mostram comportamentos relacionados. Por exemplo, é possível identificar todas as contas de usuário criadas por um usuário mal-intencionado. É possível encontrar contas, grupos de contas e associações a grupos de contas que mostram comportamentos relacionados.

Identificar contas que mostram comportamentos relacionados ajuda você a encontrar grupos de contas falsas e transferência de conta quando uma conta legítima está relacionada a contas com comportamento abusivo.

Esse recurso só está disponível com a API REST e as bibliotecas de cliente do reCAPTCHA Enterprise.

Para recuperar uma lista de contas relacionadas a uma conta especificada, use o método relatedaccountgroupmemberships.search.

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

  • PROJECT_ID: é seu ID do projeto no Google Cloud.
  • HASHED_ACCOUNT_ID: um identificador de usuário com hash estável gerado usando o método SHA256-HMAC para uma conta de usuário no seu site.
  • PAGE_SIZE: opcional. O número de associações de conta a serem incluídas na resposta. O valor padrão é 50, e o máximo é 1.000. Se o número de associações de conta for maior que o tamanho da página, a resposta conterá um token de paginação que você pode usar para recuperar a próxima página de resultados.
  • NEXT_PAGE_TOKEN: opcional. O valor de nextPageToken retornado na resposta anterior desse método. Especifique esse parâmetro para consultar mais associações à conta.

Método 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 da solicitação:

{
  "hashedAccountId": "HASHED_ACCOUNT_ID"
}

Para enviar a solicitação, escolha uma destas opções:

curl

Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

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

Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

$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

Você receberá uma resposta JSON semelhante a esta:

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

  "nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}

Exemplo de código

Recuperar grupos de contas relacionadas

Para recuperar uma lista de grupos de contas com comportamentos semelhantes, use o método relatedaccountgroups.list.

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

  • PROJECT_ID: é seu ID do projeto no Google Cloud.
  • PAGE_SIZE: opcional. Número de grupos de contas a serem incluídos na resposta. O valor padrão é 50, e o máximo é 1.000. Se o número de grupos de contas for maior do que o tamanho da página, a resposta conterá um token de paginação que você poderá usar para recuperar a próxima página de resultados.
  • NEXT_PAGE_TOKEN: opcional. O valor de nextPageToken retornado em uma resposta anterior desse método. Especifique esse parâmetro para consultar mais grupos de contas.

Método HTTP e URL:

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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

Execute o seguinte comando:

$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

Você receberá uma resposta JSON semelhante a esta:

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

Exemplo de código

Recuperar associações a grupos de contas relacionadas

Para recuperar uma lista de associações a grupos de contas com comportamentos semelhantes, use o método relatedaccountgroupmemberships.list.

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

  • PROJECT_ID: é seu ID do projeto no Google Cloud.
  • GROUP_ID: nome do grupo de contas cujas associações relacionadas você quer encontrar.
  • PAGE_SIZE: opcional. O número de associações a grupos de contas a serem incluídas na resposta. O valor padrão é 50, e o máximo é 1.000. Se o número de associações a grupos de contas for maior que o tamanho da página, a resposta conterá um token de paginação que você poderá usar para recuperar a próxima página de resultados.
  • NEXT_PAGE_TOKEN: opcional. O valor de nextPageToken retornado na resposta anterior desse método. Especifique este parâmetro para consultar mais associações a grupos de contas.

Método 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

Para enviar a solicitação, escolha uma destas opções:

curl

Execute o seguinte comando:

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

Execute o seguinte comando:

$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

Você receberá uma resposta JSON semelhante a esta:

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

Exemplo de código

A seguir