VU Cloud Services

Un navegador puede mentir sobre su identidad. Su conexión, no.

Un script puede hacerse pasar por Chrome con una línea de código. Lo que no puede cambiar tan fácilmente es cómo arma la conexión. Connection Fingerprint se llama desde el navegador del usuario y devuelve la huella TLS, la huella de las cabeceras, la ubicación aproximada y dos identificadores persistentes (cookie y ETag). Todo viene firmado por VU para que tu backend pueda verificarlo.

Navegador realCoinciden

Seguridad respaldada por certificaciones y ensayos independientes

ISO/IEC 27001:2022

Gestión de seguridad de la información

ISO/IEC 27017:2015

Seguridad en servicios de nube

El problema

Las cabeceras las controla quien se conecta

Un script que se hace pasar por un navegador moderno envía el mismo user-agent que una persona real. Además, los identificadores guardados en el navegador desaparecen en cuanto alguien borra las cookies o usa la navegación privada. Si tu control de riesgo depende de lo que el dispositivo dice de sí mismo, un bot bien disfrazado pasa sin problemas y un cliente que regresa aparece como nuevo.

  • La conexión respondió✓ 200
  • El user-agent dice ser un navegador✓ Chrome
  • Las cabeceras llegaron completas✓ presentes
  • ¿Se conecta como un navegador?GREASE "0"
Nuestra solución

Señales firmadas de la conexión, listas para tu motor de riesgo

Connection Fingerprint obtiene sus señales de la propia conexión: la huella TLS, la huella de las cabeceras, la ubicación geográfica aproximada y dos identificadores persistentes (cookie y ETag). No requiere SDK ni ejecuta código en el cliente. Tampoco decide por ti: entrega señales y tu lógica de riesgo define qué hacer con ellas.

Caso 01

Ya tienes un motor de riesgo

No tienes que cambiar nada de lo que ya funciona. Solo agregas una señal más, con una llamada desde el navegador y una verificación en tu backend.

Caso 02

Quieres reconocer dispositivos que regresan

La cookie dura un año y el ETag suele mantenerse aunque el usuario borre las cookies. Si uno se renueva y el otro no, eso también te dice algo.

Caso 03

Sospechas de bots que se hacen pasar por navegadores

Comparas lo que el cliente declara con la forma en que se conecta. Si el user-agent dice Chrome pero el handshake no es de Chrome, alguien está mintiendo sobre lo que es.

Características principales

Tres capas de conexión en una sola respuesta

La llamada sale del navegador y atraviesa tres capas. Lo que vuelve es una respuesta firmada, con los identificadores para reconocer al dispositivo la próxima vez.

La llamada sale del navegador del usuario GET /

Capa 01 · TLS

Huella TLS (JA3)

versión, cifrados, extensiones y curvas

tlsFingerprintHash
Capa 02 · HTTP

Huella de cabeceras

orden y presencia, además del contenido

headerSignature
Capa 03 · Red

Ubicación aproximada

país y región, con su radio de precisión

geoData

Vuelve una respuesta firmada

Con los identificadores para reconocer al dispositivo la próxima vez.

  • cookie · 1 año
  • ETag · sobrevive al borrado
  • signature · RSA 4096

Qué trae cada respuesta

  • Coherencia entre señales

    Lo más revelador es si todos los campos cuentan la misma historia. Ninguna señal basta por sí sola: el valor está en combinarlas con tu propio contexto.

  • Dos identificadores, dos vidas

    La cookie desaparece cuando el usuario la borra; el ETag vive en la caché HTTP y suele mantenerse. Conviene guardar los dos asociados a la cuenta.

  • Firma que verificas tú

    La respuesta pasa por el navegador antes de llegar a tu backend. La firma RSA de 4096 bits te permite confirmar que nadie la alteró en el camino.

  • Sin SDK ni JavaScript de rastreo

    No ejecuta código en el cliente ni depende de APIs del navegador que los modos de privacidad suelen bloquear. Es solo una llamada HTTP.

La integración

Una llamada desde el navegador y una verificación en tu backend

A diferencia de las otras APIs de VU Cloud Services, que se llaman desde tu servidor, esta llamada se hace desde el dispositivo del usuario, porque la huella describe justamente esa conexión. El navegador envía la respuesta a tu backend, que verifica la firma antes de usar los datos.

ElementoCómo funciona
GET /La huella de la conexión actual, con la firma. Se llama desde el navegador
GET /publicKeyLa clave pública RSA para verificar signature. La pides una vez y la guardas en caché
GET /versionLa versión del servicio
AutenticaciónNinguna en /, /publicKey ni /version: el navegador tiene que poder llamarlos. Lo que protege la integración es la verificación de la firma
AltaVU registra en su lista CORS los orígenes de cada ambiente (esquema, host y puerto) antes de la primera llamada
URL basehttps://fingerprint.api.vusecurity.com
SalidauserData (huella TLS, cabeceras, headerSignature, cookie, etag, geoData, ip) y signature
PeticiónDesde el navegador
const res = await fetch("https://fingerprint.api.vusecurity.com/", {
  credentials: "include" // sin esto, la cookie fp no viaja
});
// La respuesta va tal cual a tu backend, sin reordenar nada.
  • user-agent de navegador + GREASE "0"Cliente automatizado disfrazado. Lo cruzas con el orden de las cabeceras.
  • hash conocido + cookie y etag nuevosUn dispositivo reconocible que perdió el estado.
  • misma cookie + hash distintoUna actualización del navegador, o una cookie robada. Miras la ventana de tiempo y el origen.
