Benutzeragenten-Parser

Der Benutzeragenten-Parser ist ein kostenloses Tool, das einen Benutzeragenten-String ausliest und den Browser, das Betriebssystem sowie den Gerätetyp zurückgibt.

Was verrät ein Benutzeragenten-String?

Ein Benutzeragenten-String ist der Wert des HTTP-Felds User-Agent. Bei einem Webbrowser enthält er normalerweise Produktnamen, Versionsnummern, Angaben zum Betriebssystem und Hinweise auf das verwendete Gerät. Auch Kommandozeilenprogramme, Crawler, Feedreader und In-App-Browser können Benutzeragenten-Strings senden.

Das Format ist weniger geordnet, als es zunächst wirkt. Browser enthalten häufig Kompatibilitätsangaben, die eigentlich zu anderen Browsern gehören. Deshalb kann es zu einem falschen Ergebnis führen, einfach den ersten erkennbaren Produktnamen zu verwenden. Chromium-basierte Browser enthalten beispielsweise oft sowohl Chrome- als auch Safari-bezogene Angaben. Ein Parser untersucht daher die Kombination und Reihenfolge der Bestandteile, statt den Wert als einfache Liste zu behandeln.

Außerdem werden Benutzeragentendaten vom Client selbst angegeben. Ein Client kann sie verändern oder frei erfinden, und manche Browser schränken die übermittelten Versions- und Geräteinformationen ein. Die ausgewerteten Daten sind deshalb für Klassifizierungen und die Fehlersuche nützlich, aber kein Beweis für die Identität eines Geräts.

Wie verwende ich den Benutzeragenten-Parser?

Füge den vollständigen Header-Wert in das Feld Benutzeragent ein und starte das Tool. Es gibt drei Felder zurück: Browser, Betriebssystem und Gerätetyp.

1. Kopiere den Wert hinter User-Agent aus einer HTTP-Anfrage, einem Zugriffsprotokoll oder den Entwicklertools des Browsers.
2. Übernimm Leerzeichen, Klammern, Semikolons, Schrägstriche und Versionsnummern unverändert. Sie trennen Produkte und Kommentare innerhalb des Strings.
3. Sende den Wert ab und gleiche die zurückgegebenen Klassifizierungen anschließend mit dem Kontext der Anfrage ab.
4. Bewahre den ursprünglichen String zusammen mit dem ausgewerteten Ergebnis in deinen eigenen Notizen zur Fehlersuche auf. Die Klassifizierung allein kann nützliche Versions- oder Kompatibilitätsangaben verbergen.

Die Auswertung findet auf dem Server statt. Dein Benutzeragenten-String wird über HTTPS an den Server übertragen und nicht gespeichert. Prüfe kopierte Protokolleinträge vor dem Absenden trotzdem auf sachfremde Abfrageparameter, Sitzungskennungen oder interne Hostnamen.

Wie lese ich das ausgewertete Ergebnis?

Betrachte jedes Feld als eine Klassifizierung, die aus den vom Client übermittelten Bestandteilen abgeleitet wurde, nicht als unabhängig bestätigte Information über Hard- oder Software.

• Browser nennt die Browser- oder Clientfamilie, die anhand des Strings erkannt wurde. Eingebettete Webviews und von Chromium abgeleitete Browser lassen sich unter Umständen schwerer unterscheiden, da sie viele Bestandteile gemeinsam haben.
• Betriebssystem gibt die Plattform an, auf die Kennzeichnungen wie Windows NT, Android, iPhone OS, Mac OS X oder Linux hindeuten. Kompatibilitätsschichten und veränderte Benutzeragenten können das Ergebnis ungenauer machen.
• Gerätetyp ordnet den Client anhand von Geräte- und Plattformkennzeichnungen einer allgemeinen Geräteklasse zu. Verstehe diese Angabe als praktische Kategorie und nicht als exaktes Hardwaremodell.

Die ausgegebenen Ergebnisfelder sind kein Bericht zur Syntaxprüfung. Ein fehlerhafter, verkürzter oder unbekannter Benutzeragent enthält möglicherweise nicht genug Informationen für eine sinnvolle Klassifizierung. Es gibt jedoch keine allgemeingültige Fehlerliste, die mit JSON-Fehlern wie nachgestellten Kommas oder Schlüsseln ohne Anführungszeichen vergleichbar wäre. Die Auswertung von Benutzeragenten basiert weitgehend auf Heuristiken, weil sich reale Strings je nach Client unterscheiden und häufig alte Kompatibilitätssyntax beibehalten.

