Analisador de agente do utilizador

O Analisador de agente do usuário é uma ferramenta gratuita que lê uma cadeia de agente do utilizador e identifica o navegador, o sistema operativo e o tipo de dispositivo.

O que revela uma cadeia de agente do utilizador?

Uma cadeia de agente do utilizador corresponde ao valor do campo HTTP User-Agent. Num navegador Web, inclui habitualmente nomes de produtos, números de versão, identificadores do sistema operativo e indicações sobre o dispositivo. Clientes de linha de comandos, rastreadores, leitores de feeds e navegadores integrados em aplicações também podem enviar estas cadeias.

O formato é menos organizado do que parece. Os navegadores incluem frequentemente identificadores de compatibilidade associados a outros navegadores, pelo que procurar apenas o primeiro nome de produto reconhecível pode dar um resultado errado. Por exemplo, é comum os navegadores baseados no Chromium incluírem identificadores relacionados tanto com o Chrome como com o Safari. Um analisador considera a combinação e a ordem dos identificadores, em vez de tratar o valor como uma simples lista.

Além disso, os dados do agente do utilizador são declarados pelo próprio cliente. Este pode alterá-los ou falsificá-los, e alguns navegadores reduzem a quantidade de informação disponibilizada sobre a versão e o dispositivo. Por isso, os dados analisados são úteis para classificação e diagnóstico, mas não provam a identidade de um dispositivo.

Como se utiliza o analisador de agente do utilizador?

Cola o valor completo do cabeçalho no campo Agente do usuário e executa a ferramenta. O resultado apresenta três campos: Navegador, Sistema operativo e Tipo de dispositivo.

1. Copia o valor que aparece depois de User-Agent num pedido HTTP, num registo de acessos ou nas ferramentas de programador do navegador.
2. Mantém os espaços, parênteses, pontos e vírgulas, barras e números de versão originais. Estes elementos separam os produtos e os comentários dentro da cadeia.
3. Submete o valor e compara as classificações devolvidas com o contexto do pedido.
4. Nas tuas notas de diagnóstico, guarda a cadeia original juntamente com o resultado da análise. A classificação, por si só, pode ocultar identificadores úteis de versão ou compatibilidade.

O analisador é executado no servidor. A cadeia de agente do utilizador é enviada para o servidor através de HTTPS e não é armazenada. Ainda assim, antes de a submeteres, verifica se as entradas copiadas dos registos contêm parâmetros de consulta não relacionados, identificadores de sessão ou nomes de anfitriões internos.

Como devo interpretar o resultado?

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

• Navegador identifica a família do navegador ou cliente reconhecida na cadeia. As vistas Web integradas e os navegadores derivados do Chromium podem ser mais difíceis de distinguir, pois partilham muitos identificadores.
• Sistema operativo indica a plataforma assinalada por marcadores como Windows NT, Android, iPhone OS, Mac OS X ou Linux. As camadas de compatibilidade e os agentes do utilizador modificados podem tornar esta classificação menos específica.
• Tipo de dispositivo inclui o cliente numa categoria geral de formato, deduzida a partir dos marcadores do dispositivo e da plataforma. Considera-a uma categoria prática, não um modelo de hardware exato.

Os campos documentados do resultado não constituem um relatório de validação de sintaxe. Um agente do utilizador malformado, abreviado ou desconhecido pode não conter informação suficiente 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 utilizador baseia-se sobretudo em heurísticas, porque as cadeias reais variam entre clientes e mantêm muitas vezes sintaxe de compatibilidade antiga.

Um valor vazio não contém nada que possa ser classificado. Os valores muito longos podem incluir extensões, identificadores de aplicações ou identificadores de produto repetidos, enquanto os números só costumam fazer sentido junto do identificador de produto a que dizem respeito. Podem surgir caracteres acentuados ou não latinos em cadeias de clientes personalizadas, mas isso não permite identificar automaticamente um navegador, sistema operativo 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 este valor como Chrome no Windows e como um dispositivo de secretária. O identificador Safari está presente por motivos de compatibilidade e, por si só, não deve levar à classificação do navegador 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

Este valor indica o Safari no iOS e um dispositivo móvel. A expressão "like Mac OS X" faz parte da informação de compatibilidade. Os marcadores iPhone e Mobile dão indicações mais fiáveis sobre o dispositivo.

Se o agente do utilizador tiver sido capturado num parâmetro de consulta de um URL, poderá estar codificado por percentagem. Usa o Analisador de URL para isolar e descodificar o parâmetro antes de analisares o valor resultante do agente do utilizador.

Quando é útil analisar um agente do utilizador, e quando não é?

A análise é útil quando precisas de uma explicação legível para um pedido desconhecido ou queres verificar a lógica de classificação antes da implementação. Entre os casos mais comuns estão a análise de uma entrada de um registo de acessos do Apache ou nginx, a investigação de um problema de apresentação específico de um navegador, a verificação de tráfego proveniente de uma aplicação integrada ou a leitura de dados em bruto exportados de uma plataforma de análise.

Normalmente, não vale a pena analisar a cadeia quando outro sistema já fornece o navegador, o sistema operativo e o dispositivo em campos estruturados. Também há pouco benefício se o teu serviço apenas precisar de reencaminhar ou arquivar o cabeçalho original. Evita usar o resultado como único critério de autenticação, deteção de fraude ou controlo de acesso, pois o remetente pode falsificar a cadeia.

Para esquemas responsivos, as consultas de multimédia CSS e a deteção de funcionalidades são geralmente mais fiáveis do que tentar deduzir o dispositivo no servidor. Analisa o agente do utilizador quando precisares de contexto para diagnóstico ou relatórios, não para presumir a compatibilidade com uma funcionalidade específica do navegador.

Perguntas frequentes

O analisador consegue dizer se um pedido veio de um bot?

Os campos devolvidos não incluem uma classificação específica para bots. Alguns rastreadores identificam-se claramente no agente do utilizador, mas outros imitam navegadores ou omitem informações úteis. Quando for adequado, confirma o tráfego automatizado através dos padrões de frequência, das verificações publicadas dos endereços IP dos rastreadores e do comportamento dos pedidos.

Porque é que um agente do utilizador do Edge contém Chrome e Safari?

O Edge moderno baseia-se no Chromium e inclui identificadores de compatibilidade necessários para sites que analisam agentes do utilizador. Um analisador tem de procurar o identificador mais específico do Edge antes de classificar o pedido como Chrome ou Safari genérico. A ordem e a especificidade dos identificadores são importantes.

Posso usar o tipo de dispositivo para redirecionar visitantes em telemóveis?

Podes usá-lo como indicação, mas um redirecionamento obrigatório pode classificar incorretamente tablets, navegadores em modo de computador e agentes do utilizador alterados. Dá preferência a uma página responsiva e, se for indispensável ter uma experiência móvel separada, permite que o visitante escolha outra versão.

As sugestões de cliente do navegador substituem a análise do agente do utilizador?

As sugestões de cliente podem fornecer informação estruturada sobre o navegador e a plataforma quando são suportadas pelo navegador e pelo servidor, mas não estão presentes em todos os pedidos nem em todos os clientes. Os sistemas que processam navegadores antigos, rastreadores e registos de acessos existentes podem continuar a precisar de analisar o agente do utilizador. Guarda apenas as classificações necessárias para a tarefa e tem em conta as obrigações de privacidade aplicáveis.