Mengidentifikasi akun yang menunjukkan perilaku terkait

Dokumen ini menjelaskan cara mengidentifikasi akun yang menunjukkan perilaku terkait. Misalnya, Anda mungkin ingin mengidentifikasi semua akun pengguna yang dibuat oleh pengguna berbahaya. Anda dapat menemukan akun, grup akun, dan keanggotaan grup akun yang menunjukkan perilaku terkait.

Mengidentifikasi akun yang menunjukkan perilaku terkait akan membantu Anda menemukan kelompok akun palsu dan pengambilalihan akun jika akun yang sebelumnya sahabat berkaitan dengan akun yang melakukan perilaku penyalahgunaan.

Fitur ini hanya tersedia menggunakan reCAPTCHA Enterprise REST API dan Library Klien.

Untuk mengambil daftar akun yang terkait dengan akun yang ditentukan, gunakan metode relatedaccountgroupmemberships.search.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • ACCOUNT_ID: ID yang secara unik terkait dengan akun pengguna untuk akun pengguna di situs Anda.
  • PAGE_SIZE: Opsional. Jumlah keanggotaan akun yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimum adalah 1.000. Jika jumlah keanggotaan akun lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
  • NEXT_PAGE_TOKEN: Opsional. Nilai nextPageToken yang ditampilkan dalam respons sebelumnya dari metode ini. Tentukan parameter ini untuk mengkueri keanggotaan akun lainnya.

Metode HTTP dan URL:

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

Isi JSON permintaan:

{
  "accountId": "ACCOUNT_ID"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

  "nextPageToken": "Q2N_rZgxUXOjNZtK1T1i0Q"
}

Contoh kode

Mengambil grup akun terkait

Untuk mengambil daftar grup akun dengan perilaku serupa, gunakan metode relatedaccountgroups.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • PAGE_SIZE: Opsional. Jumlah grup akun yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimum adalah 1.000. Jika jumlah grup akun lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
  • NEXT_PAGE_TOKEN: Opsional. Nilai nextPageToken yang ditampilkan dalam respons sebelumnya dari metode ini. Tentukan parameter ini untuk mengkueri grup akun lainnya.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

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

Jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Contoh kode

Mengambil keanggotaan grup akun terkait

Untuk mengambil daftar keanggotaan grup akun dengan perilaku serupa, gunakan metode relatedaccountgroupmemberships.list.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda.
  • GROUP_ID: Nama grup akun yang keanggotaan terkaitnya ingin Anda temukan.
  • PAGE_SIZE: Opsional. Jumlah keanggotaan grup akun yang akan disertakan dalam respons. Nilai defaultnya adalah 50, dan nilai maksimum adalah 1.000. Jika jumlah keanggotaan grup akun lebih besar dari ukuran halaman, respons akan berisi token penomoran halaman yang dapat Anda gunakan untuk mengambil halaman hasil berikutnya.
  • NEXT_PAGE_TOKEN: Opsional. Nilai nextPageToken yang ditampilkan dalam respons sebelumnya dari metode ini. Tentukan parameter ini untuk mengkueri lebih banyak keanggotaan grup akun.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut:

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

Jalankan perintah berikut:

$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

Anda akan melihat respons JSON seperti berikut:

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

Contoh kode

Langkah selanjutnya