Halaman ini menjelaskan cara memodifikasi integrasi reCAPTCHA yang ada untuk menggunakan fitur reCAPTCHA Enterprise, seperti Autentikasi multi-faktor (MFA) dan Deteksi Kebocoran Sandi setelah bermigrasi dari reCAPTCHA versi non-Enterprise. Modifikasi integrasi reCAPTCHA yang ada mencakup instrumentasi halaman web dan migrasi panggilan backend.
Sebelum memulai
Migrasikan ke reCAPTCHA Enterprise.
Melengkapi halaman web
Untuk melengkapi halaman web dengan skrip dan panggilan reCAPTCHA Enterprise, lakukan hal berikut:
- Pastikan Anda memiliki skrip berikut yang disertakan di halaman web:
https://www.google.com/recaptcha/api.js
. Di halaman web Anda, ganti
https://www.google.com/recaptcha/api.js
denganhttps://www.google.com/recaptcha/enterprise.js
.Jika Anda memanggil API secara terprogram, ganti panggilan berikut:
grecaptcha.execute()
->grecaptcha.enterprise.execute()
grecaptcha.getResponse()
->grecaptcha.enterprise.getResponse()
grecaptcha.ready()
->grecaptcha.enterprise.ready()
grecaptcha.render()
->grecaptcha.enterprise.render()
grecaptcha.reset()
->grecaptcha.enterprise.reset()
(Opsional) Untuk meningkatkan performa pemuatan reCAPTCHA Enterprise, lakukan hal berikut:
Pastikan Anda memuat
enterprise.js
secara asinkron. Untuk mengetahui informasi selengkapnya, lihat Memuat reCAPTCHA secara asinkron.Tambahkan petunjuk resource berikut dalam tag
<head>
halaman yang memuatenterprise.js
:<link rel="preconnect" href="https://www.google.com">
<link rel="preconnect" href="https://www.gstatic.com" crossorigin>
Memigrasikan panggilan backend
Untuk menggunakan fitur reCAPTCHA Enterprise, Anda harus memigrasikan panggilan backend ke endpoint baru dan menyiapkan autentikasi:
Ganti panggilan backend ke
https://www.google.com/recaptcha/api/siteverify
dengan panggilan yang setara kerecaptchaenterprise.googleapis.com
. Untuk URL lengkap dan format data POST, lihat Membuat penilaian untuk situs Anda.Siapkan autentikasi ke reCAPTCHA Enterprise.
Metode autentikasi yang Anda pilih bergantung pada lingkungan tempat reCAPTCHA Enterprise disiapkan. Tabel berikut membantu Anda memilih metode autentikasi yang sesuai dan antarmuka yang didukung untuk menyiapkan autentikasi:
Lingkungan Antarmuka Metode autentikasi Google Cloud - REST
- Library klien
Gunakan akun layanan terlampir. Lokal atau penyedia cloud lain REST Menggunakan kunci API atau federasi identitas workload. Jika Anda ingin menggunakan kunci API, sebaiknya amankan kunci API tersebut dengan menerapkan pembatasan kunci API.
Library klien Gunakan resource berikut:
- Untuk Python atau Java, gunakan kunci API atau federasi identitas workload.
Jika Anda ingin menggunakan kunci API, sebaiknya amankan kunci API tersebut dengan menerapkan pembatasan kunci API.
- Untuk bahasa lain, gunakan federasi identitas workload.