Usa cambios de ubicación para informar la revisión de inicios de sesión

Compara la ubicación derivada de la IP de un inicio de sesión con el punto anterior almacenado para ese usuario, para marcar los inicios de sesión que merecen una segunda mirada — la disponibilidad y la aplicación del plan para este endpoint aún no están confirmadas, así que conversa sobre el acceso antes de integrarlo en producción.

Conversa sobre el acceso a la verificación de riesgo Lee la referencia de verificación de riesgo →

Disponibilidad

POST /v1/risk/check comparte el mismo middleware de clave secreta que la búsqueda de IP, el cual verifica que una clave sea una clave secreta — no aplica de forma independiente una familia de planes de riesgo separada, y el precio de riesgo sembrado no tiene un precio activo configurado. Confirma la disponibilidad y los términos actuales con nosotros antes de depender de este endpoint en producción.

Extracción confiable de la IP del cliente

Watch-IP no extrae la IP del usuario final de tu solicitud para este endpoint — tú la proporcionas como ip. Resuélvela a partir de tu propia cadena de encabezados de proxy/CDN de confianza en tu backend, con el mismo cuidado que aplicarías en cualquier lugar donde confíes en una IP de cliente para una decisión de seguridad.

ID de usuario opaco

Pasa tu propio identificador interno como userId. Watch-IP mantiene exactamente una ubicación almacenada por cada par (tu cuenta de cliente, userId) — reutiliza el mismo identificador en los inicios de sesión de un usuario para que la línea base siga siendo significativa.

Primera línea base, luego una verificación previa

La primera llamada de un usuario siempre devuelve risk: "low" con un previousLocation nulo — todavía no hay nada con qué comparar. Para inicios de sesión posteriores, llama con commit: false como una señal temprana antes de tu propia decisión de autenticación; esa llamada lee la línea base almacenada sin modificarla.

Confirma después de tu propia verificación

Una vez que estés seguro de que el inicio de sesión es legítimo — contraseña y cualquier segundo factor ya verificados — vuelve a llamar con commit en su valor predeterminado (true) para que esta observación se convierta en la nueva línea base para el próximo inicio de sesión.

Concurrencia y reintentos

v1 almacena un único punto más reciente, no un historial — dos llamadas confirmadas seguidas en poco tiempo sobrescriben el mismo valor, y una solicitud reintentada después de un tiempo de espera puede confirmarse por sí misma y desplazar la línea base. Diseña tu lógica de reintentos teniendo esto en cuenta, en lugar de asumir que cada confirmación se registra de forma independiente.

Cambios legítimos de red

Los viajes de negocios, el wifi de hotel o aeropuerto, el cambio de IP de un operador móvil y el uso habitual de VPN pueden producir una clasificación media o alta — v1 no tiene supresión consciente de VPN/centro de datos. Trata un inicio de sesión marcado como una entrada más para tu propio proceso de revisión, no como prueba de compromiso.

Lo que esto no garantiza

Una clasificación alta es un cálculo bruto de velocidad entre dos puntos, no una confirmación de robo de cuenta, y una clasificación baja no exime a un inicio de sesión que sea sospechoso por otras razones. La retención sigue el comportamiento de almacenamiento anterior: el punto almacenado persiste hasta que la siguiente verificación confirmada lo sobrescriba, sin expiración automática y sin un endpoint de eliminación disponible actualmente — ten esto en cuenta en cualquier compromiso de retención de datos que hagas con tus propios usuarios.