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 Google Cloud Fraud Defense.

  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 hal berikut:

      1. Buka halaman Google Cloud Fraud Defense.

        Buka Google Cloud Fraud Defense

      2. Pilih tab Keys.
      3. Di daftar kunci reCAPTCHA, temukan 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

  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. Pilih tab Keys.

    Tab Keys memiliki dua tampilan: Table dan Cards. Jika project Anda memiliki banyak kunci reCAPTCHA, hanya tampilan Table yang tersedia.

  4. Di bagian reCAPTCHA keys, temukan kunci tantangan berbasis kebijakan yang ingin Anda konfigurasi, lalu klik kunci tersebut.

  5. Di halaman Key details, klik tab Overview.

  6. Di bagian Configuration, klik Configure untuk Challenge settings.

  7. Di halaman Configure challenge settings, pilih tingkat kesulitan tantangan.

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

  9. Untuk mengonfigurasi nilai minimum kustom untuk setiap tindakan, yang mengganti nilai minimum default, lakukan hal berikut:

    1. Masukkan nama tindakan.

    2. Untuk menentukan nilai minimum kustom, gunakan penggeser Set action threshold.

    3. Klik Done.

  10. Klik Save.

Menambahkan reCAPTCHA pada tombol HTML

  1. Untuk memuat reCAPTCHA di halaman web Anda, tambahkan JavaScript API dengan kunci tantangan berbasis kebijakan Anda 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 hal 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