Serviços em nuvem da VU

Um navegador pode mentir sobre sua identidade. Sua conexão, não.

Um script pode se passar pelo Chrome com uma linha de código. O que ele não consegue mudar tão facilmente é como monta a conexão. O Connection Fingerprint é chamado a partir do navegador do usuário e devolve a impressão digital TLS, a impressão digital dos cabeçalhos, a localização aproximada e dois identificadores persistentes (cookie e ETag). Tudo vem assinado pela VU para que seu backend possa verificá-lo.

Navegador realCoincidem

Segurança respaldada por certificações e testes independentes

ISO/IEC 27001:2022

Gestão de segurança da informação

ISO/IEC 27017:2015

Segurança em serviços de nuvem

O problema

Os cabeçalhos são controlados por quem se conecta

Um script que se passa por um navegador moderno envia o mesmo user-agent que uma pessoa real. Além disso, os identificadores guardados no navegador desaparecem assim que alguém apaga os cookies ou usa a navegação anônima. Se o seu controle de risco depende do que o dispositivo diz sobre si mesmo, um bot bem disfarçado passa sem problemas e um cliente que volta aparece como novo.

  • A conexão respondeu✓ 200
  • O user-agent diz ser um navegador✓ Chrome
  • Os cabeçalhos chegaram completos✓ presentes
  • Ele se conecta como um navegador?GREASE "0"
Nossa solução

Sinais assinados da conexão, prontos para o seu motor de risco

O Connection Fingerprint obtém seus sinais da própria conexão: a impressão digital TLS, a impressão digital dos cabeçalhos, a localização geográfica aproximada e dois identificadores persistentes (cookie e ETag). Não exige SDK nem executa código no cliente. Também não decide por você: entrega sinais, e sua lógica de risco define o que fazer com eles.

Caso 01

Você já tem um motor de risco

Você não precisa mudar nada do que já funciona. Só adiciona mais um sinal, com uma chamada a partir do navegador e uma verificação no seu backend.

Caso 02

Você quer reconhecer dispositivos que voltam

O cookie dura um ano e o ETag costuma se manter mesmo que o usuário apague os cookies. Se um é renovado e o outro não, isso também diz algo.

Caso 03

Você suspeita de bots que se passam por navegadores

Você compara o que o cliente declara com a forma como ele se conecta. Se o user-agent diz Chrome, mas o handshake não é do Chrome, alguém está mentindo sobre o que é.

Características principais

Três camadas da conexão em uma única resposta

A chamada sai do navegador e atravessa três camadas. O que volta é uma resposta assinada, com os identificadores para reconhecer o dispositivo na próxima vez.

A chamada sai do navegador do usuário GET /

Camada 01 · TLS

Impressão digital TLS (JA3)

versão, cifras, extensões e curvas

tlsFingerprintHash
Camada 02 · HTTP

Impressão digital dos cabeçalhos

ordem e presença, além do conteúdo

headerSignature
Camada 03 · Rede

Localização aproximada

país e região, com seu raio de precisão

geoData

Volta uma resposta assinada

Com os identificadores para reconhecer o dispositivo na próxima vez.

  • cookie · 1 ano
  • ETag · sobrevive à limpeza
  • signature · RSA 4096

O que cada resposta traz

  • Coerência entre sinais

    O mais revelador é se todos os campos contam a mesma história. Nenhum sinal basta sozinho: o valor está em combiná-los com o seu próprio contexto.

  • Dois identificadores, duas vidas

    O cookie desaparece quando o usuário o apaga; o ETag fica no cache HTTP e costuma se manter. Convém guardar os dois associados à conta.

  • Uma assinatura que você verifica

    A resposta passa pelo navegador antes de chegar ao seu backend. A assinatura RSA de 4096 bits permite confirmar que ninguém a alterou no caminho.

  • Sem SDK nem JavaScript de rastreamento

    Não executa código no cliente nem depende de APIs do navegador que os modos de privacidade costumam bloquear. É só uma chamada HTTP.

A integração

Uma chamada a partir do navegador e uma verificação no seu backend

Diferentemente das outras APIs dos serviços em nuvem da VU, que são chamadas a partir do seu servidor, esta chamada é feita a partir do dispositivo do usuário, porque a impressão digital descreve justamente essa conexão. O navegador envia a resposta ao seu backend, que verifica a assinatura antes de usar os dados.

ElementoComo funciona
GET /A impressão digital da conexão atual, com a assinatura. É chamado a partir do navegador
GET /publicKeyA chave pública RSA para verificar signature. Você a solicita uma vez e a guarda em cache
GET /versionA versão do serviço
AutenticaçãoNenhuma em /, /publicKey nem /version: o navegador precisa poder chamá-los. O que protege a integração é a verificação da assinatura
CadastroA VU registra na sua lista CORS as origens de cada ambiente (esquema, host e porta) antes da primeira chamada
URL basehttps://fingerprint.api.vusecurity.com
SaídauserData (impressão digital TLS, cabeçalhos, headerSignature, cookie, etag, geoData, ip) e signature
RequisiçãoA partir do navegador
const res = await fetch("https://fingerprint.api.vusecurity.com/", {
  credentials: "include" // sem isso, o cookie fp não viaja
});
// A resposta vai para o seu backend do jeito que chegou, sem reordenar nada.
  • user-agent de navegador + GREASE "0"Cliente automatizado disfarçado. Você o cruza com a ordem dos cabeçalhos.
  • hash conhecido + cookie e etag novosUm dispositivo reconhecível que perdeu o estado.
  • mesmo cookie + hash diferenteUma atualização do navegador, ou um cookie roubado. Você olha a janela de tempo e a origem.
