Tambahkan sinyal VPN dan Tor ke geolokasi pengunjung

Pahami kapan koneksi pengunjung cocok dengan jaringan VPN yang dikenal, exit node Tor, jaringan pusat data/hosting, atau kategori jaringan lain yang didukung. Watch-IP menambahkan indikator ini ke respons GET /v1/geo yang memenuhi syarat sehingga aplikasi Anda dapat mempertimbangkannya bersama konteks lain.

Lihat paket mana yang menyertakan security Baca referensi geo →

Paket yang memenuhi syarat

security disertakan pada paket Starter, Growth, Scale, dan Enterprise. Ini sepenuhnya dihilangkan dari respons pada paket Free — bukan dikirim sebagai objek semua-false yang menyesatkan — jadi periksa keberadaannya sebelum membaca field apa pun darinya.

Cakupan IPv4 dan IPv6 berbeda

Koneksi IPv4 diperiksa terhadap daftar Tor, VPN, pusat data, ancaman, dan jaringan yang terkena sanksi. Koneksi IPv6 diperiksa terhadap semuanya kecuali Tor — saat ini belum ada sumber daftar exit Tor IPv6 yang gratis, jadi isTor selalu false untuk koneksi IPv6 terlepas dari apakah itu benar-benar exit Tor. Jangan menggambarkan cakupan IPv6 setara dengan IPv4.

Tidak ada, false, dan true adalah keadaan yang berbeda

Objek security yang tidak ada berarti paket Anda tidak menyertakan data ini, bukan berarti koneksi tersebut diperiksa dan dinyatakan bersih. Nilai false pada field yang disertakan berarti tidak ada kecocokan dalam daftar yang saat ini dimuat Watch-IP — bukan vonis aman-terkonfirmasi, karena deteksi berbasis daftar tidak bisa melihat segalanya. Jangan pernah menampilkan hasil yang belum dievaluasi atau bernilai false sebagai "Bersih," "Aman," atau "Terverifikasi."

Sumber dan pembaruan

Daftar di balik field ini dikumpulkan dan disimpan di penyimpanan kami sendiri serta diperbarui secara terjadwal. Cold start akan sedikit tertunda pada pencarian pertamanya; setelah termuat, request dilayani dari cache dalam memori sementara pembaruan berjalan di latar belakang, sehingga pembaruan yang lambat atau gagal akan menurun menjadi data usang atau kosong, bukan respons yang rusak.

Contoh alur kerja peninjauan

Perlakukan isVpn atau isDatacenter sebagai satu input untuk antrean peninjauan manual bersama riwayat akun dan sinyal lain, bukan satu-satunya dasar untuk langsung memblokir pengunjung. Memasangkannya dengan pengecekan email sekali pakai pada event pendaftaran yang sama, misalnya, adalah cara yang masuk akal untuk mengarahkan sejumlah kecil pendaftaran ke peninjauan alih-alih menolak setiap pengguna VPN.

Apa yang tidak dilakukan oleh ini

Field ini tidak mengidentifikasi residential proxy, tidak memverifikasi identitas, dan bukan produk deteksi ancaman atau anonimitas yang komprehensif — ini adalah sekumpulan kecil indikator berbasis daftar.

Field respons security

isTor: Exit node Tor yang dikenal, dari daftar exit IPv4 yang saat ini dimuat. Selalu false untuk IPv6.
isVpn: Jaringan penyedia VPN komersial yang dikenal, IPv4 dan IPv6.
isDatacenter: Jaringan pusat data/hosting — superset dari VPN, karena banyak exit VPN berjalan di infrastruktur hosting.
isThreat: Berada pada rentang IP berbahaya yang dikenal atau ASN yang dikenal sebagai ancaman, IPv4 dan IPv6.
isSanctionedNetwork: Berada pada daftar operator jaringan telekomunikasi/hosting yang disanksi negara yang dikelola Watch-IP, ditinjau setiap kuartal — sinyal yang lebih lunak dan kurang meyakinkan dibanding field lain, bukan penyaringan kepatuhan sanksi.

Baca field security dengan aman

Browser JavaScript

const response = await fetch('https://api.watch-ip.com/v1/geo', {
  headers: { 'X-Api-Key': 'YOUR_PUBLISHABLE_KEY' },
});
const geo = await response.json();

if (!geo.security) {
  // Paket Anda tidak menyertakan data security — jangan berasumsi apa pun tentang koneksi ini.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Kecocokan dalam daftar — satu input untuk logika peninjauan Anda sendiri, bukan pemblokiran dengan sendirinya.
} else {
  // Tidak ada kecocokan dalam daftar yang saat ini dimuat — bukan jaminan koneksi tersebut aman.
}

Selalu periksa apakah `security` ada sebelum membaca field apa pun darinya — objek yang tidak ada dan field yang ada tapi bernilai false memiliki arti yang berbeda.

Pertanyaan yang sering diajukan

Apakah ini mendeteksi residential proxy?

Tidak. Daftar saat ini mencakup jaringan VPN komersial, Tor, pusat data, dan ancaman/sanksi yang dikenal — bukan kategori residential-proxy yang lebih luas, yang melewati alamat IP konsumen asli dan jauh lebih sulit dicocokkan dengan daftar.

Apa arti false?

Tidak ada kecocokan dalam daftar yang saat ini dimuat Watch-IP. Ini bukan pernyataan positif bahwa koneksi tersebut aman, karena satu daftar tidak bisa mencakup setiap VPN, exit node, atau jaringan berbahaya yang ada.

Apakah Tor IPv6 dicakup?

Tidak. isTor selalu false untuk koneksi IPv6 saat ini — belum ada sumber daftar exit Tor IPv6 gratis dalam implementasi saat ini. Semua field lain mencakup IPv6.

Apakah pengecekan ini tersedia untuk IP sembarang?

Belum saat ini. Data ini adalah bagian dari respons GET /v1/geo hanya untuk browser yang terhubung; endpoint pencarian IP terpisah (/v1/lookup) tidak mengembalikan blok security.

Bisakah saya memblokir hanya berdasarkan satu flag?

Anda bisa, tapi satu flag berbasis daftar adalah dasar yang lemah untuk pemblokiran otomatis dengan sendirinya — positif palsu bisa terjadi, dan pengguna sah melewati VPN dan jaringan bersama karena alasan yang wajar. Kebanyakan integrasi menggunakan field ini sebagai satu input untuk keputusan peninjauan.