HTTP Client-Hinweise

Ein Server muss ankündigen, dass er Client-Hinweise unterstützt, indem er den Accept-CH-Header verwendet, um die Hinweise zu spezifizieren, an denen er interessiert ist. Wenn ein Client, der Client-Hinweise unterstützt, den Accept-CH-Header empfängt, kann er wählen, einige oder alle der aufgelisteten Client-Hinweis-Header zu seinen nachfolgenden Anfragen hinzuzufügen.

Zum Beispiel könnte der Client nach dem Accept-CH in einer Antwort unten die Header Width, Downlink und Sec-CH-UA zu allen nachfolgenden Anfragen hinzufügen.

Accept-CH: Width, Downlink, Sec-CH-UA

Dieser Ansatz ist effizient, da der Server nur die Informationen anfordert, die er sinnvoll verarbeiten kann. Er ist auch relativ "datenschutzfreundlich", da es dem Client überlassen ist zu entscheiden, welche Informationen er sicher teilen kann.

Es gibt eine kleine Menge an niedrig-Entropie-Client-Hinweis-Headern, die von einem Client auch gesendet werden können, wenn sie nicht angefordert werden.

<meta http-equiv="Accept-CH" content="Width, Downlink, Sec-CH-UA" />

Client-Hinweise, die bestimmen, welche Ressourcen in Antworten gesendet werden, sollten generell auch im Vary-Header der betroffenen Antwort enthalten sein. Dies stellt sicher, dass eine unterschiedliche Ressource für jeden unterschiedlichen Wert des Hinweis-Headers zwischengespeichert wird.

Vary: Accept, Width, ECT

Sie ziehen es vielleicht vor, die Spezifizierung von Vary auszulassen oder eine andere Strategie für Client-Hinweis-Header zu verwenden, bei denen sich der Wert häufig ändert, da dies die Ressource effektiv nicht zwischenspeicherbar macht. (Ein neuer Cache-Eintrag wird für jeden eindeutigen Wert erstellt.) Dies gilt insbesondere für Netzwerk-Client-Hinweise wie Downlink und RTT. Für weitere Informationen siehe HTTP-Caching > Vary.

Ein Server gibt die Client-Hinweis-Header an, die er erhalten möchte, im Accept-CH-Antwort-Header an. Der User-Agent fügt die angeforderten Client-Hinweis-Header, oder zumindest die Teilmenge, die er mit diesem Server teilen möchte, zu allen nachfolgenden Anfragen in der aktuellen Browsersitzung hinzu.

Mit anderen Worten, die Anforderung für eine bestimmte Reihe von Hinweisen läuft nicht ab, bevor der Browser geschlossen wird.

Ein Server kann die Reihe der Client-Hinweise, die er erhalten möchte, ersetzen, indem er den Accept-CH-Antwort-Header mit einer neuen Liste erneut sendet. Um beispielsweise keine Hinweise mehr anzufordern, würde er Accept-CH mit einer leeren Liste senden.

Client-Hinweise werden grob in Hinweise mit hoher und niedriger Entropie unterteilt. Die niedrig-Entropie-Hinweise sind solche, die nicht viele Informationen preisgeben, die dazu verwendet werden könnten, ein Fingerprinting eines Benutzers zu erstellen. Sie können standardmäßig bei jeder Client-Anfrage gesendet werden, unabhängig vom Accept-CH-Antwort-Header des Servers, je nach Berechtigungspolitik. Niedrig-Entropie-Hinweise sind:

• Save-Data,
• Sec-CH-UA,
• Sec-CH-UA-Mobile und
• Sec-CH-UA-Platform.

Die hoch-Entropie-Hinweise sind solche, die potenziell mehr Informationen preisgeben können, die für das Fingerprinting eines Benutzers verwendet werden könnten, und sind daher in einer Weise beschränkt, dass der User-Agent entscheiden kann, ob er sie bereitstellt. Die Entscheidung könnte auf Benutzerpräferenzen, einer Berechtigungsanfrage oder der Berechtigungspolitik basieren. Alle Client-Hinweise, die keine niedrig-Entropie-Hinweise sind, werden als hoch-Entropie-Hinweise betrachtet.

