Menginstal kunci tantangan berbasis kebijakan di situs

Halaman ini menjelaskan cara menginstal kunci tantangan berbasis kebijakan di situs Anda. Dengan kunci tantangan berbasis kebijakan, reCAPTCHA dapat memicu tantangan CAPTCHA secara deterministik berdasarkan nilai minimum dan tingkat kesulitan tantangan.

Sebelum memulai

  1. Siapkan lingkungan Anda untuk reCAPTCHA.

  2. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

    reCAPTCHA memerlukan penagihan untuk ditautkan dan diaktifkan di project agar dapat menggunakan kunci tantangan berbasis kebijakan. Anda dapat mengaktifkan penagihan menggunakan kartu kredit atau ID penagihan project yang ada Google Cloud . Jika Anda memerlukan bantuan terkait penagihan, hubungi dukungan Penagihan Cloud.

  3. Buat kunci tantangan berbasis kebijakan.

    Atau, Anda dapat menyalin ID kunci tantangan berbasis kebijakan yang ada dengan melakukan salah satu langkah berikut:

    • Untuk menyalin ID kunci yang ada dari Google Cloud konsol, lakukan langkah-langkah berikut:

      1. Buka halaman reCAPTCHA.

        Buka reCAPTCHA

      2. Dalam daftar kunci reCAPTCHA, arahkan kursor ke kunci yang ingin Anda salin, lalu klik .
    • Untuk menyalin ID kunci yang ada menggunakan REST API, gunakan metode projects.keys.list.
    • Untuk menyalin ID kunci yang ada menggunakan gcloud CLI, gunakan perintah gcloud recaptcha keys list.

Mengonfigurasi kunci tantangan berbasis kebijakan

Untuk kunci tantangan berbasis kebijakan, Anda harus menentukan tingkat kesulitan tantangan yang menentukan kompleksitas dan frekuensi tantangan CAPTCHA, serta menentukan nilai minimum kustom untuk tindakan tertentu yang mengganti nilai minimum default.

  1. Di Google Cloud konsol, buka halaman reCAPTCHA.

    Buka reCAPTCHA

    Halaman reCAPTCHA memiliki dua tampilan: Tabel dan Kartu. Jika project Anda memiliki banyak kunci reCAPTCHA, hanya tampilan Tabel yang tersedia.

  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. Di bagian Kunci reCAPTCHA, temukan kunci tantangan berbasis kebijakan yang ingin Anda konfigurasi, lalu klik kunci tersebut.

  4. Di halaman Detail kunci, klik tab Ringkasan.

  5. Di bagian Konfigurasi, klik Konfigurasi untuk Setelan tantangan.

  6. Di halaman Konfigurasi setelan tantangan, pilih tingkat kesulitan tantangan.

  7. Untuk memicu tantangan CAPTCHA, gunakan penggeser untuk menentukan nilai minimum default.

    Nilai minimum default 0.0 tidak memicu tantangan apa pun. Nilai minimum dari 1.0 memicu tantangan untuk setiap permintaan.

  8. Untuk mengonfigurasi nilai minimum kustom untuk setiap tindakan, yang mengganti nilai minimum default, lakukan langkah-langkah berikut:

    1. Masukkan nama tindakan.

    2. Untuk menentukan nilai minimum kustom, gunakan penggeser Tetapkan nilai minimum tindakan.

    3. Klik Selesai.

  9. Klik Simpan.

Menambahkan reCAPTCHA pada tombol HTML

  1. Untuk memuat reCAPTCHA di halaman web Anda, tambahkan JavaScript API dengan kunci tantangan berbasis kebijakan dalam elemen <head></head> halaman web Anda.

        <head>
    <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
    ....
    </head>

    reCAPTCHA menggunakan bahasa browser secara default. Jika Anda ingin menentukan bahasa lain, gunakan atribut hl=LANG dalam skrip Anda. Misalnya, untuk menggunakan bahasa Prancis, tentukan hal berikut: <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. Untuk mempelajari bahasa yang didukung, lihat kode bahasa untuk reCAPTCHA.

  2. Untuk menambahkan reCAPTCHA pada tombol HTML, lakukan langkah-langkah berikut:

    1. Tentukan fungsi callback untuk menangani token.

      <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   } // Use `requestSubmit()` for extra features like browser input validation.
</script>

      Untuk mengetahui informasi selengkapnya, lihat metode requestSubmit().

    2. Tambahkan atribut ke tombol HTML Anda.

      <button class="g-recaptcha"
data-sitekey="KEY_ID"
data-callback="onSubmit"
data-action="submit">Submit</button>

      Jika Anda ingin menentukan lokasi untuk badge, gunakan data-badge=LOCATION atribut pada elemen yang memiliki class=g-recaptcha. Secara default, lokasi ditetapkan ke bottomright. Nilai lain yang mungkin adalah inline dan bottomleft.

    3. Saat tombol ini digunakan untuk mengirimkan formulir di situs Anda, parameter POST g-recaptcha-response akan berisi token respons.

  3. Setelah token dibuat, kirim token reCAPTCHA ke backend Anda dan buat penilaian dalam waktu dua menit.

Langkah berikutnya