Membuat kunci reCAPTCHA untuk situs

Anda dapat membuat kunci reCAPTCHA untuk memverifikasi interaksi pengguna di halaman web Anda.

Kunci reCAPTCHA merepresentasikan cara reCAPTCHA dikonfigurasi untuk situs. Konfigurasi ini mencakup opsi penting seperti apakah akan menampilkan tantangan CAPTCHA.

Sebelum memulai

• Menyiapkan lingkungan Anda untuk Google Cloud Fraud Defense.
• Pastikan Anda memiliki peran Identity and Access Management berikut: Admin reCAPTCHA Enterprise (roles/recaptchaenterprise.admin).
• Pilih jenis kunci yang paling sesuai untuk kasus penggunaan Anda.

Membuat kunci reCAPTCHA

Tidak ada batasan jumlah kunci reCAPTCHA yang dapat Anda buat untuk project Google Cloud . Sebaiknya buat satu kunci reCAPTCHA per situs.

Sebaiknya buat kunci reCAPTCHA terpisah untuk lingkungan staging dan produksi. Jika tidak, Anda berisiko mengotori analisis risiko reCAPTCHA dengan data dari lingkungan pengujian Anda.

Konsol Cloud

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 Web.

   Bagian Domain list akan muncul.

7. 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.

8. Masukkan nama domain untuk situs Anda:

   1. Di bagian Domain list, klik Add a domain.
   2. Di kolom Domain, masukkan nama domain Anda.

   3. Opsional: Untuk menambahkan domain tambahan, klik Tambahkan domain dan masukkan nama domain lain di kolom Domain. Anda dapat menambahkan hingga maksimum 250 domain.

      Untuk situs, kunci reCAPTCHA bersifat unik untuk domain dan subdomain yang Anda tentukan. Anda dapat menentukan lebih dari satu domain jika menayangkan situs dari beberapa domain. Jika Anda menentukan domain (misalnya, examplepetstore.com), Anda tidak perlu menentukan subdomainnya (misalnya, subdomain.examplepetstore.com). Perubahan pada daftar domain dapat memerlukan waktu hingga 30 menit untuk diterapkan.

      Untuk menggunakan kunci di lebih dari 250 domain, klik tombol Nonaktifkan verifikasi domain. Google Cloud Fraud Defense kemudian akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname di penilaian yang Anda buat.

9. Bergantung pada jenis kunci reCAPTCHA yang ingin Anda buat untuk situs Anda, lakukan tindakan yang sesuai:

Membuat kunci reCAPTCHA berbasis skor

Catatan: Membuat kunci berbasis skor adalah opsi default di konsol Google Cloud .

1. Jika Anda ingin mengizinkan kunci berbasis skor berfungsi dengan Accelerated Mobile Pages (AMP) menggunakan komponen amp-recaptcha-input, aktifkan tombol Izinkan kunci ini berfungsi dengan halaman AMP.

2. Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang Anda inginkan untuk ditampilkan oleh kunci saat penilaian dibuat untuknya, lakukan hal berikut:

   1. Klik Langkah Berikutnya (opsional)
   2. Pada langkah Setelan tambahan, klik tombol Apakah Anda membuat kunci ini hanya untuk tujuan pengujian?.
   3. Gunakan penggeser Set score untuk menentukan skor antara 0 hingga 1,0.
3. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.

Membuat kunci reCAPTCHA kotak centang

Sebaiknya jangan gunakan kunci kotak centang karena akan meningkatkan friksi pengguna dan tidak meningkatkan akurasi secara signifikan.

1. Klik Langkah Berikutnya (opsional).
2. Pada langkah Setelan tambahan, aktifkan Will you use challenges? tombol.
3. Pilih opsi Keamanan verifikasi yang sesuai.

   Opsi keamanan verifikasi mengontrol kemungkinan pengguna diminta untuk melakukan verifikasi sekunder, yaitu pengguna diminta untuk memilih gambar berdasarkan kategori yang diidentifikasi (misalnya, pilih gambar yang berisi sepeda motor atau tangga).

   Jika Anda ingin memastikan perlindungan antipenipuan terbaik, pilih Ketat.

   Jika Anda memilih Mudah, pengguna cenderung tidak akan diminta untuk menyelesaikan tantangan visual.

4. Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang Anda inginkan untuk ditampilkan oleh kunci saat penilaian dibuat untuknya, lakukan hal berikut:

   1. Klik tombol Are you creating this key for testing purposes only?.
   2. Gunakan penggeser Set score untuk menentukan skor antara 0 hingga 1,0.
   3. Pilih opsi Jenis verifikasi yang sesuai.
      • Otomatis terkadang memunculkan tantangan.
      • Tanpa CAPTCHA tidak menampilkan verifikasi.
      • Tantangan yang tidak dapat diselesaikan menampilkan gambar, tetapi tantangan tidak lulus.
   4. Klik Create key.

   Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.

Membuat kunci reCAPTCHA verifikasi berbasis kebijakan

1. Klik Langkah Berikutnya (opsional).
2. Pada langkah Setelan tambahan, aktifkan Will you use challenges? tombol.
3. Pilih opsi Keamanan verifikasi yang sesuai.

   Opsi keamanan verifikasi menentukan kompleksitas dan frekuensi verifikasi CAPTCHA yang ditampilkan kepada pengguna.

   Jika Anda ingin memastikan perlindungan antipenipuan terbaik, pilih Ketat.

   Jika Anda memilih Mudah, pengguna cenderung tidak akan diminta untuk menyelesaikan tantangan CAPTCHA yang lebih sedikit dan tidak terlalu rumit.

4. Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang akan ditampilkan kunci saat penilaian dibuat untuknya, lakukan hal berikut:

   1. Klik tombol Are you creating this key for testing purposes only?.
   2. Gunakan penggeser Set score untuk menentukan skor antara 0 hingga 1,0.
5. Pilih nilai minimum skor untuk memicu verifikasi CAPTCHA, yang berlaku untuk semua tindakan.
6. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.

Konsol Admin

1. Buka konsol Admin Google Cloud Fraud Defense.

   Buka konsol admin Fraud Defense

2. Di kolom Label, masukkan nama yang dapat Anda gunakan untuk mengidentifikasi situs Anda.
3. Jika Anda ingin membuat kunci berbasis skor, pilih Berbasis skor (v3). Jika Anda ingin membuat kunci kotak centang, pilih Tantangan (v2).
4. Untuk menambahkan domain, masukkan nama domain Anda, lalu klik .

   Untuk menambahkan domain lain, Anda dapat mengulangi langkah ini. Anda dapat menambahkan hingga maksimum 250 domain.

5. Jika Anda baru menggunakan konsol Google Cloud , baca persyaratan layanan, lalu centang kotak.
6. Klik Kirim.

Jika Anda baru menggunakan konsol Google Cloud , project Google Cloud akan dibuat dan API yang diperlukan akan diaktifkan agar Anda dapat memulai. Jika Anda sudah memiliki project Google Cloud , API yang diperlukan akan diaktifkan untuk project Anda agar dapat memulai.

gcloud

Untuk membuat kunci reCAPTCHA, gunakan perintah gcloud recaptcha keys create.

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

• INTEGRATION_TYPE: Jenis integrasi. Bergantung pada jenis kunci, tentukan nilai berikut:
  • score untuk kunci berbasis skor.
  • checkbox untuk kunci kotak centang.
  • policy-based-challenge untuk kunci tantangan berbasis kebijakan.
  Catatan: Sebaiknya jangan gunakan CHECKBOX karena akan meningkatkan friksi pengguna dan tidak meningkatkan akurasi secara signifikan. Untuk mengetahui informasi selengkapnya, lihat FAQ.