A regra de decisãoSeu backend
// 1. Antes de tudo, a assinatura, sobre o corpo bruto.
if (!verificarAssinatura(corpoBruto, chavePublica)) return naoVerificada();

// 2. Só depois, os sinais. Nenhum decide sozinho.
const d = JSON.parse(corpoBruto).userData;
const incoerente =
  userAgentDizNavegador(d.headers) &&
  d.tlsFingerprintSslGreased === "0";

// 3. O hash agrupa clientes; nunca autentica uma pessoa.

Sem credentials: "include", a persistência se perde em silêncio

Se a chamada não incluir as credenciais, o cookie não é enviado nem guardado, e o serviço emite um identificador novo a cada visita. A resposta continua chegando com 200 e todos os campos presentes, então nada avisa que você perdeu metade do valor.

E nunca a chame a partir do seu servidor em nome do usuário: ela devolveria a impressão digital do seu backend, idêntica para todos os seus usuários.

Antes de ir para produção

O que precisa estar pronto antes do primeiro usuário real

AspectoO que verificar
OrigensOs domínios de desenvolvimento, testes e produção, registrados na VU
A chamadaÉ feita a partir do cliente, sempre com credentials: "include"
A assinaturaO corpo da resposta chega sem modificações ao verificador, que usa o algoritmo combinado com a VU*
A localizaçãoCada campo de geoData é tratado como opcional e interpretado junto com seu accuracyRadius
Se não responderSua avaliação de risco tem um plano alternativo e continua funcionando com menos sinais, sem cair

*Antes de implementar a verificação, confirme com a VU o algoritmo de hash e como userData é serializado. Se o objeto for serializado novamente em outro formato, a assinatura falha mesmo que os dados sejam autênticos.

VU não responde · degrada, não caiNavegadorVUSeu backendMotor de riscoassinatura verificadacredentials: includesignaturesinais
Este serviço gera dados pessoaisEndereço IP, localização aproximada e identificadores persistentes do dispositivo. Pelo GDPR, pela LGPD ou por normas equivalentes, seu uso exige uma base legal, informar o titular e definir um prazo de retenção. Envolva sua equipe jurídica antes de ir para produção e guarde só o que o seu motor de risco realmente usa.
Como começar

Comece falando com a VU

O Connection Fingerprint não usa API key: a VU o habilita para os domínios a partir dos quais você vai chamá-lo.

  1. 02

    Você envia suas origensuma por ambiente: esquema, host e porta

  2. 03

    A VU as registrana sua lista CORS, antes da primeira chamada

  3. 04

    Você chama GET / a partir do seu sitecom credentials: "include"

  4. 05

    Você verifica a assinatura no seu backendcom a chave de GET /publicKey

  5. 06

    Você usa os sinais no seu motor de riscojunto com o seu próprio contexto

Perguntas frequentes

Não. É mais um sinal para o motor de risco que você já tem. Convive com o seu fornecedor atual e com qualquer outro serviço em nuvem da VU.
Porque a impressão digital descreve a conexão do usuário. Se a chamada saísse do seu servidor, você obteria a impressão digital do seu próprio servidor, não a do dispositivo que quer avaliar. Para que ninguém possa alterar a resposta no caminho, a VU a assina e o seu backend a verifica antes de usá-la.
Não no navegador: a chamada é autorizada a partir das origens que a VU registra, então você não expõe nenhuma chave no cliente. Para verificar a assinatura no seu backend, você só precisa da chave pública que a VU fornece.
Não. A impressão digital TLS descreve como um navegador ou uma ferramenta se conecta, e muitos usuários com o mesmo navegador compartilham a mesma impressão digital. Seu valor está em compará-la com o que o cliente declara e em combiná-la com os identificadores persistentes e o seu próprio contexto.
É aproximada: é obtida a partir do endereço IP e costuma ser útil no nível de país ou cidade, não de endereço. Cada resposta inclui um accuracyRadius que indica a margem de erro. Uma VPN ou um proxy podem mostrar uma localização diferente da real.
O endereço IP, a localização aproximada e dois identificadores persistentes do dispositivo (cookie e ETag). Pelo GDPR, pela LGPD ou por normas equivalentes, seu uso exige uma base legal, informar o titular e definir um prazo de retenção. Recomendamos guardar só o que o seu motor de risco realmente usa.

Você já sabe o que o dispositivo diz. Falta ver como ele se conecta.

Fale com a VU e adicione a impressão digital da conexão ao seu motor de risco.