Com a API Related Accounts da Fraud Defense, é possível identificar contas de usuário que mostram um comportamento coordenado ou relacionado na sua plataforma. A API organiza contas relacionadas em grupos e associações para ajudar você a detectar clusters de contas falsas e evitar sequestros de contas automatizados.
Esse recurso está disponível apenas com a API REST do reCAPTCHA e as bibliotecas de cliente.
Recuperar contas relacionadas a uma conta específica
Para recuperar uma lista de contas relacionadas a uma conta específica, use o método relatedaccountgroupmemberships.search.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto Google Cloud .
- ACCOUNT_ID: o identificador associado exclusivamente à conta de usuário do seu site.
- PAGE_SIZE: opcional. O número de assinaturas de conta a serem incluídas na resposta. O valor padrão é 50, e o valor máximo é 1.000. Se o número de assinaturas de conta for maior que o tamanho da página, a resposta vai conter um token de paginação que pode ser usado para recuperar a próxima página de resultados.
- NEXT_PAGE_TOKEN: opcional. O valor de
nextPageTokenretornado na resposta anterior desse método. Especifique esse parâmetro para consultar mais assinaturas de 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:
{
"accountId": "ACCOUNT_ID"
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:
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
Salve o corpo da solicitação em um arquivo com
o nome request.json e execute o comando abaixo:
$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
Você receberá uma resposta JSON semelhante a esta:
{
"relatedAccountGroupMemberships": [
{
"name": "projects/projectId/relatedaccountgroups/groupId187/memberships/membershipId95",
"accountId": "4RopXS59"
},
{
"name": "projects/projectId/relatedaccountgroups/groupId91/memberships/membershipId23",
"accountId": "HVMv1DTb"
}
],
"nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}
Exemplo de código
Recuperar grupos de contas relacionados
Para recuperar uma lista de grupos de contas com comportamentos semelhantes, use o
método relatedaccountgroups.list.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto Google Cloud .
- PAGE_SIZE: opcional. O número de grupos de contas a serem incluídos na resposta. O valor padrão é 50, e o valor máximo é 1.000. Se o número de grupos de contas for maior que o tamanho da página, a resposta vai conter um token de paginação que pode ser usado para recuperar a próxima página de resultados.
- NEXT_PAGE_TOKEN: opcional. O valor de
nextPageTokenretornado 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 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 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 de grupos de contas relacionadas
Para recuperar uma lista de associações de grupos de contas com comportamentos semelhantes, use o método relatedaccountgroupmemberships.list.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto Google Cloud .
- GROUP_ID: nome do grupo de contas para o qual você quer encontrar as associações relacionadas.
- PAGE_SIZE: opcional. O número de associações de grupos de contas a serem incluídas na resposta. O valor padrão é 50, e o valor 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 vai conter um token de paginação que pode ser usado para recuperar a próxima página de resultados.
- NEXT_PAGE_TOKEN: opcional. O valor de
nextPageTokenretornado na resposta anterior desse método. Especifique esse parâmetro para consultar mais associações de 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 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 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",
"accountId": "4RopXS59"
},
{
"name": "projects/projectId/relatedaccountgroups/groupId/memberships/membershipId2",
"accountId": "HVMv1DTb"
}
],
"nextPageToken": "WPuIn8GHU3JvcJqgvmE7Aw"
}
Exemplo de código
A seguir
Saiba mais sobre os seguintes recursos de proteção de conta: