Agrega señales de VPN y Tor a la geolocalización de visitantes

Comprende cuándo la conexión de un visitante coincide con una red VPN conocida, un nodo de salida de Tor, una red de centro de datos/hosting, u otra categoría de red compatible. Watch-IP agrega estos indicadores a las respuestas elegibles de GET /v1/geo para que tu aplicación pueda ponderarlos junto con otro contexto.

Consulta qué planes incluyen seguridad Lee la referencia de geo →

Planes elegibles

security se incluye en los planes Starter, Growth, Scale y Enterprise. Se omite por completo de la respuesta en el plan Free — no se envía como un objeto engañoso con todo en false — así que verifica su presencia antes de leer cualquier campo de él.

La cobertura de IPv4 e IPv6 difiere

Las conexiones IPv4 se verifican contra listas de Tor, VPN, centro de datos, amenaza y redes sancionadas. Las conexiones IPv6 se verifican contra todo excepto Tor — actualmente no existe una fuente gratuita de lista de salida de Tor para IPv6, así que isTor siempre es false para una conexión IPv6, sin importar si en realidad es un nodo de salida de Tor. No describas la cobertura de IPv6 como equivalente a la de IPv4.

Omitido, false y true son estados distintos

Un objeto security omitido significa que tu plan no incluye estos datos, no que la conexión se haya verificado y encontrado limpia. Un valor false en un campo incluido significa que no hubo coincidencia en las listas actualmente cargadas de Watch-IP — no es un veredicto de seguridad confirmado, ya que la detección basada en listas no puede verlo todo. Nunca muestres un resultado no evaluado o false como "Limpio", "Seguro" o "Verificado".

Fuentes y actualizaciones

Las listas detrás de estos campos se compilan y almacenan en nuestro propio almacenamiento y se actualizan según un cronograma. Un inicio en frío se bloquea brevemente en su primera consulta; una vez cargada, una solicitud se atiende desde una caché en memoria mientras una actualización se ejecuta en segundo plano, así que una actualización lenta o fallida degrada a datos obsoletos o vacíos en lugar de una respuesta rota.

Un flujo de revisión de ejemplo

Trata isVpn o isDatacenter como una entrada más para una cola de revisión manual junto con el historial de la cuenta y otras señales, no como el único motivo para bloquear a un visitante por completo. Combinarlo con una verificación de correo desechable en el mismo evento de registro, por ejemplo, es una forma razonable de enviar a revisión a un pequeño número de registros en lugar de rechazar a todos los usuarios de VPN.

Lo que esto no hace

Estos campos no identifican proxies residenciales, no verifican identidad, y no son un producto integral de detección de amenazas o anonimato — son un pequeño conjunto de indicadores basados en listas.

Campos de respuesta de seguridad

isTor: Nodo de salida de Tor conocido, según la lista de salida de IPv4 actualmente cargada. Siempre false para IPv6.
isVpn: Red de proveedor de VPN comercial conocida, IPv4 e IPv6.
isDatacenter: Red de centro de datos/hosting — un superconjunto de VPN, ya que muchas salidas de VPN se ejecutan en infraestructura de hosting.
isThreat: En un rango de IP conocido como malicioso o un ASN conocido por amenazas, IPv4 e IPv6.
isSanctionedNetwork: En una lista mantenida por Watch-IP de operadores de red de telecomunicaciones/hosting sancionados por un estado, revisada trimestralmente — una señal más suave y de menor confianza que los demás campos, no una verificación de cumplimiento de sanciones.

Lee los campos de seguridad de forma segura

JavaScript de navegador

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) {
  // Tu plan no incluye datos de seguridad — no asumas nada sobre esta conexión.
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // Una coincidencia en la lista — una entrada más para tu propia lógica de revisión, no un bloqueo por sí sola.
} else {
  // No hubo coincidencia en las listas actualmente cargadas — no es una garantía de que la conexión sea segura.
}

Verifica siempre si `security` está presente antes de leer un campo de él — un objeto ausente y un campo presente pero en false significan cosas distintas.

Preguntas frecuentes

¿Detecta proxies residenciales?

No. Las listas actuales cubren redes conocidas de VPN comercial, Tor, centro de datos y amenaza/sancionadas — no la categoría más amplia de servicios de proxy residencial, que enrutan a través de direcciones IP de consumidores reales y son mucho más difíciles de comparar con listas.

¿Qué significa false?

No hubo coincidencia en las listas que Watch-IP tiene cargadas actualmente. No es una afirmación positiva de que la conexión sea segura, ya que una lista no puede cubrir cada VPN, nodo de salida o red maliciosa existente.

¿Está cubierto Tor sobre IPv6?

No. isTor siempre es false para una conexión IPv6 hoy en día — no hay una fuente gratuita de lista de salida de Tor para IPv6 en la implementación actual. Todos los demás campos sí cubren IPv6.

¿Estas verificaciones están disponibles para IP arbitrarias?

No actualmente. Estos datos forman parte de la respuesta de GET /v1/geo solo para el navegador que se conecta; los endpoints de búsqueda de IP independientes (/v1/lookup) no devuelven un bloque security.

¿Puedo bloquear únicamente con base en una marca?

Puedes, pero una sola marca basada en listas es una base débil para un bloqueo automático por sí sola — ocurren falsos positivos, y usuarios legítimos usan VPN y redes compartidas por razones ordinarias. La mayoría de las integraciones usan estos campos como una entrada más para una decisión de revisión.