Sec-CH-UA

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

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

Der Sec-CH-UA User-Agent Client Hint Request-Header stellt die Marken- und signifikanten Versionsinformationen des User-Agents bereit.

Header-Typ Request Header, Client Hint
Verbotener Header-Name ja

Der Sec-CH-UA Header gibt die Marke und die signifikante Version für jede mit dem Browser verbundene Marke in einer durch Kommas getrennten Liste an.

Eine Marke ist ein Handelsname für den User-Agent, wie: Chromium, Opera, Google Chrome, Microsoft Edge, Firefox und Safari. Ein User-Agent kann mit mehreren Marken verbunden sein. Beispielsweise basieren Opera, Chrome und Edge alle auf Chromium und werden beide Marken im Sec-CH-UA Header angeben.

Die signifikante Version ist die "Marketing"-Versionskennung, die verwendet wird, um zwischen den Hauptversionen der Marke zu unterscheiden. Ein Chromium-Build mit der vollständigen Versionsnummer "96.0.4664.45" hat beispielsweise eine signifikante Versionsnummer von "96".

Der Header ermöglicht es dem Server daher, seine Antwort basierend auf gemeinsamen Marken und auf bestimmten Anpassungen in ihren jeweiligen Versionen zu individualisieren.

Sec-CH-UA ist ein Low-Entropy Hint. Falls er nicht durch eine User-Agent-Berechtigungsrichtlinie blockiert wird, wird er standardmäßig ohne das Opt-in des Servers durch Senden von Accept-CH gesendet.

Der Header kann "gefälschte" Marken in beliebiger Position und mit beliebigem Namen enthalten. Dies ist eine Funktion, die verhindert, dass Server unbekannte User-Agents direkt ablehnen, wodurch User-Agents gezwungen werden, über ihre Markenidentität zu lügen.

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

Syntax

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

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

Direktiven

<brand>

Eine Marke, die mit dem User-Agent verbunden ist, wie "Chromium", "Google Chrome" oder eine absichtlich inkorrekte Marke wie "Not A;Brand".

<significant version>

Die "Marketing"-Versionsnummer, die mit unterscheidbaren, im Web sichtbaren Funktionen verbunden ist.

Beispiele

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 ein Opt-in vornimmt).

Strings von Chromium-, Chrome-, Edge- und Opera-Desktop-Browsern werden unten gezeigt. Beachten Sie, dass sie alle die "Chromium"-Marke teilen, jedoch eine zusätzliche Marke haben, die ihren Ursprung anzeigt. Sie haben auch eine absichtlich falsche Marken-String, die an beliebiger Position erscheinen und unterschiedlichen Text 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

BCD tables only load in the browser

Siehe auch