Halaman ini diterjemahkan oleh Cloud Translation API.

Pertanyaan Umum (FAQ)

Haruskah saya menggunakan reCAPTCHA Enterprise?

reCAPTCHA Enterprise menawarkan 1 juta penilaian per bulan untuk fitur tambahan dan gratis. Fitur lainnya seperti analisis real-time memberikan tempat terbaik untuk memulai bagi sebagian besar developer. Mulai di sini secara gratis.

Dapatkah saya menggunakan reCAPTCHA dengan solusi pihak ketiga?

Ya, Anda dapat menggunakan reCAPTCHA (versi non-Enterprise) dan reCAPTCHA Enterprise. Biasanya, solusi pihak ketiga meminta kunci publik Anda dan kunci rahasia atau kunci API Anda. Pastikan Anda hanya memberikan kunci rahasia dan kunci API kepada pihak ketiga yang tepercaya.

Bagaimana cara melakukan migrasi ke reCAPTCHA Enterprise dari v2 atau v3?

Proses migrasi membutuhkan waktu 5-10 menit untuk diselesaikan dan tidak memerlukan perubahan kode.

Haruskah saya menggunakan reCAPTCHA v2 atau v3?

reCAPTCHA v3 ditujukan bagi pemilik situs yang menginginkan lebih banyak data tentang traffic mereka. Untuk informasi selengkapnya, lihat panduan developer reCAPTCHA v3.

Kami mendukung keamanan dan kegunaan untuk v2.

Untuk informasi lebih lanjut tentang perbedaan reCAPTCHA v2 dan v3, lihat perbandingan versi.

Dapatkah saya menjalankan reCAPTCHA v2 dan v3 di halaman yang sama?

Untuk melakukannya, muat kunci situs v3 sebagai didokumentasikan, lalu render secara eksplisit v2 menggunakan grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

Apakah reCAPTCHA menggunakan cookie?

reCAPTCHA menetapkan cookie yang diperlukan (_GRECAPTCHA) saat dijalankan dengan tujuan memberikan analisis risikonya. Jika Anda memilih untuk tidak menggunakan domain www.google.com yang mungkin menggunakan cookie lain, Anda dapat menggunakan www.recaptcha.net.

Apakah ada QPS atau batas harian terkait penggunaan reCAPTCHA saya?

Jika ingin melakukan lebih dari 1.000 panggilan per detik atau 1.000.000 panggilan per bulan, Anda harus menggunakan reCAPTCHA Enterprise atau mengisi formulir ini dan menunggu persetujuan pengecualian. Jika kunci situs melebihi 1000 QPS, beberapa permintaan mungkin tidak akan diproses. Jika kunci situs v3 melebihi kuota bulanannya, maka site_verify mungkin gagal dibuka dengan menampilkan skor statis 0,9 dan pesan error `"Melebihi kuota gratis".` untuk sisa bulan tersebut. Tidak ada indikasi yang terlihat oleh pengguna saat situs v3 melebihi kuota. Jika kunci situs v2 melebihi kuota bulanannya, pesan berikut atau pesan serupa dapat ditampilkan kepada pengguna di widget reCAPTCHA untuk sisa bulan tersebut: `Situs ini melebihi kuota reCAPTCHA.` Sebelum kuota diterapkan, pemilik situs akan diberi tahu melalui email tiga kali dan diberi setidaknya 90 hari untuk bermigrasi ke reCAPTCHA Enterprise. Kunci situs dianggap melebihi kuota jika digunakan lebih dari 1000.000 panggilan per bulan untuk domain apa pun. Hal ini termasuk jika volume ini tersebar di beberapa kunci pada domain yang sama.

Saya ingin menyembunyikan badge reCAPTCHA. Apa yang diizinkan?

Anda diizinkan untuk menyembunyikan badge selama Anda menyertakan branding reCAPTCHA yang terlihat di alur pengguna. Harap sertakan teks berikut:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Contoh:

Catatan: jika Anda memilih untuk menyembunyikan badge, gunakan

.grecaptcha-badge { visibility: hidden; }

Saya ingin menjalankan pengujian otomatis dengan reCAPTCHA. Apa yang harus saya lakukan?

Untuk reCAPTCHA v3, buat kunci terpisah untuk lingkungan pengujian. Skor mungkin tidak akurat karena reCAPTCHA v3 bergantung pada penayangan traffic yang sebenarnya.

Untuk reCAPTCHA v2, gunakan kunci pengujian berikut. Anda akan selalu mendapatkan No CAPTCHA dan semua permintaan verifikasi akan diteruskan.

Kunci situs: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
Kunci rahasia: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Widget reCAPTCHA akan menampilkan pesan peringatan untuk memastikan widget tersebut tidak digunakan untuk traffic produksi.

Bagaimana cara melihat lebih banyak traffic situs saya?

reCAPTCHA melaporkan statistik harian di konsol admin.

Dapatkah saya menggunakan reCAPTCHA secara global?