Ein kritischer Client-Hinweis ist einer, bei dem die Anwendung der Antwort die gerenderte Seite erheblich verändern kann, möglicherweise auf eine Weise, die unangenehm ist oder die Benutzerfreundlichkeit beeinträchtigt, und der daher angewendet werden muss, bevor der Inhalt gerendert wird. Zum Beispiel wird Sec-CH-Prefers-Reduced-Motion häufig als kritischer Hinweis behandelt, da er das Verhalten von Animationen deutlich beeinflussen könnte und weil ein Benutzer, der diese Präferenz wählt, benötigt, dass sie eingestellt wird.

Ein Server kann den Critical-CH-Antwort-Header zusammen mit Accept-CH verwenden, um zu spezifizieren, dass ein akzeptierter Client-Hinweis auch ein kritischer Client-Hinweis ist (ein Header in Critical-CH muss auch in Accept-CH erscheinen). User-Agents, die eine Antwort mit Critical-CH erhalten, müssen prüfen, ob die angegebenen kritischen Header in der ursprünglichen Anfrage gesendet wurden. Wenn nicht, wird der User-Agent die Anfrage erneut senden, anstatt die Seite zu rendern. Dieser Ansatz stellt sicher, dass die durch kritische Client-Hinweise festgelegten Präferenzen des Clients immer verwendet werden, auch wenn sie nicht in der ersten Anfrage enthalten sind oder wenn die Serverkonfiguration geändert wird.

Zum Beispiel teilt der Server in diesem Fall einem Client über Accept-CH mit, dass er Sec-CH-Prefers-Reduced-Motion akzeptiert, und Critical-CH wird verwendet, um zu spezifizieren, dass Sec-CH-Prefers-Reduced-Motion als kritischer Client-Hinweis betrachtet wird:

HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Motion
Vary: Sec-CH-Prefers-Reduced-Motion
Critical-CH: Sec-CH-Prefers-Reduced-Motion

Da Sec-CH-Prefers-Reduced-Motion ein kritischer Hinweis ist, der nicht in der ursprünglichen Anfrage enthalten war, wiederholt der Client die Anfrage automatisch — diesmal teilt er dem Server über Sec-CH-Prefers-Reduced-Motion mit, dass er eine Benutzerpräferenz für animationsarme Bewegungen hat.

GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Motion: "reduce"

User-Agent (UA)-Client-Hinweis-Header ermöglichen es einem Server, Antworten basierend auf dem User-Agent (Browser), Betriebssystem und Gerät zu variieren. Für eine Liste der Sec-CH-UA-* Header, siehe User-Agent-Client-Hinweis-Header.

Client-Hinweise sind für JavaScript-Webseiten über die User Agent Client Hints API verfügbar.

Benutzerpräferenz-Medienmerkmale-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf den Präferenzen eines User-Agents für CSS-Medienmerkmale wie Farbschema oder reduzierte Bewegung zu variieren. Header umfassen: Sec-CH-Prefers-Reduced-Motion, Sec-CH-Prefers-Color-Scheme.

Geräte-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf Geräteeigenschaften einschließlich verfügbarem Speicher und Bildschirmeigenschaften zu variieren. Header umfassen: Device-Memory, Width, Viewport-Width.

Netzwerk-Client-Hinweise ermöglichen es einem Server, Antworten basierend auf der Wahl des Benutzers, der Netzwerkbandbreite und der Latenz zu variieren. Header umfassen: Save-Data, Downlink, ECT, RTT.

• Client-Hinweis-Header
• Vary HTTP-Header
• Client Hints Infrastructure
• User Agent Client Hints API
• Verbesserung des Datenschutzes und der Entwicklererfahrung mit User-Agent-Client-Hinweisen (developer.chrome.com)