Memecahkan masalah integrasi reCAPTCHA

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:

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 "&ltyour domain&gt"

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.