Einstellungstest der User-Agent-Reduzierung

Der Test zur Einstellung der User-Agent-Reduzierung ermöglichte es Websites, nach der Reduzierung des UA-Strings weiterhin den vollständigen User-Agent-String zu empfangen. Der Testzeitraum endete am 23. September 2023.

Ab Chrome 101 wird die Anzahl der im User-Agent-String (UA) verfügbaren Informationen stufenweise reduziert. Websites, die noch nicht genügend Zeit hatten, den reduzierten User-Agent-String zu verwenden und auf User-Agent-Client-Hints umzustellen, können an einem Einstellungstest teilnehmen, um weiterhin den vollständigen User-Agent-String zu erhalten.

Die Registrierung für den Einstellungstest beginnt mit der Betaversion von Chrome 100. Dadurch können Websites den vollständigen User-Agent-String noch vor der Chrome 101-Version erhalten, in der der Nebenversionsstring reduziert wird. Wenn Sie den Ursprungstest in Chrome 100 Beta testen möchten, bevor er als stabile Version eingeführt wird, registrieren Sie sich vor dem Veröffentlichungsdatum für Chrome 100 (aktuell für den 31. März 2022).

Im Folgenden finden Sie einen Überblick über den Einstellungstest und die weitere Vorgehensweise. Wenn du Feedback hast oder während des Testzeitraums Probleme auftreten, kannst du dich über das GitHub-Repository zur UA-Reduktion an uns wenden.

Was bedeutet das für Webentwickler?

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

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

Websites sollten dennoch die Nutzung des User-Agent-Headers und zugehöriger APIs prüfen und bei Bedarf die Migration zu User-Agent-Client-Hints vorbereiten, bevor der Einstellungstest abläuft. Dieser Test zur Einstellung läuft ab, sobald das Roll-out der User-Agent-Reduktion abgeschlossen ist.

Wie kann ich am Test zur Einstellung der User-Agent-Reduktion teilnehmen?

Für die Testversion registrieren

Wenn Sie sich für den Ursprungstest registrieren und ein Token für Ihre Domains erhalten möchten, rufen Sie die Seite Test zur Einstellung der User-Agent-Reduktion auf. Wenn Sie von einem Drittanbieter registriert werden, aktivieren Sie bitte „Drittanbieter-Abgleich“.

Einrichtung

Nachdem Sie sich für die Testversion registriert haben, aktualisieren Sie Ihre HTTP-Antwortheader so:

  1. Fügen Sie Ihrem HTTP-Antwortheader Origin-Trial: <ORIGIN TRIAL TOKEN> hinzu. <ORIGIN TRIAL TOKEN> enthält das Token, das Sie bei der Registrierung für den Ursprungstest erhalten haben.
  2. Fügen Sie Ihrem HTTP-Antwortheader Accept-CH: Sec-CH-UA-Full hinzu. Wenn Sie „Accept-CH“ festlegen, wird nur bei nachfolgenden Anfragen an den Ursprung der vollständige User-Agent-String gesendet.
  3. 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 Critical-CH: Sec-CH-UA-Full hinzu.

  4. Teilnehmer, die am Test zur Einstellung der Reduktion teilnehmen, sollten allen Drittanbieterdomains Zugriff auf den vollständigen User-Agent-String gewähren. Wenn Sie den Zugriff für Drittanbieterdomains nicht auf den vollständigen User-Agent-String ausweiten, wird der Zugriff auf den gesamten User-Agent-String blockiert, unabhängig von ihrer eigenen Registrierung für den Test zur Einstellung der Reduktion. Sie haben zwei Möglichkeiten, um vollständigen Zugriff auf User-Agent-Strings auf Domains von Drittanbietern zu gewähren:

    • Fügen Sie einen Permissions-Policy-Header mit den Domains von Drittanbietern hinzu, die den vollständigen User-Agent-String erhalten sollen.
      • Fügen Sie Permissions-Policy: ch-ua-full=* hinzu, um alle Domains von Drittanbietern zuzulassen.
      • Fügen Sie Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com") hinzu, um eine benannte Liste von Drittanbieterdomains zuzulassen.
    • Fügen Sie ein Accept-CH-Meta-Tag mit den Domains von Drittanbietern hinzu, die den vollständigen User-Agent-String erhalten sollen (nur in Chrome 100 und höher).
      • Fügen Sie <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com"> hinzu, um eine benannte Liste von Drittanbieterdomains zuzulassen.
      • Es ist nicht möglich, über * im Meta-Tag an alle Domains von Drittanbietern zu delegieren.

  5. 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 Demonstration der Testversion (zusammen mit dem Quellcode).

Wie überprüfe ich, ob der Testzeitraum funktioniert?

Prüfen Sie die Anfrageheader auf Folgendes, um sicherzugehen, dass der Ursprungstest funktioniert:

  1. Der User-Agent-Header enthält die Vollversion. Er sollte keinen der reduzierten Werte enthalten (siehe Liste mit Beispielen für reduzierte User-Agent-Strings). Daran lässt sich leicht erkennen, dass der String der Chrome-Nebenversion nicht 0.0.0 sein sollte.
  2. Der Header Sec-CH-UA-Full ist auf ?1 festgelegt.

Die Header der ersten Antwort, die das Ursprungstesttoken enthalten, sollten so aussehen:

Die nachfolgenden Anfrageheader mit dem vollständigen User-Agent-String sollten so aussehen:

Wie beende ich die Teilnahme am Test zur Einstellung der User-Agent-Reduktion?

Sie können während des Testzeitraums jederzeit die Teilnahme beenden und den reduzierten User-Agent-String erhalten. So beenden Sie die Teilnahme:

  1. Senden Sie einen Accept-CH-Header in Ihrer HTTP-Antwort, der Sec-CH-UA-Full nicht enthält. Accept-CH mit einem leeren Wert ist eine gute Möglichkeit, dies zu erreichen, wenn deine Website keine anderen Clienthinweise anfordert.
  2. Entfernen Sie den Origin-Trial-Header für den Test zur Einstellung der User-Agent-Reduktion aus Ihrer HTTP-Antwort.
  3. Wenn festgelegt, entferne Sec-CH-UA-Full aus dem Critical-CH-Header in deiner HTTP-Antwort.

Wie unterscheidet sich dieser Test von anderen User-Agent-Ursprungstests?

In Chrome werden zwei Ursprungstests zur Reduzierung des User-Agents durchgeführt. Die erste war der Ursprungstest zur Reduzierung des User-Agents. Damit konnten Websites den reduzierten User-Agent-String empfangen, um Anwendungsfälle zu testen und Feedback zu geben, bevor er zum Standardverhalten in Chrome wurde.

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

Wie lange dauert der Test zur Einstellung?

Der Test zur Einstellung der Reduzierung des User-Agents läuft von Chrome 100 bis Chrome 115. Chrome 116 ist das erste Release, bei dem nur der vollständig reduzierte User-Agent-String gesendet wird.

Wie kann ich Feedback zum Test zur Einstellung der User-Agent-Reduktion geben?

Senden Sie Probleme und Feedback an das GitHub-Repository zur Reduzierung des User-Agents.