La regla de decisiónTu backend
// 1. Antes que nada, la firma, sobre el cuerpo crudo.
if (!verificarFirma(cuerpoCrudo, clavePublica)) return noVerificada();

// 2. Solo después, las señales. Ninguna decide sola.
const d = JSON.parse(cuerpoCrudo).userData;
const incoherente =
  userAgentDiceNavegador(d.headers) &&
  d.tlsFingerprintSslGreased === "0";

// 3. El hash agrupa clientes; nunca autentica a una persona.

Sin credentials: "include", la persistencia se pierde en silencio

Si la llamada no incluye las credenciales, la cookie no se envía ni se guarda y el servicio emite un identificador nuevo en cada visita. La respuesta sigue llegando con 200 y todos los campos presentes, así que nada avisa que perdiste la mitad del valor.

Y nunca la llames desde tu servidor en nombre del usuario: devolvería la huella de tu backend, idéntica para todos tus usuarios.

Antes de salir a producción

Lo que tiene que estar listo antes del primer usuario real

AspectoQué revisar
OrígenesLos dominios de desarrollo, pruebas y producción, registrados en VU
La llamadaSe hace desde el cliente, siempre con credentials: "include"
La firmaEl cuerpo de la respuesta llega sin modificar al verificador, que usa el algoritmo acordado con VU*
La ubicaciónCada campo de geoData se trata como opcional y se interpreta junto con su accuracyRadius
Si no respondeTu evaluación de riesgo tiene un plan alternativo y sigue funcionando con menos señales, sin caerse

*Antes de implementar la verificación, confirma con VU el algoritmo de hash y cómo se serializa userData. Si el objeto se vuelve a serializar con otro formato, la firma falla aunque los datos sean auténticos.

VU no responde · degrada, no se caeNavegadorVUTu backendMotor de riesgofirma verificadacredentials: includesignatureseñales
Este servicio genera datos personalesDirección IP, ubicación aproximada e identificadores persistentes del dispositivo. Bajo el GDPR, la LGPD o normas equivalentes, su uso requiere una base legal, informar al titular y definir un plazo de retención. Involucra a tu equipo legal antes de salir a producción y guarda solo lo que tu motor de riesgo realmente usa.
Cómo empiezas

Empieza hablando con VU

Connection Fingerprint no usa API key: VU lo habilita para los dominios desde los que lo vas a llamar.

  1. 02

    Envías tus orígenesuno por ambiente: esquema, host y puerto

  2. 03

    VU los registraen su lista CORS, antes de la primera llamada

  3. 04

    Llamas a GET / desde tu sitiocon credentials: "include"

  4. 05

    Verificas la firma en tu backendcon la clave de GET /publicKey

  5. 06

    Usas las señales en tu motor de riesgojunto con tu propio contexto

Preguntas frecuentes

No. Es una señal más para el motor de riesgo que ya tienes. Convive con tu proveedor actual y con cualquier otro servicio de VU Cloud Services.
Porque la huella describe la conexión del usuario. Si la llamada saliera de tu servidor, obtendrías la huella de tu propio servidor, no la del dispositivo que quieres evaluar. Para que nadie pueda alterar la respuesta en el camino, VU la firma y tu backend la verifica antes de usarla.
No en el navegador: la llamada se autoriza a partir de los orígenes que VU registra, así que no expones ninguna clave en el cliente. Para verificar la firma en tu backend solo necesitas la clave pública que te entrega VU.
No. La huella TLS describe cómo se conecta un navegador o una herramienta, y muchos usuarios con el mismo navegador comparten la misma huella. Su valor está en compararla con lo que el cliente declara y en combinarla con los identificadores persistentes y tu propio contexto.
Es aproximada: se obtiene a partir de la dirección IP y suele ser útil a nivel de país o ciudad, no de dirección. Cada respuesta incluye un accuracyRadius que indica el margen de error. Una VPN o un proxy pueden mostrar una ubicación distinta a la real.
La dirección IP, la ubicación aproximada y dos identificadores persistentes del dispositivo (cookie y ETag). Bajo el GDPR, la LGPD o normas equivalentes, su uso requiere una base legal, informar al titular y definir un plazo de retención. Te recomendamos guardar solo lo que tu motor de riesgo realmente usa.

Ya sabes lo que el dispositivo dice. Falta ver cómo se conecta.

Habla con VU y suma la huella de la conexión a tu motor de riesgo.