Einstellungstest der User-Agent-Reduzierung
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Im Test zur Einstellung der Reduzierung der Informationen im User-Agent-String konnten Websites nach der Reduzierung des User-Agent-Strings weiterhin den vollständigen User-Agent-String erhalten. Der Testzeitraum endete am 23. September 2023.

Ab Chrome 101 werden die im User-Agent-String (UA) verfügbaren Informationen schrittweise reduziert. Für Websites, die noch nicht von der Verwendung des reduzierten User-Agent-Strings zu User-Agent-Client-Hints migriert sind, können Sie an einem Test zur Einstellung teilnehmen, um weiterhin den vollständigen User-Agent-String zu erhalten.

Die Registrierung für den Testlauf zur Einstellung beginnt mit der Betaversion von Chrome 100. So können Websites vor der Veröffentlichung von Chrome 101 den vollständigen User-Agent-String erhalten, bei dem der String der Nebenversion reduziert wird. Wenn Sie den Ursprungstest in Chrome 100 Beta testen möchten, bevor er im stabilen Kanal eingeführt wird, müssen Sie sich vor dem Veröffentlichungsdatum von Chrome 100 registrieren und den Test durchführen. Die Veröffentlichung von Chrome 100 ist derzeit für den 31. März 2022 geplant.

Im Folgenden finden Sie eine Übersicht über die Testphase der Einstellung und was Sie erwartet. Wenn Sie Feedback haben oder während des Tests Probleme auftreten, können Sie sich im GitHub-Repository für die UA-Reduzierung an uns wenden.

Was bedeutet das für Webentwickler?

Wenn Sie sich für die Testphase zur Einstellung registrieren, erhalten Websites weiterhin den vollständigen UA-String in navigator.userAgent und nicht reduzierte Werte in den zugehörigen JavaScript-Gettern navigator.platform und navigator.appVersion:

Der User-Agent-HTTP-Anfrageheader
Der navigator.userAgent-JavaScript-Getter
Der navigator.platform-JavaScript-Getter
Der navigator.appVersion-JavaScript-Getter

Betreiber von Websites sollten die Verwendung des User-Agent-Headers und der zugehörigen APIs weiterhin prüfen und sich gegebenenfalls auf die Migration zu User-Agent-Clienthinweisen vorbereiten, bevor die Testphase für die Einstellung abläuft. Diese Testphase soll nach Abschluss der Einführung der Nutzeragenten-Einschränkung enden.

Wie kann ich am Test zur Einstellung der Funktion „Reduzierung des User-Agents“ teilnehmen?

Für den Testzeitraum registrieren

Wenn Sie sich für den Ursprungstest registrieren und ein Token für Ihre Domains erhalten möchten, rufen Sie die Testseite zur Einstellung der User-Agent-Reduzierung auf. Wenn Sie ein Drittanbieter sind, setzen Sie ein Häkchen bei „Drittanbieterabgleich“.

Einrichtung

Nachdem Sie sich für den Test registriert haben, aktualisieren Sie Ihre HTTP-Antwortheader mit den folgenden Angaben:

Fügen Sie Ihrem HTTP-Antwortheader Origin-Trial: <ORIGIN TRIAL TOKEN> hinzu. <ORIGIN TRIAL TOKEN> enthält das Token, das du bei der Registrierung für den Testzeitraum erhalten hast.
Fügen Sie Ihrem HTTP-Antwortheader Accept-CH: Sec-CH-UA-Full hinzu. Wenn Sie Accept-CH festlegen, wird bei nachfolgenden Anfragen an den Ursprung nur der vollständige User-Agent-String gesendet.
Wenn der vollständige User-Agent-String bei der ersten Anfrage wichtig ist, fügen Sie Ihrem HTTP-Antwortheader zusätzlich zu den Headern Accept-CH und Origin-Trial den Header Critical-CH: Sec-CH-UA-Full hinzu.
Wir empfehlen Teilnehmern am Test zur Einstellung der Verringerung, allen Drittanbieterdomains Zugriff auf den vollständigen User-Agent-String zu gewähren. Wenn Sie den Zugriff von Drittanbieterdomains auf den vollständigen User-Agent-String nicht erweitern, wird der Zugriff auf den vollständigen User-Agent-String unabhängig von der Registrierung für die Testphase zur Einstellung der Verringerung blockiert. Sie können den vollständigen Zugriff des User-Agent-Strings auf Drittanbieterdomains mit einer der folgenden beiden Optionen zulassen:
- Fügen Sie einen Permissions-Policy-Header mit den Drittanbieterdomains hinzu, die den vollständigen User-Agent-String erhalten sollen.
  - Wenn Sie alle Drittanbieterdomains zulassen möchten, fügen Sie Permissions-Policy: ch-ua-full=* hinzu.
  - Wenn Sie eine benannte Liste von Drittanbieterdomains zulassen möchten, fügen Sie Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com") hinzu.
