Gunakan perubahan lokasi untuk peninjauan login

Bandingkan lokasi berbasis IP saat login dengan titik tersimpan sebelumnya untuk pengguna tersebut guna menandai login yang layak diperiksa lebih lanjut — ketersediaan dan penerapan paket untuk endpoint ini belum dikonfirmasi, jadi diskusikan akses sebelum mengintegrasikannya di produksi.

Diskusikan akses pengecekan risiko Baca referensi pengecekan risiko →

Ketersediaan

POST /v1/risk/check berbagi middleware secret-key yang sama dengan pencarian IP, yang hanya memeriksa bahwa sebuah key adalah secret key — endpoint ini tidak menegakkan kelompok paket risiko yang terpisah secara independen, dan harga risiko yang di-seed tidak memiliki harga aktif yang dikonfigurasi. Konfirmasikan ketersediaan dan syarat saat ini dengan kami sebelum mengandalkan endpoint ini di produksi.

Ekstraksi IP klien yang andal

Watch-IP tidak mengekstrak IP pengguna akhir dari request Anda untuk endpoint ini — Anda mengirimkannya sendiri sebagai ip. Selesaikan dari rantai header proxy/CDN tepercaya Anda sendiri di backend, dengan kehati-hatian yang sama seperti di mana pun Anda mempercayai IP klien untuk keputusan keamanan.

ID pengguna yang buram (opaque)

Kirim pengenal internal Anda sendiri sebagai userId. Watch-IP hanya menyimpan tepat satu lokasi per pasangan (akun pelanggan Anda, userId) — gunakan pengenal yang sama di setiap login pengguna agar baseline-nya tetap bermakna.

Baseline pertama, lalu pre-check

Panggilan pertama kali pengguna selalu mengembalikan risk: "low" dengan previousLocation null — belum ada apa pun untuk dibandingkan. Untuk login berikutnya, panggil dengan commit: false sebagai sinyal awal sebelum keputusan autentikasi Anda sendiri; panggilan itu membaca baseline tersimpan tanpa mengubahnya.

Commit setelah verifikasi Anda sendiri

Setelah Anda yakin login tersebut sah — password dan faktor kedua apa pun sudah diverifikasi — panggil lagi dengan commit dibiarkan pada nilai default-nya (true) sehingga observasi ini menjadi baseline baru untuk login berikutnya.

Konkurensi dan percobaan ulang

v1 menyimpan satu titik paling baru, bukan riwayat — dua panggilan committed yang berdekatan akan menimpa nilai yang sama, dan request yang dicoba ulang setelah timeout bisa saja ikut melakukan commit dan menggeser baseline. Rancang logika percobaan ulang Anda dengan mempertimbangkan hal ini, bukan berasumsi setiap commit tercatat secara independen.

Perubahan jaringan yang sah

Perjalanan dinas, wifi hotel atau bandara, pergantian IP jaringan seluler, dan penggunaan VPN biasa semuanya bisa menghasilkan klasifikasi medium atau high — v1 tidak memiliki penekanan yang sadar-VPN/pusat-data. Perlakukan login yang ditandai sebagai satu input untuk proses peninjauan Anda sendiri, bukan bukti akun diretas.

Apa yang tidak dijamin oleh ini

Klasifikasi high adalah perhitungan kecepatan mentah antara dua titik, bukan konfirmasi pengambilalihan akun, dan klasifikasi low tidak membersihkan login yang mencurigakan karena alasan lain. Retensi mengikuti perilaku penyimpanan di atas: titik tersimpan bertahan sampai pengecekan committed berikutnya menimpanya, tanpa kedaluwarsa otomatis dan tanpa endpoint penghapusan yang tersedia saat ini — pertimbangkan hal ini dalam komitmen retensi data apa pun yang Anda buat kepada pengguna Anda sendiri.