Memecahkan masalah integrasi Identity Platform dengan reCAPTCHA Enterprise API

Dokumen ini memberikan panduan untuk memecahkan masalah potensial yang mungkin timbul saat menggunakan integrasi Identity Platform dengan reCAPTCHA Enterprise API, termasuk fitur perlindungan bot reCAPTCHA dan SMS defense reCAPTCHA.

Pemecahan masalah orientasi integrasi

Pengguna Anda mungkin mengalami masalah karena kesalahan saat melakukan aktivasi dengan integrasi Identity Platform dengan reCAPTCHA Enterprise API. Beberapa alasan umum mungkin mencakup hal berikut:

  • Anda mungkin melewatkan langkah dalam penyiapan integrasi Identity Platform dengan reCAPTCHA Enterprise API. Misalnya, mengabaikan penyiapan akun layanan atau mengaktifkan reCAPTCHA Enterprise API di project. Pastikan Anda telah menyelesaikan semua persyaratan integrasi. Untuk mengetahui petunjuk penyiapan, lihat Mengintegrasikan Identity Platform dengan reCAPTCHA Enterprise API.
  • Jika Anda membawa kunci Anda sendiri untuk digunakan dengan reCAPTCHA, kunci reCAPTCHA terkait yang Anda upload mungkin tidak valid atau mungkin telah berhenti berfungsi. Pastikan kunci berfungsi dan dapat diakses oleh Identity Platform.
  • Pengguna mungkin menggunakan versi aplikasi Anda yang sudah tidak berlaku. Pastikan Anda menyediakan versi terbaru aplikasi yang menggunakan SDK klien, dan minta pengguna untuk mengupdate aplikasi mereka. Untuk menyiapkan SDK klien bagi aplikasi Anda, lihat Mengonfigurasi SDK klien.

Pengguna tidak dapat melakukan autentikasi melalui alur yang didukung reCAPTCHA Enterprise API

Jika Anda mengalami masalah dengan alur yang didukung API reCAPTCHA Enterprise, seperti perlindungan bot reCAPTCHA atau SMS defense reCAPTCHA, lihat bagian berikut untuk panduan khusus fitur.

Pemecahan masalah perlindungan dari bot reCAPTCHA

Topik berikut menjelaskan kemungkinan masalah yang mungkin Anda hadapi saat menggunakan perlindungan bot dan cara mengatasinya.

Pengguna tidak dapat melakukan autentikasi saat menggunakan perlindungan bot untuk penyedia email-sandi atau telepon

Jika Anda telah memastikan bahwa integrasi Identity Platform dengan reCAPTCHA Enterprise API disiapkan dengan benar, pengguna mungkin diblokir untuk melakukan tindakan autentikasi melalui penyedia email-sandi atau telepon berdasarkan konfigurasi Anda saat ini. Misalnya, pengguna mungkin tidak dapat melakukan tindakan berikut:

  • Login, mendaftar, atau mereset sandi melalui alamat email.
  • Minta kode SMS untuk login melalui nomor telepon.
  • Mendaftar atau login dengan autentikasi multi-faktor berbasis SMS.

Untuk mengatasi masalah autentikasi ini, coba langkah berikut:

  • Jika permintaan pengguna gagal dengan ERROR_CAPTCHA_CHECK_FAILED, pertimbangkan konfigurasi yang lebih permisif dengan menyesuaikan nilai minimum yang telah Anda tetapkan untuk managedRules. Setiap permintaan yang skornya di bawah nilai minimum yang Anda tetapkan akan dianggap sebagai bot. Misalnya, jika Anda menetapkan nilai minimum 0.6, reCAPTCHA akan menggagalkan permintaan apa pun dengan skor 0.5 atau lebih rendah. Oleh karena itu, makin tinggi skor yang Anda tetapkan, makin ketat aturannya.
  • Minta pengguna untuk mencoba perangkat, browser, atau jaringan lain.
  • Untuk alur autentikasi email-sandi, kembalikan emailPasswordEnforcementState ke mode AUDIT dan pantau metrik sebelum mengaktifkan kembali mode ENFORCE.
  • Untuk alur autentikasi ponsel, sesuaikan nilai minimum skor managedRules Anda atau nonaktifkan perlindungan bot untuk penyedia ponsel saat memecahkan masalah. Jika SMS defense reCAPTCHA juga diaktifkan dan Anda ingin tetap mengaktifkannya, tetapkan useSmsBotScore ke false dan biarkan phoneEnforcementState ditetapkan ke ENFORCE. Untuk menonaktifkan semua perlindungan reCAPTCHA ponsel, tetapkan phoneEnforcementState ke OFF, useSmsBotScore ke false, dan useSmsTollFraudProtection ke false.

Pemecahan masalah SMS defense reCAPTCHA

Topik berikut menjelaskan kemungkinan masalah yang mungkin Anda hadapi saat menggunakan SMS defense reCAPTCHA dan cara mengatasinya.

Pengguna tidak dapat melakukan autentikasi saat menggunakan SMS defense reCAPTCHA untuk penyedia telepon

Jika Anda telah memastikan bahwa integrasi Identity Platform dengan reCAPTCHA Enterprise API disiapkan dengan benar, pengguna mungkin diblokir untuk melakukan tindakan autentikasi berbasis SMS melalui penyedia telepon berdasarkan konfigurasi Anda saat ini. Misalnya, pengguna mungkin tidak dapat meminta kode SMS untuk login dengan nomor telepon atau mendaftar atau login dengan autentikasi multi-faktor. Hal ini dapat terjadi jika skor SMS defense reCAPTCHA yang Anda tetapkan terlalu ketat.

Untuk mengatasinya, pertimbangkan konfigurasi yang lebih permisif dengan menyesuaikan nilai minimum yang telah Anda tetapkan untuk tollFraudManagedRules. Skor apa pun di atas nilai minimum yang Anda tetapkan akan dianggap sebagai penipuan pulsa SMS. Misalnya, jika Anda menetapkan nilai minimum 0.3, reCAPTCHA akan menggagalkan permintaan apa pun dengan 0.4 atau lebih tinggi. Oleh karena itu, makin rendah skor yang Anda tetapkan, makin ketat aturannya.

Pantau metrik reCAPTCHA yang dikeluarkan oleh project Anda untuk memverifikasi bahwa aplikasi Anda menerima traffic pengguna yang dapat diterima setelah menyesuaikan nilai minimum skor.

Langkah berikutnya