Memantau metrik reCAPTCHA

Dokumen ini menjelaskan metrik reCAPTCHA yang dikeluarkan Identity Platform sebagai hasil dari integrasi Identity Platform dengan reCAPTCHA Enterprise API dan cara melihatnya dengan Cloud Monitoring.

Metrik reCAPTCHA

Setelah menyiapkan integrasi Identity Platform dengan reCAPTCHA Enterprise API, dan secara opsional, mengaktifkan SMS defense reCAPTCHA, Anda dapat memantau metrik reCAPTCHA yang dikeluarkan project Anda untuk memastikan bahwa alur autentikasi Anda terlindungi. Jika penyediaan kunci reCAPTCHA gagal atau jika akun layanan yang diperlukan tidak dibuat, autentikasi reCAPTCHA akan gagal terbuka.

Jika Anda telah mengaktifkan perlindungan dari bot reCAPTCHA dalam mode audit untuk alur autentikasi email-sandi, pemantauan metrik reCAPTCHA akan membantu Anda menentukan apakah Anda dapat mengaktifkan penerapan. Anda harus mempertimbangkan hal berikut sebelum mengaktifkan penerapan:

  • Jika sebagian besar permintaan terbaru memiliki token yang valid dan rasio verdict PASSED terhadap FAILED_AUDIT atau FAILED_ENFORCE dapat diterima untuk kasus bisnis Anda, pertimbangkan untuk mengaktifkan penerapan.
  • Jika sebagian besar permintaan terbaru kemungkinan berasal dari klien yang sudah tidak berlaku, sebaiknya tunggu lebih banyak pengguna mengupdate aplikasi mereka sebelum mengaktifkan penerapan. Penerapan integrasi Identity Platform dengan reCAPTCHA Enterprise API akan merusak versi aplikasi sebelumnya yang tidak terintegrasi dengan reCAPTCHA.

Untuk memastikan fitur integrasi berfungsi sebagaimana mestinya, Anda dapat memeriksa metrik berikut yang dikirim project Anda ke Cloud Monitoring.

identitytoolkit.googleapis.com/recaptcha/verdict_count

Metrik ini melacak berbagai verdict yang ditampilkan oleh reCAPTCHA. Keputusan akan dibuat jika token ada. Anda dapat memfilter berdasarkan verdict berikut:

  • PASSED: Menunjukkan bahwa permintaan tertentu diizinkan saat penegakan diaktifkan.
  • FAILED_AUDIT: Menunjukkan bahwa permintaan autentikasi email-sandi tertentu akan ditolak jika mode audit reCAPTCHA diaktifkan.
  • FAILED_ENFORCE: Menunjukkan bahwa permintaan tertentu ditolak saat penerapan reCAPTCHA diaktifkan.
  • CLIENT_TYPE_MISSING: Menunjukkan bahwa permintaan tertentu tidak memiliki jenis klien saat penerapan reCAPTCHA diaktifkan. Error ini biasanya terjadi jika permintaan dikirim menggunakan versi SDK klien lama yang tidak memiliki dukungan reCAPTCHA.
  • KEYS_MISSING: Menunjukkan bahwa permintaan tertentu tidak dapat diverifikasi karena Identity Platform tidak dapat mengambil kunci reCAPTCHA yang valid saat penerapan reCAPTCHA diaktifkan.

Untuk mengubah rentang skor guna mengubah rasio keputusan lulus dan gagal, lihat Mengaktifkan perlindungan bot reCAPTCHA.

identitytoolkit.googleapis.com/recaptcha/token_count

Metrik ini melacak jumlah dan status token reCAPTCHA yang diterima oleh backend Identity Platform. Anda dapat memfilter status berikut:

  • VALID: Menunjukkan bahwa token reCAPTCHA yang diteruskan valid.
  • EXPIRED: Menunjukkan bahwa token reCAPTCHA yang diteruskan telah berakhir masa berlakunya. Token yang sudah tidak berlaku mungkin mengindikasikan masalah jaringan klien atau penyalahgunaan.
  • DUPLICATE: Menunjukkan bahwa token reCAPTCHA yang diteruskan adalah duplikat. Token duplikat mungkin mengindikasikan masalah jaringan klien atau penyalahgunaan.
  • INVALID: Menunjukkan bahwa token reCAPTCHA yang diteruskan tidak valid. Token yang tidak valid mungkin mengindikasikan penyalahgunaan.
  • MISSING: Menunjukkan bahwa token reCAPTCHA tidak ada dalam permintaan yang diberikan. Token yang tidak ada mungkin menunjukkan aplikasi klien yang sudah tidak berlaku.
  • UNCHECKED: Menunjukkan bahwa token reCAPTCHA tidak diperiksa karena verdict CLIENT_TYPE_MISSING atau KEYS_MISSING.

Jika aplikasi Anda berhasil diluncurkan kepada pengguna, Anda akan melihat traffic dengan token yang valid. Jumlah token yang valid kemungkinan sebanding dengan jumlah pengguna yang menggunakan aplikasi yang telah diupdate.

identitytoolkit.googleapis.com/recaptcha/risk_scores

Metrik ini melacak distribusi skor reCAPTCHA. Hal ini dapat membantu Anda menentukan rentang skor yang optimal untuk konfigurasi perlindungan bot.

identitytoolkit.googleapis.com/recaptcha/sms_tf_risk_scores

Metrik ini melacak distribusi skor risiko SMS defense reCAPTCHA untuk project Identity Platform tertentu. Hal ini dapat membantu Anda menentukan rentang skor yang optimal untuk konfigurasi SMS defense reCAPTCHA Anda.

Melihat metrik reCAPTCHA

Untuk melihat metrik reCAPTCHA dengan Cloud Monitoring, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Metrics explorer.

    Buka Metrics explorer

  2. Dari Select a metric, masukkan Identity Toolkit Tenant. Jika Anda menggunakan multi-tenancy, Anda dapat melihat metrik untuk setiap tenant, serta project induk, dengan membiarkan tenant_name kosong.

Langkah berikutnya