Menafsirkan penilaian untuk situs

Halaman ini menjelaskan cara menafsirkan skor untuk memahami tingkat risiko yang ditimbulkan oleh interaksi pengguna, dan mengambil tindakan yang sesuai untuk situs Anda.

reCAPTCHA menampilkan skor untuk setiap permintaan berdasarkan interaksi dengan situs Anda, terlepas dari jenis kuncinya. Setelah menerima skor dari reCAPTCHA, Anda harus menafsirkan skor tersebut dan mengambil tindakan yang sesuai untuk situs Anda.

Sebelum memulai

Buat penilaian untuk situs Anda.

Menafsirkan penilaian

Setelah backend Anda mengirimkan token respons reCAPTCHA pengguna ke reCAPTCHA, Anda akan menerima penilaian sebagai respons JSON seperti yang ditunjukkan dalam contoh berikut.

Untuk menafsirkan penilaian, pertimbangkan parameter berikut:

  • valid: menunjukkan apakah token respons pengguna yang diberikan valid. Jika valid = false, alasannya ditentukan di invalidReason. valid = false juga dapat menunjukkan bahwa pengguna gagal menyelesaikan tantangan atau ada ketidakcocokan siteKey.
  • invalidReason: alasan yang terkait dengan respons saat valid = false.
  • action: interaksi pengguna yang memicu verifikasi reCAPTCHA.
  • expectedAction: tindakan yang diharapkan dari pengguna yang Anda tentukan saat membuat penilaian.
  • score: tingkat risiko yang ditimbulkan oleh interaksi pengguna. Skor yang lebih tinggi menunjukkan risiko yang lebih rendah.
  • reasons: informasi tambahan tentang cara reCAPTCHA menafsirkan interaksi pengguna.
  • challenge: menunjukkan respons terhadap verifikasi untuk kunci verifikasi berbasis kebijakan. Nilai yang mungkin: PASSED, FAILED, atau NOCAPTCHA.

  • extendedVerdictReasons: alasan lanjutan yang berkontribusi pada verdict analisis risiko.

    Kode alasan tersedia setelah memicu peninjauan keamanan otomatis dengan menambahkan akun penagihan ke project Anda. Untuk meminta akses ke kode alasan, tambahkan akun penagihan ke project Anda.

    Penilaian dari project dengan langganan Enterprise juga menerima kode alasan Advanced. Hubungi perwakilan akun atau Google Cloud bagian penjualan untuk mengetahui daftar lengkap alasan Lanjutan dan cara menafsirkannya.

    {
 "event":{
    "expectedAction":"EXPECTED_ACTION",
    "userInfo":{
      "accountId":"ACCOUNT_ID"
    },
    "siteKey":"KEY_ID",
    "token":"TOKEN",
    "userAgent":"(USER-PROVIDED STRING)",
    "userIpAddress":"USER_PROVIDED_IP_ADDRESS"
 },
 "name":"ASSESSMENT_ID",
 "riskAnalysis":{
   "reasons":[],
   "extendedVerdictReasons":[],
   "score":"SCORE",
   "challenge":"PASSED"
 },
 "tokenProperties":{
   "action":"USER_INTERACTION",
   "createTime":"TIMESTAMP",
   "hostname":"HOSTNAME",
   "invalidReason":"(ENUM)",
   "valid":(BOOLEAN)
 }
}

Memverifikasi tindakan

Respons JSON berisi parameter action yang Anda tentukan untuk interaksi pengguna saat memanggil execute() dan parameter expectedAction yang Anda tentukan saat membuat penilaian.

Pastikan action cocok dengan expectedAction. Misalnya, tindakan login harus ditampilkan di halaman login Anda. Jika ada ketidakcocokan, hal ini menunjukkan bahwa penyerang mencoba memalsukan tindakan. Anda dapat mengambil tindakan terhadap interaksi pengguna, seperti menambahkan verifikasi tambahan atau memblokir interaksi untuk mencegah aktivitas penipuan.

Menafsirkan skor

