Mengonfigurasi daftar alamat IP yang diizinkan

Untuk mengecualikan alamat IP tepercaya dari penerapan reCAPTCHA, buat daftar yang diizinkan untuk kunci reCAPTCHA yang terkait dengan situs Anda. Kemudian, tambahkan alamat IP dan subnet ke daftar yang diizinkan ini.

Anda juga dapat menghapus alamat IP atau subnet dari daftar yang diizinkan dan melihat alamat IP serta subnet dalam daftar yang diizinkan.

Sebelum memulai

Sebelum memulai, pastikan Anda melakukan hal berikut:

• 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 untuk permintaan yang berasal dari alamat IP atau subnet tersebut. Anda dapat menambahkan maksimal 1.000 alamat IP dan subnet ke daftar yang diizinkan.

gcloud

1. Di konsol, aktifkan Cloud Shell. Google Cloud

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

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: ID project Anda Google Cloud

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "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 menggunakan 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 menggunakan 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 berhasil (2xx) dan respons kosong.

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

Memvalidasi konfigurasi daftar yang diizinkan

Untuk mengonfirmasi bahwa daftar yang diizinkan IP Anda berfungsi seperti yang diharapkan, selesaikan langkah-langkah berikut:

1. Pastikan Anda menambahkan alamat IP atau subnet ke daftar yang diizinkan untuk kunci reCAPTCHA tertentu.

2. Mulai transaksi reCAPTCHA lengkap dari mesin atau lingkungan yang menggunakan alamat IP yang ada dalam daftar yang diizinkan.

3. Periksa hasil penilaian. Jika daftar yang diizinkan aktif untuk IP asal, riskAnalysis.score dalam respons JSON adalah 0.9.

Penting: Mekanisme daftar yang diizinkan IP memeriksa alamat IP sumber sebenarnya dari traffic tempat token reCAPTCHA dibuat. Mekanisme ini tidak menggunakan kolom event.userIpAddress, yang dapat Anda kirim secara opsional dalam permintaan untuk membuat penilaian. Kolom event.userIpAddress memberikan informasi IP pengguna akhir untuk analisis risiko terpisah, bukan untuk penerapan daftar yang diizinkan.

Menghapus alamat IP atau subnet dari daftar yang diizinkan

gcloud

1. Di konsol, aktifkan Cloud Shell. Google Cloud

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

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: ID project Anda Google Cloud

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "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 menggunakan 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 menggunakan 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 berhasil (2xx) dan respons kosong.

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

Mencantumkan semua alamat IP dari daftar yang diizinkan

gcloud

1. Di konsol, aktifkan Cloud Shell. Google Cloud

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

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: ID project Anda Google Cloud

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 menggunakan 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 menggunakan 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 berikutnya

• Membuat penilaian untuk situs