Membuat kunci reCAPTCHA untuk situs

Konsol Admin

1. Buka konsol Admin reCAPTCHA.

   Buka konsol admin reCAPTCHA

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 Challenge (v2).
4. Untuk menambahkan domain, masukkan nama domain Anda, lalu klik add .

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

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

Cloud Console

1. Di konsol Google Cloud , buka halaman reCAPTCHA.

   Buka reCAPTCHA

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

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

3. Klik Create key.
4. Di kolom Nama tampilan, masukkan nama tampilan untuk kunci.
5. Untuk Jenis aplikasi, pilih Web.

   Bagian Domain list akan muncul.

6. 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 lain, klik Tambahkan domain, lalu 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 Anda menayangkan situs dari beberapa domain. Jika Anda menentukan domain (misalnya, examplepetstore.com), Anda tidak perlu menentukan subdomainnya (misalnya, subdomain.examplepetstore.com).

      Untuk menggunakan kunci di lebih dari 250 domain, klik tombol Nonaktifkan verifikasi domain. Kemudian, reCAPTCHA akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname dalam penilaian yang Anda buat.

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

Membuat kunci reCAPTCHA berbasis skor

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

2. Jika Anda ingin mengizinkan kunci berbasis skor agar berfungsi dengan Accelerated Mobile Pages (AMP), aktifkan tombol Izinkan kunci ini agar berfungsi dengan halaman AMP.

3. Untuk lingkungan nonproduksi, jika Anda ingin menentukan skor yang ingin ditampilkan oleh kunci saat penilaian dibuat untuk lingkungan tersebut, 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 Tetapkan skor untuk menentukan skor antara 0 hingga 1,0.
4. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman kunci reCAPTCHA.

Membuat kunci reCAPTCHA kotak centang

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

2. Klik Langkah Berikutnya (opsional).
3. Pada langkah Setelan tambahan, aktifkan Apakah Anda akan menggunakan tantangan? beralih.
4. Pilih opsi Keamanan verifikasi yang sesuai.

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

   Jika Anda ingin memastikan perlindungan anti-penipuan terbaik, pilih Ketat.

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

5. Untuk lingkungan nonproduksi, jika Anda ingin menentukan skor yang ingin ditampilkan oleh kunci saat penilaian dibuat untuk lingkungan tersebut, lakukan hal berikut:

   1. Klik tombol Apakah Anda membuat kunci ini hanya untuk tujuan pengujian?.
   2. Gunakan penggeser Tetapkan skor untuk menentukan skor antara 0 hingga 1,0.
   3. Pilih opsi Jenis tantangan yang sesuai.
      • Auto terkadang memunculkan tantangan.
      • Tanpa CAPTCHA tidak menampilkan verifikasi.
      • Tantangan yang tidak dapat diselesaikan menampilkan gambar, tetapi tantangan tidak berhasil dilewati.
   4. Klik Create key.

   Kunci yang baru dibuat akan tercantum di halaman kunci reCAPTCHA.

gcloud

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

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

• DISPLAY_NAME: Nama untuk kunci. Biasanya nama situs.
• INTEGRATION_TYPE: Jenis integrasi. Bergantung pada jenis kunci, tentukan nilai berikut:
  • score untuk kunci berbasis skor.
  • checkbox untuk kunci kotak centang.
• 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. Kemudian, reCAPTCHA akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname dalam 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.

Jalankan perintah gcloud recaptcha keys create:

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

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

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

Respons berisi kunci reCAPTCHA yang baru dibuat.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• DISPLAY_NAME: Nama untuk kunci. Biasanya nama situs.
• INTEGRATION_TYPE: Jenis integrasi. Bergantung pada jenis kunci, tentukan nilai berikut:
  • score untuk kunci berbasis skor.
  • checkbox untuk kunci kotak centang.
• 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. Kemudian, reCAPTCHA akan mengabaikan daftar domain. Anda harus melakukan verifikasi domain sendiri dengan memeriksa kolom tokenProperties.hostname dalam 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.

Metode HTTP dan URL:

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

Isi JSON permintaan:

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

Untuk mengirim permintaan Anda, pilih salah satu opsi 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"

$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"
  }
}