- Fügen Sie ein Accept-CH-Meta-Tag mit den Drittanbieterdomains hinzu, die den vollständigen User-Agent-String erhalten sollen (nur in Chrome 100 und höher).
  - Wenn Sie eine benannte Liste von Drittanbieterdomains zulassen möchten, fügen Sie <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com"> hinzu.
  - Es ist nicht möglich, über * im Meta-Tag an alle Drittanbieterdomains zu delegieren.
Laden Sie Ihre Website in Chrome 100 oder höher und erhalten Sie weiterhin den vollständigen User-Agent-String.

Demo

Unter https://uard-ot-demo.glitch.me finden Sie eine Demo des Tests (zusammen mit dem Quellcode).

Wie kann ich prüfen, ob die Testversion funktioniert?

Prüfen Sie die Anfrageheader, um sicherzustellen, dass der Test der Quelle funktioniert:

Der User-Agent-Header enthält die vollständige Version. Er darf keine der reduzierten Werte enthalten, die in der Liste der Beispiele für reduzierte User-Agent-Strings aufgeführt sind. Eine einfache Möglichkeit, dies zu erkennen, ist, dass der String der Chrome-Nebenversion nicht 0.0.0 sein darf.
Der Header Sec-CH-UA-Full ist auf ?1 gesetzt.

Die Header der ersten Antwort, die das Ursprungs-Test-Token enthalten, sollten so aussehen:

Die Header der ursprünglichen Antwort, die das Ursprungs-Test-Token enthalten.

Nachfolgende Anfrageheader, die den vollständigen User-Agent-String enthalten, sollten so aussehen:

Die nachfolgenden Anfrageheader, die den vollständigen User-Agent-String enthalten.

Wie kann ich die Teilnahme am Test zur Einstellung der User-Agent-Reduzierung beenden?

Sie können die Teilnahme jederzeit beenden und den reduzierten User-Agent-String erhalten. So beenden Sie die Teilnahme:

Senden Sie in Ihrer HTTP-Antwort einen Accept-CH-Header, der nicht Sec-CH-UA-Full enthält. Hinweis: Accept-CH mit einem leeren Wert ist eine gültige Möglichkeit, dies zu erreichen, wenn Ihre Website keine anderen Client-Hinweise anfordert.
Entfernen Sie den Origin-Trial-Header für den Test zur Einstellung der User-Agent-Reduzierung aus Ihrer HTTP-Antwort.
Entfernen Sie Sec-CH-UA-Full gegebenenfalls aus dem Critical-CH-Header in Ihrer HTTP-Antwort.

Wie unterscheidet sich dieser Test von anderen Tests für den User-Agent-Ursprung?

In Chrome werden zwei Ursprungstests zur Reduzierung des User-Agents durchgeführt. Der erste war der Ursprungstest zur Reduzierung des User-Agent-Strings, bei dem Websites den reduzierten User-Agent-String erhalten konnten, um ihre Anwendungsfälle zu testen und Feedback zu geben, bevor dies zum Standardverhalten in Chrome wird.

Die zweite, auf die hier verwiesen wird, ist ein Test zur Einstellung der Funktion für Websites, die etwas mehr Zeit für die Migration zur User-Agent Client Hints API benötigen. So erhalten Websites weiterhin den vollständigen User-Agent-String.

Wie lange dauert der Testzeitraum für die Einstellung?

Der Testzeitraum für die Einstellung der Reduzierung des User-Agents läuft von Chrome 100 bis Chrome 115. Chrome 116 ist die erste Version, bei der nur der vollständig reduzierte User-Agent-String gesendet wird.

Wie kann ich Feedback zum Testzeitraum für die Einstellung der User-Agent-Reduzierung geben?

Melden Sie Probleme oder geben Sie Feedback im GitHub-Repository zur User-Agent-Reduzierung.