Menyiapkan Policy Engine dengan kunci Universal

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menjelaskan cara mengonfigurasi Policy Engine di situs Anda menggunakan kunci Universal. Kunci universal adalah kunci Google Cloud Fraud Defense baru yang mendukung pembuatan aturan dalam Policy Engine.

Dengan Policy Engine, Fraud Defense dapat secara deterministik memicu verifikasi CAPTCHA berdasarkan aturan kebijakan kustom yang Anda konfigurasi. Aturan ini dapat menentukan kapan harus menampilkan tantangan Fraud Defense berdasarkan skor risiko, alamat IP, agen pengguna, ASN, atau identitas bot (agen AI) yang diverifikasi.

Konfigurasi Policy Engine Fraud Defense menyediakan dua fitur utama:

• Integrasi AutoExecute (protected_endpoint_group): Menyederhanakan integrasi JavaScript frontend dengan otomatis memeriksa permintaan jaringan asinkron keluar dan melampirkan token reCAPTCHA ke permintaan tersebut, sehingga hanya tag skrip yang diperlukan di frontend Anda.
• Kebijakan verifikasi (challenge_rule_groups): Menentukan apakah akan menampilkan verifikasi di berbagai tindakan pengguna dan mengonfigurasi tingkat kesulitan verifikasi terkait (USABILITY, BALANCE, SECURITY) menggunakan aturan berbasis CEL kustom.

Sebelum memulai

1. Menyiapkan lingkungan Anda untuk Google Cloud Fraud Defense.

2. Pastikan penagihan diaktifkan untuk project Google Cloud Anda.

   Akun penagihan yang ditautkan dan diaktifkan diperlukan untuk menggunakan Policy Engine. Anda dapat mengaktifkan penagihan menggunakan kartu kredit atau ID penagihan project Google Cloud yang ada. Jika Anda memerlukan bantuan terkait penagihan, hubungi Dukungan Penagihan Cloud.

Membuat kunci Universal

Bergantung pada antarmuka pilihan Anda, pilih opsi yang sesuai untuk membuat kunci Universal:

Konsol

1. Di konsol Google Cloud , buka halaman Google Cloud Fraud Defense.

   Buka Google Cloud Fraud Defense

2. Pastikan nama project Anda muncul di pemilih resource di bagian atas halaman.

   Jika tidak melihat nama project, klik pemilih resource, lalu pilih project Anda.

3. Pilih tab Keys.
4. Klik Create key.
5. Di kolom Display name, masukkan nama tampilan untuk kunci.
6. Untuk Application type, pilih Universal.
7. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.

gcloud

Untuk membuat kunci Universal menggunakan Google Cloud CLI, gunakan perintah gcloud recaptcha keys create dengan flag --universal:

gcloud recaptcha keys create --universal --display-name=DISPLAY_NAME

Respons berisi kunci Universal yang baru dibuat.

REST API

Untuk membuat kunci Universal menggunakan REST API, gunakan metode projects.keys.create dan tentukan universalSettings:

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

{
  "displayName": "DISPLAY_NAME",
  "universalSettings": {}
}

Ganti kode berikut:

• PROJECT_ID: Project ID Google Cloud Anda
• DISPLAY_NAME: nama tampilan untuk kunci Anda, biasanya nama situs Anda

Respons berisi kunci Universal yang baru dibuat.

Mengonfigurasi domain untuk Policy Engine

Catatan: Untuk situs, kunci reCAPTCHA bersifat unik untuk domain dan subdomain yang Anda tentukan. Anda dapat menentukan lebih dari satu domain jika menyajikan situs dari beberapa domain. Jika Anda menentukan domain (misalnya, examplepetstore.com), Anda tidak perlu menentukan subdomainnya (misalnya, subdomain.examplepetstore.com).

Bergantung pada antarmuka pilihan Anda, pilih opsi yang sesuai untuk mengonfigurasi domain yang diizinkan untuk kunci Universal Anda:

Konsol

1. Di konsol Google Cloud , buka halaman Fraud Defense.

   Buka Fraud Defense

2. Pastikan nama project Anda muncul di pemilih resource di bagian atas halaman.

   Jika tidak melihat nama project, klik pemilih resource, lalu pilih project Anda.

