Como identificar contas que mostram comportamentos relacionados

Este recurso é coberto pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud. Os recursos anteriores à disponibilidade geral podem ter compatibilidade limitada, e as alterações neles podem não ser compatíveis com outras versões anteriores. Para mais informações, consulte as descrições das fases de lançamento.

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.

Recuperar contas relacionadas a uma conta específica

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Java

Ver no GitHub Feedback

import com.google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseServiceClient;
import com.google.protobuf.ByteString;
import com.google.recaptchaenterprise.v1.RelatedAccountGroupMembership;
import com.google.recaptchaenterprise.v1.SearchRelatedAccountGroupMembershipsRequest;
import java.io.IOException;
import java.security.NoSuchAlgorithmException;

public class SearchRelatedAccountGroupMemberships {

  public static void main(String[] args) throws IOException, NoSuchAlgorithmException {
    // TODO(developer): Replace these variables before running the sample.
    // projectId: Google Cloud Project Id.
    String projectId = "project-id";

    // HMAC SHA-256 hashed unique id of the customer.
    ByteString hashedAccountId = ByteString.copyFrom(new byte[] {});

    searchRelatedAccountGroupMemberships(projectId, hashedAccountId);
  }

  // List group memberships for the hashed account id.
  public static void searchRelatedAccountGroupMemberships(
      String projectId, ByteString hashedAccountId) throws IOException {
    try (RecaptchaEnterpriseServiceClient client = RecaptchaEnterpriseServiceClient.create()) {

      SearchRelatedAccountGroupMembershipsRequest request =
          SearchRelatedAccountGroupMembershipsRequest.newBuilder()
              .setParent("projects/" + projectId)
              .setHashedAccountId(hashedAccountId)
              .build();

      for (RelatedAccountGroupMembership groupMembership :
          client.searchRelatedAccountGroupMemberships(request).iterateAll()) {
        System.out.println(groupMembership.getName());
      }
      System.out.printf(
          "Finished searching related account group memberships for %s!", hashedAccountId);
    }
  }
}

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Java

Ver no GitHub Feedback

import com.google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseServiceClient;
import com.google.recaptchaenterprise.v1.ListRelatedAccountGroupsRequest;
import com.google.recaptchaenterprise.v1.RelatedAccountGroup;
import java.io.IOException;

public class ListRelatedAccountGroups {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // projectId : Google Cloud Project Id.
    String projectId = "project-id";

    listRelatedAccountGroups(projectId);
  }

  // List related account groups in the project.
  public static void listRelatedAccountGroups(String projectId) throws IOException {
    try (RecaptchaEnterpriseServiceClient client = RecaptchaEnterpriseServiceClient.create()) {

      ListRelatedAccountGroupsRequest request =
          ListRelatedAccountGroupsRequest.newBuilder().setParent("projects/" + projectId).build();

      System.out.println("Listing related account groups..");
      for (RelatedAccountGroup group : client.listRelatedAccountGroups(request).iterateAll()) {
        System.out.println(group.getName());
      }
    }
  }
}

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Observação: essa solicitação de API requer um token de autorização da CLI do Google Cloud, que é gerado pelo comando gcloud auth application-default print-access-token. Verifique se você definiu a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho do arquivo da chave privada da conta de serviço.

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

Java

Ver no GitHub Feedback

import com.google.cloud.recaptchaenterprise.v1.RecaptchaEnterpriseServiceClient;
import com.google.recaptchaenterprise.v1.ListRelatedAccountGroupMembershipsRequest;
import com.google.recaptchaenterprise.v1.RelatedAccountGroupMembership;
import java.io.IOException;

public class ListRelatedAccountGroupMemberships {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // projectId: Google Cloud Project Id.
    String projectId = "project-id";

    // relatedAccountGroup: Name of the account group.
    String relatedAccountGroup = "related-account-group-name";

    listRelatedAccountGroupMemberships(projectId, relatedAccountGroup);
  }

  /** Given a group name, list memberships in the group. */
  public static void listRelatedAccountGroupMemberships(
      String projectId, String relatedAccountGroup) throws IOException {
    try (RecaptchaEnterpriseServiceClient client = RecaptchaEnterpriseServiceClient.create()) {

      // Construct the request.
      ListRelatedAccountGroupMembershipsRequest request =
          ListRelatedAccountGroupMembershipsRequest.newBuilder()
              .setParent(
                  String.format(
                      "projects/%s/relatedaccountgroups/%s", projectId, relatedAccountGroup))
              .build();

      for (RelatedAccountGroupMembership relatedAccountGroupMembership :
          client.listRelatedAccountGroupMemberships(request).iterateAll()) {
        System.out.println(relatedAccountGroupMembership.getName());
      }
      System.out.println("Finished listing related account group memberships.");
    }
  }
}

A seguir

• Saiba mais sobre os seguintes recursos de proteção de conta:

  • Autenticação multifator
  • Detecção de vazamento de senhas