• DISPLAY_NAME: Nama untuk kunci. Biasanya nama situs.
• DOMAIN_NAME: Domain atau subdomain situs yang diizinkan menggunakan kunci.

  Tentukan beberapa domain sebagai daftar yang dipisahkan koma.

  Untuk menggunakan kunci di lebih dari 250 domain, tentukan --allow-all-domains untuk menonaktifkan verifikasi domain. Google Cloud Fraud Defense kemudian akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname di penilaian yang Anda buat.

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

  Catatan: Kunci reCAPTCHA bersifat unik untuk domain dan subdomain yang Anda tentukan. Anda dapat menentukan lebih dari satu domain jika menayangkan situs dari beberapa domain. Jika Anda menentukan domain (misalnya, examplepetstore.com), Anda tidak perlu menentukan subdomainnya (misalnya, subdomain.examplepetstore.com). Perubahan pada daftar domain dapat memerlukan waktu hingga 30 menit untuk diterapkan.
• DEFAULT_SCORE_THRESHOLD: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan nilai minimum verifikasi universal untuk kunci tersebut jika nilai minimum skor kustom tidak ditentukan.
• ACTION_SCORE_THRESHOLDS: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan tindakan dan skor nilai minimum yang sesuai antara 0,0 dan 1,0. Contoh, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'.
  Catatan: Hanya skor akhir yang dihitung setelah tantangan apa pun yang ditampilkan dalam penilaian. Skor awal yang dihitung oleh Fraud Defense dibandingkan dengan nilai minimum.

Jalankan perintah gcloud recaptcha keys create:

Linux, macOS, atau Cloud Shell

gcloud recaptcha keys create \
        --web \
        --display-name=DISPLAY_NAME  \
        --integration-type=INTEGRATION_TYPE \
        --domains=DOMAIN_NAME \

Windows (PowerShell)

gcloud recaptcha keys create `
        --web `
        --display-name=DISPLAY_NAME  `
        --integration-type=INTEGRATION_TYPE `
        --domains=DOMAIN_NAME `

Windows (cmd.exe)

gcloud recaptcha keys create ^
        --web ^
        --display-name=DISPLAY_NAME  ^
        --integration-type=INTEGRATION_TYPE ^
        --domains=DOMAIN_NAME ^

Respons berisi kunci reCAPTCHA yang baru dibuat.

REST

Untuk mengetahui informasi referensi API tentang jenis kunci dan jenis integrasi, lihat Kunci dan Jenis integrasi.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• INTEGRATION_TYPE: Jenis integrasi. Bergantung pada jenis kunci, tentukan nilai berikut:
  • SCORE untuk kunci berbasis skor.
  • CHECKBOX untuk kunci kotak centang.
  • POLICY_BASED_CHALLENGE untuk kunci tantangan berbasis kebijakan.
  Catatan: Sebaiknya jangan gunakan CHECKBOX karena akan meningkatkan friksi pengguna dan tidak meningkatkan akurasi secara signifikan. Untuk mengetahui informasi selengkapnya, lihat FAQ.
• DISPLAY_NAME: Nama untuk kunci. Biasanya nama situs.
• DOMAIN_NAME: Domain atau subdomain situs yang diizinkan menggunakan kunci.

  Tentukan beberapa domain sebagai daftar yang dipisahkan koma.

  Untuk menggunakan kunci di lebih dari 250 domain, tentukan --allow-all-domains untuk menonaktifkan verifikasi domain. Google Cloud Fraud Defense kemudian akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname di penilaian yang Anda buat.

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

  Catatan: Kunci reCAPTCHA bersifat unik untuk domain dan subdomain yang Anda tentukan. Anda dapat menentukan lebih dari satu domain jika menayangkan situs dari beberapa domain. Jika Anda menentukan domain (misalnya, examplepetstore.com), Anda tidak perlu menentukan subdomainnya (misalnya, subdomain.examplepetstore.com). Perubahan pada daftar domain dapat memerlukan waktu hingga 30 menit untuk diterapkan.
• DEFAULT_SCORE_THRESHOLD: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan nilai minimum verifikasi universal untuk kunci tersebut jika nilai minimum skor kustom tidak ditentukan.
• ACTION_SCORE_THRESHOLDS: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan tindakan dan skor nilai minimum yang sesuai antara 0,0 dan 1,0. Contoh, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'.
  Catatan: Hanya skor akhir yang dihitung setelah tantangan apa pun yang ditampilkan dalam penilaian. Skor awal yang dihitung oleh Fraud Defense dibandingkan dengan nilai minimum.
• DEFAULT_SCORE_THRESHOLD: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan nilai minimum verifikasi universal untuk kunci tersebut jika nilai minimum skor kustom tidak ditentukan. Fitur ini berada dalam pratinjau.
• ACTION_SCORE_THRESHOLDS: Untuk kunci verifikasi berbasis kebijakan, parameter ini menentukan tindakan dan skor nilai minimum yang sesuai antara 0,0 dan 1,0. Contoh, login='{"scoreThreshold": "0.3"}',signup='{"scoreThreshold": "0.1"}'. Fitur ini berada dalam pratinjau.
  Catatan: Hanya skor akhir yang dihitung setelah tantangan apa pun yang ditampilkan dalam penilaian. Skor awal yang dihitung oleh reCAPTCHA dibandingkan dengan nilai minimum.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowedDomains": "DOMAINS",
    "integrationType": "INTEGRATION_TYPE"
  }
}

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"

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" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
  "displayName": "DISPLAY_NAME",
  "webSettings": {
    "allowAllDomains": false,
    "allowedDomains": [
      DOMAINS
    ],
    "allowAmpTraffic": false,
    "integrationType": "SCORE",
    "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
  }
}

Catatan: Setelah membuat kunci reCAPTCHA, Anda dapat mengedit atau menghapusnya. Anda tidak dapat memulihkan kunci yang dihapus. Selain itu, Anda tidak dapat memigrasikan kunci reCAPTCHA dari satu project Google Cloud ke project lainnya.

(Opsional) Menemukan kunci rahasia reCAPTCHA lama

Jika Anda ingin berintegrasi dengan aplikasi pihak ketiga atau plugin sistem pengelolaan konten (CMS) (seperti WordPress atau Shopify) yang tidak menggunakan API reCAPTCHA Enterprise, Anda memerlukan kunci yang cocok dengan versi yang didukung oleh plugin (v2 atau v3) dan kunci rahasia lama kunci tersebut. Untuk mengetahui informasi selengkapnya tentang cara memeriksa versi kunci dan mengonfigurasi plugin CMS, lihat Menyesuaikan Konsol Admin dan terminologi konsol Google Cloud .

Untuk setiap kunci situs yang Anda buat, reCAPTCHA akan membuat kunci rahasia reCAPTCHA lama (kunci rahasia lama), yang dapat Anda gunakan dengan aplikasi pihak ketiga.

Catatan: Aplikasi atau plugin pihak ketiga sering menyebut kunci rahasia lama ini sebagai kunci pribadi atau kunci rahasia.

Jika Anda memerlukan kunci rahasia untuk kunci reCAPTCHA Classic, migrasikan kunci ke reCAPTCHA di Google Cloud dan temukan kunci rahasia lama.

Catatan: Sebaiknya jangan gunakan kunci rahasia lama di frontend Anda karena kunci tersebut akan terlihat oleh pengguna dan penyerang dapat menyalahgunakan aplikasi Anda.

Untuk menemukan kunci rahasia lama, lakukan tindakan berikut:

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

   Buka Fraud Defense

2. Pilih tab Keys.

3. Di bagian reCAPTCHA Keys, temukan kunci reCAPTCHA yang Anda buat, lalu klik kunci tersebut.

   

4. Di halaman Key details, buka tab Integration, lalu klik Use legacy key atau Integrate with a third-party service or plugin. Dialog akan terbuka dengan kunci rahasia lama Anda.

   

Langkah berikutnya

• Menyesuaikan terminologi Konsol Admin dan konsol Google Cloud .
• Instal kunci berbasis skor di halaman web Anda.
• Instal kunci kotak centang di halaman web Anda.
• Instal kunci verifikasi berbasis kebijakan di halaman web Anda.