Sec-CH-UA

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Der HTTP Sec-CH-UA Request-Header ist ein User-Agent-Client-Hint, der die Branding- und signifikante Versionsinformationen des User-Agents bereitstellt.

Der Sec-CH-UA-Header stellt die Marke und die signifikante Version für jede mit dem Browser assoziierte Marke in einer durch Kommas getrennten Liste zur Verfügung. Der Header ermöglicht es dem Server daher, seine Antwort basierend auf sowohl gemeinsamen Marken als auch auf bestimmten Anpassungen in ihren jeweiligen Versionen zu individualisieren.

Sec-CH-UA ist ein Low-Entropy-Hint. Sofern nicht durch eine Berechtigungsrichtlinie des User-Agents blockiert, wird er standardmäßig gesendet, ohne dass der Server dies durch Senden von Accept-CH anfordern muss.

Der Header kann "falsche" Marken in beliebiger Position und mit beliebigem Namen enthalten. Dies ist eine Funktion, die dazu dient, zu verhindern, dass Server unbekannte User-Agents rundweg ablehnen, was User-Agents dazu zwingt, über ihre Markenidentität zu lügen.

Hinweis: Der Sec-CH-UA-Full-Version-List Header ist derselbe wie Sec-CH-UA, enthält jedoch die vollständige Versionsnummer anstelle der signifikanten Versionsnummer für jede Marke.

Header-Typ Request-Header, Client-Hint
Verbotener Request-Header Ja (Sec- Präfix)

Syntax

Eine durch Kommas getrennte Liste von Marken in der User-Agent-Markenliste und deren zugehörige signifikante Versionsnummer. Die Syntax für einen einzelnen Eintrag hat folgendes Format:

http
Sec-CH-UA: "<brand>";v="<significant version>", …

Direktiven

<brand>

Eine mit dem User-Agent assoziierte Marke, wie "Chromium", "Google Chrome", oder eine absichtlich falsche Marke wie "Not A;Brand".

<significant version>

Die "Marketing"-Versionsnummer, die mit unterscheidbaren, web-exponierten Funktionen verbunden ist.

Beschreibung

Eine Marke ist ein Handelsname für den User-Agent, wie: Chromium, Opera, Google Chrome, Microsoft Edge, Firefox und Safari. Ein User-Agent kann mehrere assoziierte Marken haben. Zum Beispiel basieren Opera, Chrome und Edge alle auf Chromium und geben im Sec-CH-UA-Header beide Marken an.

Die signifikante Version ist die "Marketing"-Versionskennung, die verwendet wird, um zwischen Hauptversionen der Marke zu unterscheiden. Zum Beispiel hat ein Chromium-Build mit der vollen Versionsnummer "96.0.4664.45" eine signifikante Versionsnummer von "96".

Beispiele

Verschiedene Sec-CH-UA Marken

Sec-CH-UA ist ein Low-Entropy-Hint. Sofern nicht explizit durch eine User-Agent-Richtlinie blockiert, wird er in allen Anfragen gesendet (ohne dass der Server durch Senden von Accept-CH zustimmen muss).

Nachfolgend sind Strings von Chromium-, Chrome-, Edge- und Opera-Desktop-Browsern dargestellt. Beachten Sie, dass sie alle die "Chromium"-Marke teilen, aber eine zusätzliche Marke haben, die ihren Ursprung anzeigt. Sie haben auch eine absichtlich falsche Markenzeichenkette, die in jeder Position erscheinen und unterschiedliche Texte haben kann.

http
Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"
http
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"
http
Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"

Spezifikationen

Specification
User-Agent Client Hints
# sec-ch-ua

Browser-Kompatibilität

Siehe auch