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
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"
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.
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 /
Huella TLS (JA3)
versión, cifrados, extensiones y curvas
tlsFingerprintHashHuella de cabeceras
orden y presencia, además del contenido
headerSignatureUbicación aproximada
país y región, con su radio de precisión
geoDataVuelve 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.
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.
| Elemento | Cómo funciona |
|---|---|
| GET / | La huella de la conexión actual, con la firma. Se llama desde el navegador |
| GET /publicKey | La clave pública RSA para verificar signature. La pides una vez y la guardas en caché |
| GET /version | La versión del servicio |
| Autenticación | Ninguna en /, /publicKey ni /version: el navegador tiene que poder llamarlos. Lo que protege la integración es la verificación de la firma |
| Alta | VU registra en su lista CORS los orígenes de cada ambiente (esquema, host y puerto) antes de la primera llamada |
| URL base | https://fingerprint.api.vusecurity.com |
| Salida | userData (huella TLS, cabeceras, headerSignature, cookie, etag, geoData, ip) y signature |
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.
// 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.
Lo que tiene que estar listo antes del primer usuario real
| Aspecto | Qué revisar |
|---|---|
| Orígenes | Los dominios de desarrollo, pruebas y producción, registrados en VU |
| La llamada | Se hace desde el cliente, siempre con credentials: "include" |
| La firma | El cuerpo de la respuesta llega sin modificar al verificador, que usa el algoritmo acordado con VU* |
| La ubicación | Cada campo de geoData se trata como opcional y se interpreta junto con su accuracyRadius |
| Si no responde | Tu 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.
Empieza hablando con VU
Connection Fingerprint no usa API key: VU lo habilita para los dominios desde los que lo vas a llamar.
- 01Hablas con un experto de VUpara contratar el servicio
- 02
Envías tus orígenesuno por ambiente: esquema, host y puerto
- 03
VU los registraen su lista CORS, antes de la primera llamada
- 04
Llamas a GET / desde tu sitiocon credentials: "include"
- 05
Verificas la firma en tu backendcon la clave de GET /publicKey
- 06
Usas las señales en tu motor de riesgojunto con tu propio contexto
Preguntas frecuentes
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.