Mengonfigurasi daftar alamat IP yang diizinkan

Untuk mengecualikan alamat IP tepercaya dari penerapan reCAPTCHA, Anda membuat daftar yang diizinkan untuk kunci reCAPTCHA yang terkait dengan situs Anda, dan menambahkan alamat IP dan subnet ke daftar yang diizinkan tersebut.

Anda juga dapat menghapus alamat IP dan subnet dari daftar yang diizinkan, serta mencantumkan alamat IP dan subnet yang ditambahkan ke daftar yang diizinkan.

Sebelum memulai

• Kumpulkan semua alamat IP dan subnet yang ingin Anda tambahkan ke daftar yang diizinkan.

• Identifikasi alamat IP dan subnet yang ingin Anda hapus dari daftar yang diizinkan.

• Pastikan Anda memiliki peran Identity and Access Management berikut: reCAPTCHA Enterprise Admin (roles/recaptchaenterprise.admin).

Menambahkan alamat IP atau subnet ke daftar yang diizinkan

Saat Anda menambahkan alamat IP atau subnet ke daftar yang diizinkan, reCAPTCHA akan melewati verifikasi dan selalu memberikan skor 0.9 ke permintaan yang berasal dari alamat IP atau subnet tersebut. Anda dapat menambahkan maksimum 100 alamat IP dan subnet ke daftar yang diizinkan.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.
   • IP_ADDRESS_OR_SUBNET: Alamat IP atau subnet yang perlu ditambahkan ke daftar yang diizinkan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys add-ip-override
   KEY \
   --ip=IP_ADDRESS_OR_SUBNET \
   --override=ALLOW

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys add-ip-override
   KEY `
   --ip=IP_ADDRESS_OR_SUBNET `
   --override=ALLOW

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys add-ip-override
   KEY ^
   --ip=IP_ADDRESS_OR_SUBNET ^
   --override=ALLOW

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.
• IP_ADDRESS_OR_SUBNET: Alamat IP atau subnet yang perlu ditambahkan ke daftar yang diizinkan.
• PROJECT_ID: Project ID Google Cloud Anda

Metode HTTP dan URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:addIpOverride

Isi JSON permintaan:

{
  "ip_override_data": {
    "ip": "IP_ADDRESS_OR_SUBNET",
    "override_type": "ALLOW"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/keys/KEY:addIpOverride"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/keys/KEY:addIpOverride" | Select-Object -Expand Content

Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

Setelah Anda menambahkan alamat IP atau subnet ke daftar yang diizinkan, perubahan akan diterapkan dalam beberapa menit.

Menghapus alamat IP atau subnet dari daftar yang diizinkan

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.
   • IP_ADDRESS_OR_SUBNET: Alamat IP atau subnet yang perlu ditambahkan ke daftar yang diizinkan.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys remove-ip-override
   KEY \
   --ip=IP_ADDRESS_OR_SUBNET \
   --override=ALLOW

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys remove-ip-override
   KEY `
   --ip=IP_ADDRESS_OR_SUBNET `
   --override=ALLOW

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys remove-ip-override
   KEY ^
   --ip=IP_ADDRESS_OR_SUBNET ^
   --override=ALLOW

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.
• IP_ADDRESS_OR_SUBNET: Alamat IP atau subnet yang perlu ditambahkan ke daftar yang diizinkan.
• PROJECT_ID: Project ID Google Cloud Anda

Metode HTTP dan URL:

POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY:removeIpOverride

Isi JSON permintaan:

{
  "ip_override_data": {
    "ip": "IP_ADDRESS_OR_SUBNET",
    "override_type": "ALLOW"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/keys/KEY:removeIpOverride"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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/keys/KEY:removeIpOverride" | Select-Object -Expand Content

Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.

Setelah Anda menghapus alamat IP atau subnet dari daftar yang diizinkan, perubahan tersebut akan diterapkan dalam beberapa menit.

Mencantumkan semua alamat IP dari daftar yang diizinkan

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

   • KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.

   Jalankan perintah berikut:

   Linux, macOS, atau Cloud Shell

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys list-ip-overrides KEY --format=json

   Windows (PowerShell)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys list-ip-overrides KEY --format=json

   Windows (cmd.exe)

   Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

   gcloud recaptcha keys list-ip-overrides KEY --format=json

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• KEY: Kunci reCAPTCHA yang terkait dengan situs Anda.
• PROJECT_ID: Project ID Google Cloud Anda

Metode HTTP dan URL:

GET https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://recaptchaenterprise.googleapis.com/v1/projects//keys/:listIpOverrides"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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//keys/:listIpOverrides" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip seperti berikut:

{
  "ipOverrides": [
    {
      "ip": "1.2.3.4",
      "overrideType": "ALLOW"
    }
  ],
  "nextPageToken": ""
}

Langkah selanjutnya

• Membuat penilaian untuk situs