Ein leerer Wert enthält nichts, was sich klassifizieren ließe. Sehr lange Werte können Erweiterungen, Anwendungskennungen oder doppelte Produktangaben enthalten. Zahlen sind normalerweise nur in Verbindung mit dem zugehörigen Produktbestandteil aussagekräftig. Zeichen mit Akzenten oder aus nicht lateinischen Schriftsystemen können in benutzerdefinierten Client-Strings vorkommen, identifizieren aber nicht automatisch einen Browser, ein Betriebssystem oder ein Gerät.

Beispiele

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

Ein Parser würde dies normalerweise als Chrome unter Windows und als Desktopgerät klassifizieren. Der Safari-Bestandteil dient der Kompatibilität und sollte für sich genommen nicht dazu führen, dass der Browser als Safari erkannt wird.

Eingabe 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

Dies weist auf Safari unter iOS und auf ein Mobilgerät hin. Die Formulierung "like Mac OS X" gehört zu den Kompatibilitätsinformationen. Die Kennzeichnungen iPhone und Mobile liefern die stärkeren Hinweise auf den Gerätetyp.

Wurde ein Benutzeragent innerhalb eines URL-Abfrageparameters erfasst, kann er prozentkodiert sein. Verwende den URL-Parser, um den Parameter zu isolieren und zu dekodieren, bevor du den daraus gewonnenen Benutzeragenten-Wert auswertest.

Wann ist die Auswertung eines Benutzeragenten sinnvoll und wann nicht?

Die Auswertung ist hilfreich, wenn du eine verständliche Erklärung für eine unbekannte Anfrage benötigst oder die Klassifizierungslogik vor der Bereitstellung prüfen möchtest. Typische Anwendungsfälle sind die Untersuchung eines Eintrags im Apache- oder nginx-Zugriffsprotokoll, die Analyse eines browserspezifischen Darstellungsfehlers, die Prüfung des Datenverkehrs einer eingebetteten App oder das Lesen von Rohdaten, die aus einer Analyseplattform exportiert wurden.

Eine Auswertung lohnt sich normalerweise nicht, wenn ein anderes System Browser, Betriebssystem und Gerät bereits als strukturierte Felder bereitstellt. Sie bringt auch wenig, wenn dein Dienst den ursprünglichen Header lediglich weiterleiten oder archivieren muss. Verwende das Ergebnis nicht als alleinige Grundlage für Authentifizierung, Betrugserkennung oder Zugriffskontrolle, da der Absender den String fälschen kann.

Für responsive Layouts sind CSS-Medienabfragen und Funktionserkennung im Allgemeinen zuverlässiger als serverseitige Vermutungen zum Gerät. Werte den Benutzeragenten aus, wenn du Kontext für Diagnosen oder Berichte brauchst, nicht um daraus die Unterstützung einer bestimmten Browserfunktion abzuleiten.

Häufig gestellte Fragen

Kann der Parser erkennen, ob eine Anfrage von einem Bot stammt?

Nein, die ausgegebenen Felder enthalten keine eigene Bot-Klassifizierung. Manche Crawler geben sich in ihrem Benutzeragenten eindeutig zu erkennen, andere imitieren Browser oder lassen hilfreiche Angaben weg. Prüfe automatisierten Datenverkehr gegebenenfalls zusätzlich anhand von Anfrageraten, veröffentlichten IP-Prüfungen für Crawler und dem Anfrageverhalten.

Warum stehen in einem Edge-Benutzeragenten auch Chrome und Safari?

Modernes Edge basiert auf Chromium und enthält Kompatibilitätsangaben, die von Websites benötigt werden, wenn sie Benutzeragenten prüfen. Ein Parser muss zuerst nach dem spezifischeren Edge-Bestandteil suchen, bevor er die Anfrage als allgemeines Chrome oder Safari einordnet. Reihenfolge und Spezifität der Bestandteile sind entscheidend.

Kann ich Besucher anhand des Gerätetyps auf eine mobile Seite umleiten?

Du kannst den Gerätetyp als Hinweis verwenden. Eine feste Weiterleitung kann Tablets, Browser im Desktopmodus und veränderte Benutzeragenten jedoch falsch einordnen. Bevorzuge eine responsive Seite. Falls eine separate mobile Version unvermeidbar ist, sollte der Besucher selbst zu einer anderen Version wechseln können.

Ersetzen Browser-Client-Hints die Auswertung von Benutzeragenten?

Client-Hints können strukturierte Informationen zu Browser und Plattform liefern, wenn Browser und Server sie unterstützen, ersetzen die Auswertung aber nicht in jedem Fall. Sie sind nicht bei jeder Anfrage und jedem Client vorhanden. Systeme, die ältere Browser, Crawler und vorhandene Zugriffsprotokolle verarbeiten, benötigen möglicherweise weiterhin eine Auswertung von Benutzeragenten. Speichere nur die für die jeweilige Aufgabe erforderlichen Benutzeragenten-Klassifizierungen und beachte die geltenden Datenschutzpflichten.