3. Klik tab Kunci.

4. Identifikasi kunci Universal yang ingin Anda konfigurasi, lalu klik kunci tersebut.

5. Di halaman Key details, klik Edit key.

6. Identifikasi bagian Key usage settings.

   Untuk melindungi kunci reCAPTCHA untuk domain dan subdomain Anda, pastikan tombol Nonaktifkan verifikasi domain dinonaktifkan.

   Menonaktifkan verifikasi domain merupakan risiko keamanan karena tidak ada batasan pada situs, sehingga kunci reCAPTCHA Anda dapat diakses dan digunakan oleh siapa saja.

   Masukkan nama domain untuk situs Anda:

   1. Di bagian Daftar domain, klik Tambahkan domain.
   2. Di kolom Domain, masukkan nama domain Anda.
   3. Opsional: Untuk menambahkan domain tambahan, klik Tambahkan domain, lalu masukkan nama domain lain di kolom Domain. Anda dapat menambahkan hingga 250 domain.

7. Klik Simpan perubahan.

Catatan: Untuk menggunakan kebijakan di lebih dari 250 domain, klik tombol Nonaktifkan verifikasi domain. Jika verifikasi domain dinonaktifkan, Fraud Defense akan mengabaikan daftar domain, dan Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname di penilaian yang Anda buat.

gcloud

Untuk memperbarui domain yang diizinkan untuk kunci Universal Anda menggunakan Google Cloud CLI, gunakan perintah gcloud alpha recaptcha policies update dan tentukan domain dalam file konfigurasi kebijakan (misalnya, POLICY.yaml):

gcloud alpha recaptcha policies update --key=KEY_ID --policy=POLICY.yaml

Catatan: Perintah gcloud alpha recaptcha policies update memperbarui seluruh kebijakan. protected_endpoint_group atau challenge_rule_groups yang ada harus disertakan dalam file POLICY.yaml agar tidak dihapus.

File POLICY.yaml harus menentukan domain yang diizinkan di bagian clientSettings:

clientSettings:
  allowedDomains:
    - DOMAIN_NAME_1
    - DOMAIN_NAME_2

Atau, untuk mengizinkan semua domain dan menonaktifkan verifikasi domain, tetapkan allowAllDomains ke true di file POLICY.yaml:

clientSettings:
  allowAllDomains: true

Ganti kode berikut:

• KEY_ID: ID atau nama resource lengkap kunci Universal Anda
• DOMAIN_NAME_1, DOMAIN_NAME_2: nama domain situs yang diizinkan untuk menggunakan kunci

Catatan: Jika allowAllDomains ditetapkan ke true, Fraud Defense akan mengabaikan daftar domain, dan Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname di penilaian yang Anda buat.

REST API

Untuk memperbarui domain yang diizinkan untuk kunci Universal Anda menggunakan REST API, gunakan metode projects.keys.updatePolicy.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Project ID Google Cloud Anda
• KEY_ID: ID kunci Universal Anda
• DOMAIN_NAME_1, DOMAIN_NAME_2: nama domain situs yang diizinkan untuk menggunakan kunci

Metode HTTP dan URL:

PATCH https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY_ID/policy?updateMask=clientSettings.allowedDomains,clientSettings.allowAllDomains

Meminta isi JSON:

{
"clientSettings": {
  "allowedDomains": [
    "DOMAIN_NAME_1",
    "DOMAIN_NAME_2"
  ],
  "allowAllDomains": false
}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

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 PATCH \
     -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_ID/policy?updateMask=clientSettings.allowedDomains,clientSettings.allowAllDomains"

PowerShell (Windows)

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/KEY_ID/policy?updateMask=clientSettings.allowedDomains,clientSettings.allowAllDomains" | Select-Object -Expand Content

Jika berhasil, permintaan akan menampilkan konfigurasi kebijakan yang diperbarui.

Catatan: Untuk menggunakan kebijakan di lebih dari 250 domain, tetapkan allowAllDomains ke true dalam isi permintaan. Jika allowAllDomains ditetapkan ke true, Fraud Defense akan mengabaikan daftar domain, dan Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname dalam penilaian yang Anda buat.

Langkah berikutnya

• Instal kunci Universal di halaman web.