Menggunakan fitur reCAPTCHA setelah migrasi

Halaman ini menjelaskan cara mengubah integrasi reCAPTCHA yang ada untuk menggunakan fitur reCAPTCHA, seperti Autentikasi multi-faktor (MFA) dan Deteksi Kebocoran Sandi setelah bermigrasi dari reCAPTCHA Classic. Mengubah integrasi reCAPTCHA yang ada mencakup instrumentasi halaman web dan memigrasikan panggilan backend.

Sebelum memulai

Bermigrasi ke reCAPTCHA.

Menginstrumentasikan halaman web

Untuk melengkapi halaman web dengan skrip dan panggilan reCAPTCHA, lakukan hal berikut:

  1. Pastikan Anda menyertakan skrip berikut di halaman web: https://www.google.com/recaptcha/api.js.

  2. Di halaman web Anda, ganti https://www.google.com/recaptcha/api.js dengan https://www.google.com/recaptcha/enterprise.js.

  3. 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, lakukan hal berikut:

  1. Pastikan Anda memuat enterprise.js secara asinkron. Untuk informasi selengkapnya, lihat Memuat reCAPTCHA secara asinkron.

  2. Tambahkan petunjuk resource berikut di tag <head> halaman yang memuat enterprise.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, Anda harus memigrasikan panggilan backend ke endpoint baru dan menyiapkan autentikasi:

  1. Ganti panggilan backend ke https://www.google.com/recaptcha/api/siteverify dengan panggilan yang setara ke recaptchaenterprise.googleapis.com. Untuk URL lengkap dan format data POST, lihat Membuat penilaian untuk situs Anda.

  2. Siapkan autentikasi ke reCAPTCHA.

    Metode autentikasi yang Anda pilih bergantung pada lingkungan tempat reCAPTCHA 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 Gunakan kunci API atau Workload identity federation.

    Jika Anda ingin menggunakan kunci API, sebaiknya amankan kunci API dengan menerapkan pembatasan kunci API.
    Library klien

    Gunakan resource berikut:

Langkah selanjutnya