Ya, gunakan "www.recaptcha.net" pada kode Anda jika "www.google.com" tidak dapat diakses.

Pertama, ganti <script src="https://www.google.com/recaptcha/api.js" async redirect></script> dengan <script src="https://www.recaptcha.net/recaptcha/api.js" async redirect></script>
Setelah itu, terapkan hal yang sama ke tempat lain yang menggunakan "www.google.com/recaptcha/" di situs Anda.

Dapatkah saya menyesuaikan widget atau badge reCAPTCHA?

Ya. reCAPTCHA menawarkan dua tema, terang dan gelap, seperti yang ditunjukkan di bawah ini. Untuk memilih tema, cukup tetapkan atribut tema data di parameter grecaptcha.render.

Tema terang:

Tema gelap:

Bagaimana cara menyesuaikan reCAPTCHA v3?

JavaScript API yang tersedia untuk reCAPTCHA Tidak Terlihat juga berfungsi untuk v3. Cukup gunakan JavaScript API untuk merender reCAPTCHA secara eksplisit dengan kunci situs v3 untuk mengakses opsi seperti mengubah posisi badge atau mengubah tema.

Saat merender reCAPTCHA v3 dengan metode ini, jangan lupa menyetel parameter size ke 'invisible' dan gunakan client ID yang ditampilkan oleh grecaptcha.render saat memanggil grecaptcha.execute, bukan kunci situs.

Baru-baru ini, widget reCAPTCHA saya mulai menampilkan "Kunci situs tidak valid". Apa yang terjadi???

Jika Anda melihat error ini, berarti kunci situs reCAPTCHA Anda tidak lagi valid. Untuk mengaktifkannya, daftarkan kunci baru dan ikuti petunjuk di halaman tersebut.

Saya mendapatkan SecurityError yang tidak tertangkap: memblokir frame dengan asal "https://www.google.com" agar tidak mengakses frame dengan asal "&ltdomain Anda&gt". Apa yang harus saya lakukan?

Hal ini biasanya terjadi jika elemen HTML widget reCAPTCHA dihapus secara terprogram setelah pengguna akhir mengklik kotak centang. Sebaiknya gunakan fungsi JavaScript grecaptcha.reset() untuk mereset widget reCAPTCHA.

Saya menggunakan Kebijakan Keamanan Konten (CSP) di situs saya. Bagaimana cara mengonfigurasinya agar berfungsi dengan reCAPTCHA?

Sebaiknya gunakan pendekatan berbasis nonce yang didokumentasikan dengan CSP3. Pastikan Anda menyertakan nonce di tag skrip api.js reCAPTCHA, dan kami akan menangani sisanya.

Catatan: reCAPTCHA juga dapat digunakan dengan 'strict-dynamic' di browser yang mendukungnya.

Atau, tambahkan nilai berikut ke perintah:

script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/

Saya mendapatkan pesan error "Localhost tidak ada dalam daftar domain yang didukung". Apa yang harus saya lakukan?

Domain localhost tidak didukung secara default. Jika ingin terus mendukungnya untuk pengembangan, Anda dapat menambahkannya ke daftar domain yang didukung untuk kunci situs Anda. Buka konsol reCAPTCHA Enterprise atau konsol reCAPTCHA, jika perlu, untuk memperbarui daftar domain yang didukung. Sebaiknya gunakan kunci terpisah untuk pengembangan dan produksi, serta hanya izinkan localhost pada kunci situs pengembangan Anda.

Hanya di iOS 10, halaman akan di-scroll ke bawah saat pengguna menyelesaikan tantangan?

Ini adalah bug pemfokusan di sisi Apple yang telah kami laporkan. Perubahan ini hanya memengaruhi pengguna di iOS 10 dan hanya di beberapa situs. Jika Anda terpengaruh, solusinya adalah memindahkan widget reCAPTCHA ke lebih tinggi atau lebih rendah di halaman, atau menggunakan reCAPTCHA v3.

Komputer atau jaringan saya mungkin mengirimkan kueri otomatis?

Jika diarahkan ke halaman ini dari widget reCAPTCHA, Anda akan melihat pesan yang menyatakan "Maaf, tetapi komputer atau jaringan Anda mungkin mengirimkan kueri otomatis. Untuk melindungi pengguna, kami tidak dapat memproses permintaan Anda saat ini."

Sayangnya, hal ini dapat terjadi pada pengguna yang baik karena beberapa alasan:

Anda mungkin berada di jaringan bersama yang digunakan secara penyalahgunaan
Internet Service Provider Anda mungkin telah menetapkan alamat IP yang mencurigakan kepada Anda baru-baru ini
Situs yang akan Anda akses mungkin sedang mengalami serangan berat

Untuk memecahkan masalah ini, lihat halaman bantuan traffic tidak biasa, atau coba lagi nanti.

Nama tindakan apa yang valid?

Tindakan hanya boleh berisi karakter alfanumerik, garis miring, dan garis bawah. Tindakan tidak boleh spesifik per pengguna.