Dokumen ini mencantumkan masalah integrasi reCAPTCHA umum yang mungkin dihadapi developer saat menggunakan reCAPTCHA di lingkungan mereka.
Kunci situs tidak valid atau jenis kunci tidak valid
Jika Anda melihat error Invalid site key atau Invalid key type, periksa
hal berikut:
- Pastikan versi kunci di konsol Google Cloud cocok dengan versi
yang dikonfigurasi di situs atau plugin CMS pihak ketiga Anda (misalnya,
Website • scoreuntukv3, atauWebsite • checkboxuntukv2 Checkbox). Untuk memeriksa versi kunci Anda, lihat Melihat versi kunci Anda di konsolGoogle Cloud . - Jika kunci situs reCAPTCHA Anda dihapus atau tidak lagi valid, buat kunci baru dan update plugin CMS atau instal kunci di halaman web Anda.
Kegagalan migrasi kunci
Kunci situs dapat gagal dimigrasikan dalam salah satu skenario berikut:
Anda telah melebihi batas jumlah project yang dapat Anda atau organisasi Anda buat.
Untuk mengatasi hal ini, Anda dapat menggunakan kembali project yang sudah ada, meminta penambahan kuota pembuatan project, atau menunggu hingga migrasi otomatis selesai.
Organisasi Workspace Anda telah membatasi pembuatan project Google Cloud baru.
Untuk mengaktifkan layanan Google Cloud di konsol Google Admin, hubungi administrator Anda. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan atau menonaktifkan Google Cloud untuk pengguna.
SecurityError: memblokir frame dengan origin "https://www.google.com" agar tidak mengakses frame dengan origin "<your domain>"
Hal ini biasanya terjadi jika elemen HTML widget reCAPTCHA dihapus secara terprogram beberapa saat setelah pengguna akhir mengklik kotak centang. Sebaiknya gunakan fungsi JavaScript grecaptcha.enterprise.reset() untuk mereset widget reCAPTCHA.
Localhost tidak ada dalam daftar domain yang didukung
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 konsolGoogle Cloud untuk memperbarui daftar domain yang didukung. Sebaiknya gunakan kunci terpisah untuk pengembangan dan produksi, serta hanya izinkan localhost di kunci situs pengembangan Anda.
reCAPTCHA menampilkan BROWSER_ERROR saat membuat penilaian
Token BROWSER_ERROR terjadi saat skrip reCAPTCHA tidak dapat melakukan operasi execute. Dalam kebanyakan kasus, hal ini disebabkan oleh kegagalan atau waktu tunggu jaringan sisi klien. Anda harus mencoba lagi execute() menggunakan JavaScript.