Analisador de agente do usuário

O Analisador de agente do usuário é uma ferramenta gratuita que lê uma string de agente do usuário e informa o navegador, o sistema operacional e o tipo de dispositivo.

O que uma string de agente do usuário informa?

Uma string de agente do usuário é o valor do campo HTTP User-Agent. No caso de um navegador, ela geralmente contém nomes de produtos, números de versão, identificadores do sistema operacional e pistas sobre o dispositivo. Clientes de linha de comando, rastreadores, leitores de feeds e navegadores integrados a aplicativos também podem enviar strings de agente do usuário.

O formato é menos organizado do que parece. Os navegadores costumam incluir identificadores de compatibilidade associados a outros navegadores. Por isso, considerar apenas o primeiro nome de produto reconhecível pode levar a um resultado incorreto. Navegadores baseados no Chromium, por exemplo, normalmente incluem identificadores relacionados tanto ao Chrome quanto ao Safari. Um analisador avalia a combinação e a ordem desses identificadores, em vez de tratar o valor como uma lista simples.

Além disso, os dados do agente do usuário são declarados pelo próprio cliente. Ele pode alterá-los ou inventá-los, e alguns navegadores reduzem a quantidade de informações expostas sobre versão e dispositivo. Portanto, os dados analisados são úteis para classificação e depuração, mas não comprovam a identidade de um dispositivo.

Como usar o analisador de agente do usuário?

Cole o valor completo do cabeçalho no campo Agente do usuário e execute a ferramenta. Ela retorna três campos: Navegador, Sistema operacional e Tipo de dispositivo.

1. Copie o valor depois de User-Agent em uma solicitação HTTP, um log de acesso ou nas ferramentas para desenvolvedores do navegador.
2. Mantenha os espaços, parênteses, colchetes, pontos e vírgulas, barras e números de versão originais. Esses caracteres separam os produtos e comentários dentro da string.
3. Envie o valor e compare as classificações retornadas com o contexto da solicitação.
4. Nas suas anotações de depuração, mantenha a string original junto com o resultado analisado. A classificação isolada pode ocultar identificadores úteis de versão ou compatibilidade.

O analisador é executado no servidor. A string de agente do usuário é enviada ao servidor por HTTPS e não é armazenada. Mesmo assim, antes do envio, verifique se as entradas copiadas do log contêm parâmetros de consulta sem relação com a análise, identificadores de sessão ou nomes de host internos.

Como interpretar o resultado da análise?

Interprete cada campo como uma classificação deduzida a partir dos identificadores fornecidos pelo cliente, não como informações de hardware ou software verificadas de forma independente.

• Navegador identifica a família do navegador ou cliente reconhecida na string. Navegadores integrados e derivados do Chromium podem ser mais difíceis de distinguir, pois compartilham muitos identificadores.
• Sistema operacional informa a plataforma indicada por marcadores como Windows NT, Android, iPhone OS, Mac OS X ou Linux. Camadas de compatibilidade e agentes do usuário modificados podem tornar essa informação menos específica.
• Tipo de dispositivo classifica o cliente em uma categoria ampla de formato, deduzida a partir de marcadores do dispositivo e da plataforma. Considere esse resultado uma categoria prática, não um modelo exato de hardware.

Os campos de resultado documentados não constituem um relatório de validação de sintaxe. Um agente do usuário malformado, abreviado ou desconhecido pode não conter informações suficientes para uma classificação útil, mas não existe uma lista universal de erros comparável aos erros de JSON, como vírgulas finais ou chaves sem aspas. A análise de agentes do usuário é principalmente heurística, pois as strings reais variam entre os clientes e muitas vezes preservam sintaxes antigas de compatibilidade.

Um valor vazio não contém nada que possa ser classificado. Valores muito longos podem incluir extensões, identificadores de aplicativos ou identificadores de produtos duplicados. Já os números normalmente só fazem sentido ao lado do identificador de produto ao qual se referem. Caracteres acentuados ou não latinos podem aparecer em strings personalizadas de clientes, mas não identificam automaticamente um navegador, sistema operacional ou dispositivo.

Exemplos práticos

Entrada Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36

Normalmente, um analisador classificaria essa string como Chrome no Windows e como um dispositivo desktop. O identificador do Safari está presente por compatibilidade e, sozinho, não deve fazer com que o navegador seja classificado como Safari.

Entrada Mozilla/5.0 (iPhone; CPU iPhone OS 17_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1

Essa string indica o Safari no iOS e um dispositivo móvel. A expressão "like Mac OS X" faz parte das informações de compatibilidade. Os marcadores iPhone e Mobile fornecem indícios mais fortes sobre o dispositivo.

Quando um agente do usuário é capturado dentro de um parâmetro de consulta de uma URL, ele pode estar codificado por porcentagem. Use o Analisador de URL para isolar e decodificar o parâmetro antes de analisar o valor resultante do agente do usuário.

Quando vale a pena analisar um agente do usuário?

A análise é útil quando você precisa entender uma solicitação desconhecida ou verificar a lógica de classificação antes da implantação. Alguns casos comuns são examinar uma entrada de log de acesso do Apache ou nginx, investigar um relato de problema de renderização específico de um navegador, conferir o tráfego de um aplicativo integrado ou ler dados brutos exportados de uma plataforma de análise.

Em geral, não vale a pena fazer a análise quando outro sistema já fornece o navegador, o sistema operacional e o dispositivo em campos estruturados. Também há pouco benefício se o seu serviço precisa apenas encaminhar ou arquivar o cabeçalho original. Não use o resultado como único critério para autenticação, detecção de fraude ou controle de acesso, pois o remetente pode falsificar a string.

Para layouts responsivos, consultas de mídia CSS e detecção de recursos costumam ser mais confiáveis do que estimativas de dispositivo feitas no servidor. Analise o agente do usuário quando precisar de contexto para diagnóstico ou relatórios, e não para presumir que um recurso específico é compatível com determinado navegador.

Perguntas frequentes

O analisador consegue identificar se uma solicitação veio de um bot?

Os campos retornados não incluem uma classificação específica para bots. Alguns rastreadores se identificam claramente no agente do usuário, mas outros imitam navegadores ou omitem detalhes úteis. Quando apropriado, confirme o tráfego automatizado por padrões de frequência, verificações publicadas de IPs de rastreadores e pelo comportamento das solicitações.

Por que o agente do usuário do Edge menciona Chrome e Safari?

O Edge moderno é baseado no Chromium e inclui identificadores de compatibilidade exigidos por sites que inspecionam agentes do usuário. O analisador precisa procurar o identificador mais específico do Edge antes de classificar a solicitação como Chrome ou Safari genérico. A ordem e a especificidade dos identificadores fazem diferença.

Posso usar o tipo de dispositivo para redirecionar visitantes em celulares?

Você pode usá-lo como indicação, mas um redirecionamento obrigatório pode classificar incorretamente tablets, navegadores em modo desktop e agentes do usuário alterados. Prefira uma página responsiva. Se não for possível evitar uma experiência móvel separada, permita que o visitante escolha outra versão.

As dicas do cliente do navegador substituem a análise do agente do usuário?

As dicas do cliente podem fornecer informações estruturadas sobre navegador e plataforma quando há suporte no navegador e no servidor, mas não estão presentes em todas as solicitações nem em todos os clientes. Sistemas que processam navegadores antigos, rastreadores e logs de acesso existentes talvez ainda precisem analisar o agente do usuário. Armazene apenas as classificações de agente do usuário necessárias para a tarefa e considere as obrigações de privacidade aplicáveis.