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
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"
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 é.
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 /
Impressão digital TLS (JA3)
versão, cifras, extensões e curvas
tlsFingerprintHashImpressão digital dos cabeçalhos
ordem e presença, além do conteúdo
headerSignatureLocalização aproximada
país e região, com seu raio de precisão
geoDataVolta 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.
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.
| Elemento | Como funciona |
|---|---|
| GET / | A impressão digital da conexão atual, com a assinatura. É chamado a partir do navegador |
| GET /publicKey | A chave pública RSA para verificar signature. Você a solicita uma vez e a guarda em cache |
| GET /version | A versão do serviço |
| Autenticação | Nenhuma em /, /publicKey nem /version: o navegador precisa poder chamá-los. O que protege a integração é a verificação da assinatura |
| Cadastro | A VU registra na sua lista CORS as origens de cada ambiente (esquema, host e porta) antes da primeira chamada |
| URL base | https://fingerprint.api.vusecurity.com |
| Saída | userData (impressão digital TLS, cabeçalhos, headerSignature, cookie, etag, geoData, ip) e signature |
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.
// 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.
O que precisa estar pronto antes do primeiro usuário real
| Aspecto | O que verificar |
|---|---|
| Origens | Os domínios de desenvolvimento, testes e produção, registrados na VU |
| A chamada | É feita a partir do cliente, sempre com credentials: "include" |
| A assinatura | O corpo da resposta chega sem modificações ao verificador, que usa o algoritmo combinado com a VU* |
| A localização | Cada campo de geoData é tratado como opcional e interpretado junto com seu accuracyRadius |
| Se não responder | Sua 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.
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.
- 01Você fala com um especialista da VUpara contratar o serviço
- 02
Você envia suas origensuma por ambiente: esquema, host e porta
- 03
A VU as registrana sua lista CORS, antes da primeira chamada
- 04
Você chama GET / a partir do seu sitecom credentials: "include"
- 05
Você verifica a assinatura no seu backendcom a chave de GET /publicKey
- 06
Você usa os sinais no seu motor de riscojunto com o seu próprio contexto
Perguntas frequentes
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.