Aggiungi segnali VPN e Tor alla geolocalizzazione del visitatore

Scopri quando la connessione di un visitatore corrisponde a una rete VPN nota, un nodo di uscita Tor, una rete datacenter/hosting o un'altra categoria di rete supportata. Watch-IP aggiunge questi indicatori alle risposte GET /v1/geo idonee, così la tua applicazione può valutarli insieme ad altro contesto.

Vedi quali piani includono la sicurezza Leggi il riferimento geo →

Piani idonei

security è incluso nei piani Starter, Growth, Scale ed Enterprise. È omesso interamente dalla risposta nel piano Free — non inviato come un oggetto fuorviante tutto false — quindi verifica la sua presenza prima di leggere qualsiasi campo al suo interno.

La copertura IPv4 e IPv6 differisce

Le connessioni IPv4 vengono verificate rispetto alle liste di Tor, VPN, datacenter, minacce e reti sanzionate. Le connessioni IPv6 vengono verificate rispetto a tutto tranne Tor — al momento non esiste una fonte gratuita di elenco dei nodi di uscita Tor per IPv6, quindi isTor è sempre false per una connessione IPv6, indipendentemente dal fatto che sia effettivamente un nodo di uscita Tor. Non descrivere la copertura IPv6 come equivalente a quella IPv4.

Omesso, false e true sono stati diversi

Un oggetto security omesso significa che il tuo piano non include questi dati, non che la connessione sia stata verificata e giudicata pulita. Un valore false su un campo incluso significa nessuna corrispondenza nelle liste attualmente caricate da Watch-IP — non un verdetto di sicurezza confermata, poiché il rilevamento basato su liste non può vedere tutto. Non presentare mai un risultato non valutato o false come "Pulito", "Sicuro" o "Verificato".

Fonti e aggiornamenti

Le liste alla base di questi campi vengono compilate e archiviate nel nostro storage e aggiornate secondo una pianificazione. Un avvio a freddo blocca brevemente alla prima ricerca; una volta caricata, una richiesta viene servita da una cache in memoria mentre un aggiornamento viene eseguito in background, quindi un aggiornamento lento o non riuscito degrada verso dati obsoleti o vuoti anziché una risposta interrotta.

Un esempio di flusso di revisione

Tratta isVpn o isDatacenter come un input a una coda di revisione manuale insieme alla cronologia dell'account e ad altri segnali, non come l'unica base per bloccare del tutto un visitatore. Abbinarlo a un controllo di email usa e getta sullo stesso evento di registrazione, ad esempio, è un modo ragionevole per instradare in revisione un piccolo numero di registrazioni invece di rifiutare ogni utente VPN.

Cosa questo non fa

Questi campi non identificano i proxy residenziali, non verificano l'identità e non costituiscono un prodotto completo di rilevamento di minacce o anonimato — sono un piccolo insieme di indicatori basati su liste.

Campi della risposta di sicurezza

isTor: Nodo di uscita Tor noto, dall'elenco di uscita IPv4 attualmente caricato. Sempre false per IPv6.
isVpn: Rete di un provider VPN commerciale noto, IPv4 e IPv6.
isDatacenter: Rete datacenter/hosting — un superinsieme di VPN, poiché molte uscite VPN operano su infrastrutture di hosting.
isThreat: Su un intervallo IP dannoso noto o un ASN noto per minacce, IPv4 e IPv6.
isSanctionedNetwork: Su un elenco mantenuto da Watch-IP di operatori di rete telecom/hosting sanzionati dallo stato, rivisto trimestralmente — un segnale più debole e a minore affidabilità rispetto agli altri campi, non un controllo di conformità alle sanzioni.

Leggi i campi di sicurezza in modo sicuro

JavaScript da browser

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) {
  // Il tuo piano non include dati di sicurezza — non presumere nulla su questa connessione.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Una corrispondenza nella lista — un input alla tua logica di revisione, non un blocco di per sé.
} else {
  // Nessuna corrispondenza nelle liste attualmente caricate — non una garanzia che la connessione sia sicura.
}

Verifica sempre se `security` è presente prima di leggere un campo al suo interno — un oggetto assente e un campo presente ma false significano cose diverse.

Domande frequenti

Rileva i proxy residenziali?

No. Le liste attuali coprono VPN commerciali note, Tor, datacenter e reti di minaccia/sanzionate — non la categoria più ampia dei servizi proxy residenziali, che instradano attraverso veri indirizzi IP di consumatori e sono molto più difficili da abbinare tramite liste.

Cosa significa false?

Nessuna corrispondenza nelle liste attualmente caricate da Watch-IP. Non è un'affermazione positiva che la connessione sia sicura, poiché una lista non può coprire ogni VPN, nodo di uscita o rete dannosa esistente.

Tor su IPv6 è coperto?

No. isTor è sempre false per una connessione IPv6 oggi — non esiste una fonte gratuita di elenco dei nodi di uscita Tor per IPv6 nell'implementazione attuale. Ogni altro campo copre invece IPv6.

Questi controlli sono disponibili per IP arbitrari?

Non attualmente. Questi dati fanno parte della risposta GET /v1/geo solo per il browser in connessione; gli endpoint di ricerca IP separati (/v1/lookup) non restituiscono un blocco security.

Posso bloccare basandomi solo su un flag?

Puoi, ma un singolo flag basato su liste è una base debole per un blocco automatico da solo — i falsi positivi accadono, e gli utenti legittimi passano attraverso VPN e reti condivise per motivi ordinari. La maggior parte delle integrazioni usa questi campi come un input a una decisione di revisione.