Sec-CH-UA header

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-Hinweis, der die Marken- und wesentlichen Versionsinformationen des User-Agents bereitstellt.

Der Sec-CH-UA-Header gibt die Marke und die wesentliche Version für jede Marke, die mit dem Browser verbunden ist, in einer kommagetrennten Liste an. Der Header ermöglicht es dem Server, seine Antwort sowohl basierend auf den gemeinsamen Marken als auch auf bestimmten Anpassungen in deren jeweiligen Versionen zu individualisieren.

Sec-CH-UA ist ein low entropy hint. Sofern es nicht durch eine Berechtigungspolitik des User-Agents blockiert wird, wird es standardmäßig gesendet, ohne dass der Server durch das Senden von Accept-CH optiert.

Der Header kann "falsche" Marken in jeder Position und mit jedem Namen enthalten. Das ist eine Funktion, die verhindert, dass Server unbekannte User-Agents sofort ablehnen, sodass User-Agents gezwungen werden, ü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 wesentlichen Versionsnummer für jede Marke.

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

Syntax

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

http
Sec-CH-UA: "";v="", …

Direktiven

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

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

Beschreibung

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

Die wesentliche Version ist der "Marketing"-Versionsidentifikator, der verwendet wird, um zwischen Hauptveröffentlichungen der Marke zu unterscheiden. Zum Beispiel hat ein Chromium-Build mit vollständiger Versionsnummer "96.0.4664.45" eine wesentliche Versionsnummer von "96".

Beispiele

Verschiedene Sec-CH-UA-Marken

Sec-CH-UA ist ein low entropy hint. Sofern nicht explizit durch eine User-Agent-Politik blockiert, wird es in allen Anfragen gesendet (ohne dass der Server durch das Senden von Accept-CH optiert).

Nachfolgend sind Strings von Chromium-, Chrome-, Edge- und Opera-Desktop-Browsern gezeigt. Beachten Sie, dass sie alle die Marke "Chromium" gemeinsam haben, aber eine zusätzliche Marke zur Angabe ihres Ursprungs haben. Sie haben auch einen absichtlich falschen Markenstring, der an beliebiger Stelle auftreten 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

Siehe auch