Parser dell'user agent

Il Parser dell'user agent è uno strumento gratuito che legge una stringa user agent e restituisce il browser, il sistema operativo e il tipo di dispositivo.

Quali informazioni contiene una stringa user agent?

Una stringa user agent è il valore del campo HTTP User-Agent. Nel caso di un browser web, in genere contiene nomi di prodotti, numeri di versione, identificatori del sistema operativo e indicazioni sul dispositivo. Anche client da riga di comando, crawler, lettori di feed e browser integrati nelle app possono inviare stringhe user agent.

Il formato è meno ordinato di quanto sembri. I browser includono spesso identificatori di compatibilità associati ad altri browser, quindi basarsi sul primo nome di prodotto riconoscibile può portare a un risultato errato. Per esempio, i browser basati su Chromium contengono comunemente identificatori riconducibili sia a Chrome sia a Safari. Un parser esamina la combinazione e l'ordine degli identificatori, anziché trattare il valore come un semplice elenco.

Inoltre, i dati dello user agent sono dichiarati dal client stesso. Il client può modificarli o inventarli e alcuni browser limitano le informazioni esposte sulla versione e sul dispositivo. I dati analizzati sono quindi utili per la classificazione e il debug, ma non dimostrano l'identità di un dispositivo.

Come si usa il parser dell'user agent?

Incolla il valore completo dell'header nel campo Agente utente e avvia lo strumento. Otterrai tre campi: Browser, Sistema operativo e Tipo di dispositivo.

1. Copia il valore che segue User-Agent da una richiesta HTTP, da un log degli accessi o dagli strumenti per sviluppatori del browser.
2. Mantieni invariati spazi, parentesi, punti e virgola, barre e numeri di versione. Servono a separare prodotti e commenti all'interno della stringa.
3. Invia il valore, quindi confronta le classificazioni restituite con il contesto della richiesta.
4. Conserva la stringa originale insieme al risultato analizzato nelle tue note di debug. La sola classificazione può nascondere identificatori di versione o compatibilità utili.

Il parser viene eseguito sul server. La stringa user agent viene trasmessa al server tramite HTTPS e non viene memorizzata. Prima di inviarla, controlla comunque che le righe copiate dai log non contengano parametri di query estranei, identificatori di sessione o nomi host interni.

Come si interpreta il risultato?

Considera ogni campo come una classificazione dedotta dagli identificatori forniti dal client, non come un'informazione su hardware o software verificata in modo indipendente.

• Browser indica il browser o la famiglia di client riconosciuta dalla stringa. Le web view integrate e i browser derivati da Chromium possono essere più difficili da distinguere, perché condividono molti identificatori.
• Sistema operativo riporta la piattaforma indicata da marcatori come Windows NT, Android, iPhone OS, Mac OS X o Linux. I livelli di compatibilità e gli user agent modificati possono rendere il risultato meno specifico.
• Tipo di dispositivo assegna il client a una categoria generale dedotta dai marcatori del dispositivo e della piattaforma. Usala come categoria pratica, non come identificazione esatta del modello hardware.

I campi restituiti non costituiscono un rapporto di convalida della sintassi. Uno user agent non valido, abbreviato o sconosciuto potrebbe non contenere informazioni sufficienti per una classificazione utile, ma non esiste un elenco universale di errori paragonabile a quello di JSON, come virgole finali o chiavi senza virgolette. L'analisi degli user agent è in gran parte euristica, perché le stringhe reali variano tra i client e spesso conservano vecchie sintassi di compatibilità.

Un valore vuoto non contiene nulla da classificare. I valori molto lunghi possono includere estensioni, identificatori di applicazioni o identificatori di prodotto duplicati, mentre i numeri hanno generalmente significato solo accanto all'identificatore di prodotto a cui si riferiscono. Nelle stringhe create da client personalizzati possono comparire caratteri accentati o non latini, ma la loro presenza non identifica automaticamente un browser, un sistema operativo o un dispositivo.

Esempi pratici

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

In genere, un parser classificherebbe questa stringa come Chrome su Windows e come dispositivo desktop. L'identificatore Safari è presente per ragioni di compatibilità e, da solo, non dovrebbe portare a classificare il browser come Safari.

Input 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

Questa stringa indica Safari su iOS e un dispositivo mobile. La dicitura "like Mac OS X" fa parte delle informazioni di compatibilità; i marcatori iPhone e Mobile forniscono indicazioni più attendibili sul dispositivo.

Se uno user agent è stato acquisito all'interno di un parametro di query di un URL, potrebbe essere codificato con la codifica percentuale. Usa il Parser URL per isolare e decodificare il parametro prima di analizzare il valore user agent risultante.

Quando è utile analizzare uno user agent e quando non lo è?

L'analisi è utile quando vuoi ottenere una spiegazione leggibile di una richiesta sconosciuta o verificare la logica di classificazione prima della distribuzione. Alcuni casi tipici sono l'esame di una voce nel log degli accessi di Apache o nginx, l'analisi di un problema di rendering specifico di un browser, il controllo del traffico proveniente da un'app integrata o la lettura di dati grezzi esportati da una piattaforma di analisi.

Di solito non serve analizzare lo user agent se un altro sistema fornisce già browser, sistema operativo e dispositivo sotto forma di campi strutturati. È poco utile anche quando il servizio deve soltanto inoltrare o archiviare l'header originale. Non usare il risultato come unico criterio per l'autenticazione, il rilevamento delle frodi o il controllo degli accessi, perché il mittente può falsificare la stringa.

Per i layout responsive, le media query CSS e il rilevamento delle funzionalità sono generalmente più affidabili delle stime del dispositivo effettuate lato server. Analizza lo user agent quando ti serve un contesto diagnostico o informativo, non per presumere il supporto di una specifica funzionalità del browser.

Domande frequenti

Il parser può capire se una richiesta proviene da un bot?

I campi restituiti non includono una classificazione specifica per i bot. Alcuni crawler si identificano chiaramente nel proprio user agent, mentre altri imitano i browser o omettono dettagli utili. Quando opportuno, verifica il traffico automatizzato esaminando la frequenza delle richieste, controllando gli indirizzi IP pubblicati dai crawler e osservando il comportamento delle richieste.

Perché lo user agent di Edge contiene Chrome e Safari?

Edge moderno è basato su Chromium e include identificatori di compatibilità necessari per i siti che esaminano gli user agent. Un parser deve cercare l'identificatore più specifico di Edge prima di classificare la richiesta come un generico Chrome o Safari. L'ordine e la specificità degli identificatori sono importanti.

Posso usare il tipo di dispositivo per reindirizzare gli utenti da mobile?

Puoi usarlo come indicazione, ma un reindirizzamento forzato può classificare in modo errato tablet, browser in modalità desktop e user agent modificati. È preferibile offrire una pagina responsive e, se non puoi evitare un'esperienza mobile separata, consentire all'utente di scegliere un'altra versione.

I client hint del browser sostituiscono l'analisi dello user agent?

I client hint possono fornire informazioni strutturate sul browser e sulla piattaforma quando sono supportati sia dal browser sia dal server, ma non sono presenti in ogni richiesta o client. I sistemi che gestiscono browser meno recenti, crawler e log degli accessi esistenti potrebbero avere ancora bisogno di analizzare gli user agent. Conserva solo le classificazioni necessarie per l'attività e tieni conto degli obblighi applicabili in materia di privacy.