Brugeragent-parser

Brugeragent-parser er et gratis værktøj, der læser en brugeragentstreng og returnerer browser, operativsystem og enhedstype.

Hvad fortæller en brugeragentstreng?

En brugeragentstreng er værdien i HTTP-feltet User-Agent. For en webbrowser indeholder den normalt produktnavne, versionsnumre, oplysninger om operativsystemet og tegn på enhedstypen. Kommandolinjeklienter, crawlere, feedlæsere og browsere indbygget i apps kan også sende brugeragentstrenge.

Formatet er mindre entydigt, end det umiddelbart ser ud. Browsere medtager ofte kompatibilitetsmarkører, der forbindes med andre browsere. Derfor kan du få et forkert resultat, hvis du blot vælger det første genkendelige produktnavn. Chromium-baserede browsere indeholder eksempelvis ofte markører for både Chrome og Safari. En parser undersøger markørernes kombination og rækkefølge i stedet for at behandle værdien som en simpel liste.

Brugeragentdata oplyses desuden af klienten selv. En klient kan ændre eller forfalske dem, og nogle browsere begrænser, hvor mange oplysninger om version og enhed de viser. De fortolkede data er derfor nyttige til klassificering og fejlfinding, men de beviser ikke enhedens identitet.

Hvordan bruger jeg Brugeragent-parser?

Indsæt hele header-værdien i feltet Brugeragent, og kør værktøjet. Det returnerer tre felter med navnene Browser, Operativsystem og Enhedstype.

1. Kopiér værdien efter User-Agent fra en HTTP-anmodning, en adgangslog eller browserens udviklerværktøjer.
2. Bevar de oprindelige mellemrum, parenteser, semikoloner, skråstreger og versionsnumre. De adskiller produkter og kommentarer i strengen.
3. Indsend værdien, og sammenhold derefter klassificeringerne med den sammenhæng, anmodningen indgår i.
4. Gem den oprindelige streng sammen med det fortolkede resultat i dine egne fejlfindingsnoter. Klassificeringen alene kan skjule nyttige versions- eller kompatibilitetsmarkører.

Parseren kører på serveren. Din brugeragentstreng sendes til serveren via HTTPS og gemmes ikke. Kontrollér alligevel kopierede logposter for uvedkommende forespørgselsparametre, sessions-id'er eller interne værtsnavne, før du indsender dem.

Hvordan læser jeg resultatet?

Læs hvert felt som en klassificering, der er udledt af de markører, klienten har angivet, ikke som uafhængigt bekræftede oplysninger om hardware eller software.

• Browser angiver den browser- eller klientfamilie, der genkendes ud fra strengen. Indbyggede webvisninger og Chromium-baserede browsere kan være sværere at skelne fra hinanden, fordi de deler mange markører.
• Operativsystem viser den platform, som markører som Windows NT, Android, iPhone OS, Mac OS X eller Linux peger på. Kompatibilitetslag og ændrede brugeragenter kan gøre oplysningerne mindre præcise.
• Enhedstype placerer klienten i en overordnet kategori ud fra enheds- og platformsmarkører. Betragt den som en praktisk kategori, ikke som en præcis hardwaremodel.

De viste resultatfelter udgør ikke en rapport over syntaksfejl. En forkert opbygget, forkortet eller ukendt brugeragent indeholder muligvis ikke nok oplysninger til en brugbar klassificering, men der findes ingen universel fejlliste svarende til JSON-fejl som afsluttende kommaer eller nøgler uden anførselstegn. Fortolkning af brugeragenter bygger i høj grad på heuristik, fordi de faktiske strenge varierer fra klient til klient og ofte bevarer ældre kompatibilitetssyntaks.

En tom værdi indeholder intet, der kan klassificeres. Meget lange værdier kan indeholde udvidelser, program-id'er eller gentagne produktmarkører, mens tal normalt kun giver mening sammen med den produktmarkør, de beskriver. Tegn med accenter og ikke-latinske tegn kan forekomme i brugerdefinerede klientstrenge, men de identificerer ikke automatisk en browser, et operativsystem eller en enhed.

Eksempler

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

En parser vil normalt klassificere dette som Chrome på Windows og som en stationær enhed. Safari-markøren er med af kompatibilitetshensyn og bør ikke i sig selv føre til, at browseren klassificeres som 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

Dette angiver Safari på iOS og en mobilenhed. Formuleringen "like Mac OS X" er en del af kompatibilitetsoplysningerne. Markørerne iPhone og Mobile er stærkere tegn på enhedstypen.

Hvis en brugeragent er hentet fra en forespørgselsparameter i en URL, kan den være procentkodet. Brug URL-parser til at isolere og afkode parameteren, før du fortolker den resulterende brugeragentværdi.

Hvornår er det nyttigt at fortolke en brugeragent?

Fortolkning er nyttig, når du har brug for en letlæselig forklaring på en ukendt anmodning eller vil kontrollere klassificeringslogikken før idriftsættelse. Det kan eksempelvis være relevant, når du undersøger en post i en adgangslog fra Apache eller nginx, gennemgår en rapport om browserspecifik visning, kontrollerer trafik fra en indbygget app eller læser rådata, der er eksporteret fra en analyseplatform.

Det er normalt ikke umagen værd, hvis et andet system allerede leverer browser, operativsystem og enhed som strukturerede felter. Der er heller ikke meget at vinde, hvis din tjeneste kun skal videresende eller arkivere den oprindelige header. Brug ikke resultatet som eneste grundlag for godkendelse, registrering af svindel eller adgangskontrol, da afsenderen kan forfalske strengen.

Til responsive layouts er CSS-medieforespørgsler og funktionsregistrering generelt mere pålidelige end serverbaserede gæt på enhedstypen. Fortolk brugeragenten, når du har brug for sammenhæng til fejlfinding eller rapportering, ikke for at antage understøttelse af en bestemt browserfunktion.

Ofte stillede spørgsmål

Kan parseren se, om en anmodning kommer fra en bot?

Resultatfelterne indeholder ikke en særskilt botklassificering. Nogle crawlere identificerer sig tydeligt i deres brugeragent, mens andre efterligner browsere eller udelader nyttige oplysninger. Bekræft automatiseret trafik ved at undersøge frekvensmønstre, offentliggjorte IP-oplysninger for crawlere og anmodningernes adfærd, hvor det er relevant.

Hvorfor står der både Chrome og Safari i en Edge-brugeragent?

Den moderne version af Edge er Chromium-baseret og indeholder kompatibilitetsmarkører, som bruges af websteder, der undersøger brugeragenter. En parser skal finde den mere specifikke Edge-markør, før anmodningen klassificeres som almindelig Chrome eller Safari. Markørernes rækkefølge og specificitet har betydning.

Kan jeg bruge enhedstypen til at omdirigere mobilbrugere?

Du kan bruge den som et fingerpeg, men en tvungen omdirigering kan fejlklassificere tablets, browsere i skrivebordstilstand og ændrede brugeragenter. Foretræk en responsiv side, og lad brugeren vælge en anden version, hvis en separat mobiloplevelse ikke kan undgås.

Erstatter browserens client hints fortolkning af brugeragenter?

Client hints kan levere strukturerede oplysninger om browser og platform, når både browseren og serveren understøtter dem, men de findes ikke i alle anmodninger eller klienter. Systemer, der håndterer ældre browsere, crawlere og eksisterende adgangslogfiler, kan stadig have brug for at fortolke brugeragenter. Gem kun de brugeragentklassificeringer, som opgaven kræver, og tag højde for de gældende databeskyttelseskrav.