Pertanyaan Umum (FAQ)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
-
Haruskah saya menggunakan reCAPTCHA Enterprise?
-
reCAPTCHA Enterprise menawarkan hingga 10.000 penilaian per bulan tanpa biaya
dan juga menyediakan fitur tambahan.
Fitur lainnya
seperti analisis real time merupakan tempat terbaik untuk memulai bagi sebagian besar developer.
Mulai di sini.
-
Dapatkah saya menggunakan reCAPTCHA dengan solusi pihak ketiga?
-
Ya, Anda dapat menggunakan reCAPTCHA (versi non-Enterprise) dan reCAPTCHA
Perusahaan. 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 bermigrasi ke reCAPTCHA Enterprise dari v2 atau v3?
-
proses migrasi
memerlukan waktu 5-10 menit untuk diselesaikan dan tidak memerlukan perubahan kode.
-
Haruskah saya menggunakan reCAPTCHA v2 atau v3?
-
reCAPTCHA v3 ditujukan untuk 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 mengetahui informasi selengkapnya tentang perbedaan reCAPTCHA v2 dan v3, lihat perbandingan versi.
-
Apakah reCAPTCHA menggunakan cookie?
-
reCAPTCHA menetapkan cookie yang diperlukan (_GRECAPTCHA) saat dijalankan untuk tujuan memberikan analisis risikonya.
Jika Anda memilih untuk tidak menggunakan domain www.google.com yang dapat menetapkan cookie lainnya, Anda dapat menggunakan www.recaptcha.net sebagai gantinya.
-
Apakah ada batas QPS atau batas harian untuk penggunaan reCAPTCHA saya?
-
Jika Anda ingin melakukan lebih dari 1000 panggilan per detik atau 1000000 panggilan per bulan, Anda harus menggunakan
reCAPTCHA Enterprise atau isi
formulir ini dan tunggu persetujuan pengecualian.
Jika kunci situs melebihi 1.000 QPS, beberapa permintaan mungkin tidak akan diproses.
Jika kunci situs v3 melebihi kuota bulanannya, site_verify mungkin gagal dibuka
dengan menampilkan skor statis 0,9 dan pesan error `"Over free quota."`
untuk sisa bulan ini. Tidak ada indikasi yang
terlihat oleh pengguna ketika
Situs v3 melebihi kuota.
Jika kunci situs v2 melebihi kuota bulanannya, maka kunci situs berikut atau yang serupa
pesan dapat ditampilkan kepada pengguna di widget reCAPTCHA untuk sisanya
bulan ini: `Situs ini melebihi kuota reCAPTCHA.`
Sebelum kuota diberlakukan, pemilik situs akan diberi tahu melalui email sebanyak tiga kali
dan diberi waktu minimal 90 hari untuk bermigrasi ke reCAPTCHA Enterprise.
Kunci situs dianggap melebihi kuota jika lebih dari 1000.000 panggilan per bulan
digunakan untuk domain apa pun. Hal ini termasuk jika volume ini tersebar di beberapa
domain yang sama.
-
Saya ingin menyembunyikan badge reCAPTCHA. Apa yang diizinkan?
-
Anda diizinkan untuk menyembunyikan badge selama Anda menyertakan branding reCAPTCHA secara jelas dalam alur penggunaan. 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 traffic yang sebenarnya.
Untuk reCAPTCHA v2, gunakan kunci uji berikut. Anda akan selalu mendapatkan Tidak Ada CAPTCHA dan semua permintaan verifikasi akan lulus.
- Kunci situs: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- Kunci rahasia: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
Widget reCAPTCHA akan menampilkan pesan peringatan guna memastikan bahwa widget tersebut tidak digunakan untuk traffic produksi.
-
Bagaimana cara menghindari penggunaan kode reCAPTCHA saat men-debug situs saya?
-
Untuk menghindari masuk ke kode reCAPTCHA saat men-debug JavaScript lain di situs Anda, tambahkan skrip reCAPTCHA /recaptcha__.+\.js$ ke daftar yang diabaikan di browser Anda. Guna mengetahui petunjuk untuk Chrome, lihat Mengabaikan daftar skrip kustom. Fitur serupa tersedia di browser lain.
-
Bagaimana cara mengetahui informasi selengkapnya tentang traffic situs saya?
-
reCAPTCHA melaporkan statistik harian di konsol admin.
-
Dapatkah saya menggunakan reCAPTCHA secara global?
-
Ya, gunakan "www.recaptcha.net" dalam kode Anda ketika "www.google.com" tidak dapat diakses.
- Pertama, ganti <script src="https://www.google.com/recaptcha/api.js"></script> dengan <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
- Setelah itu, terapkan hal yang sama ke tempat lain yang menggunakan "www.google.com/recaptcha/" di situs Anda.
-
-
Ya. reCAPTCHA menawarkan dua tema, terang dan gelap, seperti yang ditunjukkan di bawah ini. Untuk memilih tema, cukup
menetapkan atribut tema data di kolom grecaptcha.render
parameter.
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 berbagai opsi seperti mengubah posisi badge atau mengubah tema.
Saat merender reCAPTCHA v3 dengan metode ini, jangan lupa menetapkan parameter size ke 'invisible' dan menggunakan client ID yang ditampilkan oleh grecaptcha.render saat memanggil grecaptcha.execute, bukan kunci situs.
-
-
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 origin "https://www.google.com" agar tidak mengakses frame dengan origin "<your domain>". 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 untuk menyertakan nonce di tag skrip api.js reCAPTCHA, dan kami akan menangani sisanya.
Catatan: reCAPTCHA juga berfungsi 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 menerima pesan error "Localhost tidak ada dalam daftar domain yang didukung". Apa yang harus saya lakukan?
-
domain {i>localhost<i} tidak didukung secara default. Jika Anda ingin terus mendukung mereka untuk
Anda dapat menambahkannya ke daftar domain yang didukung untuk kunci situs Anda. Buka halaman
Konsol reCAPTCHA Enterprise
atau ke konsol reCAPTCHA yang sesuai,
untuk memperbarui daftar domain yang didukung. Sebaiknya gunakan kunci terpisah untuk pengembangan dan
produksi, dan hanya mengizinkan {i>
localhost<i} di kunci situs pengembangan Anda.
-
Hanya di iOS 10, halaman akan di-scroll ke bawah ketika pengguna menyelesaikan tantangan?
-
Ini adalah bug yang berfokus pada pihak Apple yang telah kami laporkan kepada mereka. Kebijakan ini hanya memengaruhi pengguna di iOS 10 dan hanya di beberapa situs. Jika Anda terpengaruh, solusinya adalah dengan memindahkan widget reCAPTCHA ke atas atau ke bawah di halaman tersebut, atau gunakan reCAPTCHA v3.
-
Komputer atau jaringan saya mungkin mengirimkan kueri otomatis?
-
Jika Anda diarahkan ke halaman ini dari widget reCAPTCHA, Anda akan melihat pesan yang bertuliskan "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 baik karena beberapa alasan:
- Anda mungkin berada di jaringan bersama yang sedang digunakan secara tidak semestinya
- Internet Service Provider Anda baru-baru ini mungkin menetapkan alamat IP yang mencurigakan kepada Anda
- Situs yang Anda coba akses mungkin sedang diserang berat
Untuk memecahkan masalah ini, lihat halaman bantuan traffic yang tidak biasa, atau coba lagi nanti.
-
Nama tindakan apa yang valid?
-
Tindakan mungkin hanya berisi karakter alfanumerik, garis miring, dan garis bawah.
Tindakan tidak boleh spesifik per pengguna.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: This typically occurs if the reCAPTCHA widget HTML element is programmatically removed sometime after the end user clicks on the checkbox. We recommend using the [grecaptcha.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]