Sistem penskoran reCAPTCHA merupakan perluasan dari versi reCAPTCHA sebelumnya untuk memungkinkan perincian yang lebih besar dalam respons. reCAPTCHA memiliki 11 level untuk skor dengan nilai mulai dari 0,0 hingga 1,0. Skor 1,0 menunjukkan bahwa interaksi menimbulkan risiko rendah dan kemungkinan besar sah, sedangkan 0,0 menunjukkan bahwa interaksi menimbulkan risiko tinggi dan kemungkinan bersifat menipu.

Dari 11 level, hanya empat tingkat skor berikut yang tersedia sebelum memicu peninjauan keamanan otomatis dengan menambahkan akun penagihan ke project Anda: 0,1, 0,3, 0,7, dan 0,9.

Untuk meminta akses ke 11 tingkat skor, tambahkan akun penagihan ke project Anda.

Skor risiko SMS defense bekerja secara terbalik dibandingkan dengan skor global reCAPTCHA. Skor risiko SMS defense sebesar 0,0 menunjukkan keyakinan rendah bahwa penipuan pulsa SMS terjadi; skor risiko sebesar 1,0 menunjukkan keyakinan tinggi bahwa penipuan pulsa SMS terjadi.

reCAPTCHA belajar dengan memantau traffic sebenarnya di situs Anda. Oleh karena itu, skor di lingkungan staging dan dalam waktu 7 hari setelah penerapan mungkin berbeda dari skor produksi jangka panjang.

Jika Anda menginstal kunci berbasis skor, Anda dapat menjalankan reCAPTCHA terlebih dahulu tanpa mengambil tindakan, lalu menentukan nilai minimum dengan melihat traffic.

Berdasarkan skor, Anda dapat mengambil tindakan yang sesuai dalam konteks situs Anda. Untuk melindungi situs Anda dengan lebih baik, sebaiknya lakukan tindakan di latar belakang, bukan memblokir traffic.

Tabel berikut mencantumkan beberapa tindakan yang mungkin Anda lakukan:

Kasus penggunaan Tindakan
beranda Lihat tampilan terpadu traffic Anda di konsol admin sambil memfilter scraper.
login Dengan skor rendah, minta MFA atau verifikasi email untuk mencegah serangan credential stuffing.
social Batasi permintaan pertemanan yang tidak dijawab dari pengguna yang melakukan pelecehan dan kirim komentar berisiko ke moderasi.
e-commerce Prioritaskan penjualan nyata Anda daripada bot dan identifikasi transaksi berisiko.

Kode alasan

Kode alasan tersedia setelah memicu peninjauan keamanan otomatis dengan menambahkan akun penagihan ke project Anda. Untuk meminta akses ke kode alasan, tambahkan akun penagihan ke project Anda.

Beberapa skor mungkin ditampilkan dengan kode alasan yang memberikan informasi tambahan tentang cara reCAPTCHA menafsirkan interaksi.

Tabel berikut mencantumkan kode alasan dan deskripsinya:

Kode alasan Deskripsi
AUTOMATION Interaksi cocok dengan perilaku agen otomatis.
UNEXPECTED_ENVIRONMENT Peristiwa berasal dari lingkungan yang tidak sah.
TOO_MUCH_TRAFFIC Volume traffic dari sumber peristiwa lebih tinggi dari biasanya.
UNEXPECTED_USAGE_PATTERNS Interaksi dengan situs Anda berbeda secara signifikan dari pola yang diharapkan.
LOW_CONFIDENCE_SCORE Traffic yang diterima dari situs ini terlalu sedikit untuk menghasilkan analisis risiko yang berkualitas.

Respons metode siteverify

Untuk mengetahui detail permintaan, respons, dan kode error untuk metode siteverify, lihat Memverifikasi token respons pengguna dengan SiteVerify lama.

Langkah berikutnya

  • Untuk menyesuaikan model spesifik per situs, Anda dapat mengirimkan kembali ID penilaian ke Google untuk mengonfirmasi positif benar dan negatif benar, atau memperbaiki error. Untuk mengetahui detailnya, lihat Menganotasi penilaian.