Gunakan fitur reCAPTCHA Enterprise setelah migrasi

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:

  1. Pastikan Anda memiliki skrip berikut yang disertakan 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 Enterprise, lakukan hal berikut:

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

  2. Tambahkan petunjuk resource berikut dalam 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 Enterprise, 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 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:

Langkah selanjutnya