Essai d'abandon de la réduction user-agent

L'essai d'abandon de la réduction user-agent a permis aux sites de continuer à recevoir la chaîne user-agent complète après la réduction de la chaîne UA. L'essai a pris fin le 23 septembre 2023.

Avertissement:L'essai d'abandon de la réduction user-agent a pris fin le 23 septembre 2023. Les informations disponibles dans la chaîne user-agent ont été réduites à partir de Chrome 101. Pendant la période d'évaluation de l'abandon, les sites ont pu continuer à recevoir des parties de la chaîne UA, mais ils doivent désormais s'appuyer sur d'autres méthodes.

Pour remplacer une fonctionnalité qui reposait sur la chaîne user-agent, vous pouvez implémenter l'API client User-Agent.

La page User-Agent Client Hints (Informations client User-Agent) fournit des informations complémentaires.

Le reste de cet article de blog doit être considéré comme obsolète.

À partir de Chrome 101, les informations disponibles dans la chaîne user-agent (UA) seront réduites par étapes. Les sites qui n'ont pas eu le temps d'utiliser la chaîne user-agent réduite et de passer aux indicateurs client User-Agent peuvent participer à un essai d'abandon pour continuer à recevoir la chaîne user-agent complète.

L'inscription à l'évaluation avant arrêt débutera avec la version bêta de Chrome 100. Elle permettra aux sites de recevoir la chaîne user-agent complète avant le lancement de la version 101 de Chrome, où la chaîne de la version mineure sera réduite. Si vous souhaitez tester la phase d'évaluation sur la version bêta de Chrome 100 avant son lancement en version stable, inscrivez-vous et testez-la avant la date de sortie de Chrome 100 (actuellement prévue pour le 31 mars 2022).

Vous trouverez ci-dessous un aperçu de l'évaluation avant arrêt et de ce qui vous attend. Si vous avez des commentaires à nous transmettre ou si vous rencontrez des problèmes au cours de cet essai, n'hésitez pas à nous en faire part dans le dépôt GitHub sur la réduction d'UA.

Quel impact pour les développeurs Web ?

Si vous vous inscrivez à l'évaluation avant arrêt, les sites continueront de recevoir la chaîne UA complète dans navigator.userAgent et les valeurs non réduites dans les getters JavaScript navigator.platform et navigator.appVersion associés:

• L'en-tête de requête HTTP User-Agent
• Le getter JavaScript navigator.userAgent
• Le getter JavaScript navigator.platform
• Le getter JavaScript navigator.appVersion

Les sites doivent toujours auditer leur utilisation de l'en-tête user-agent et des API associées et, si nécessaire, se préparer à la migration vers les indicateurs client User-Agent avant la fin de l'essai d'abandon. L'intent expire une fois le déploiement de la réduction user-agent terminé.

Comment participer à l'essai d'abandon de la réduction user-agent ?

S'inscrire à l'essai

Pour vous inscrire à la phase d'évaluation et obtenir un jeton pour vos domaines, accédez à la page concernant l'abandon de la fonctionnalité User-Agent Reduction. Si vous êtes un tiers, veuillez cocher la case "Mise en correspondance tierce".

Préparation

Une fois inscrit à l'essai, modifiez vos en-têtes de réponse HTTP comme suit:

1. Ajoutez Origin-Trial: <ORIGIN TRIAL TOKEN> à votre en-tête de réponse HTTP. <ORIGIN TRIAL TOKEN> contient le jeton que vous avez obtenu lors de votre inscription à la phase d'évaluation.
2. Ajoutez Accept-CH: Sec-CH-UA-Full à votre en-tête de réponse HTTP. Si vous définissez Accept-CH, seule la chaîne user-agent complète sera envoyée lors des requêtes ultérieures adressées à l'origine.
3. Si la chaîne user-agent complète est essentielle à la première requête, ajoutez Critical-CH: Sec-CH-UA-Full à votre en-tête de réponse HTTP, en plus des en-têtes Accept-CH et Origin-Trial.

4. Pour les participants qui participent à l'essai d'abandon via la réduction, nous suggérons d'autoriser tous les domaines tiers à accéder à la chaîne user-agent complète. Si des domaines tiers n'ont pas accès à la chaîne user-agent complète, leur accès complet à cette chaîne sera bloqué, quelle que soit leur propre inscription à la période d'évaluation avant abandon. Vous pouvez autoriser l'accès complet de la chaîne user-agent aux domaines tiers de deux manières:

   • Ajoutez un en-tête Permissions-Policy avec les domaines tiers qui doivent recevoir la chaîne user-agent complète.
     • Pour autoriser tous les domaines tiers, ajoutez Permissions-Policy: ch-ua-full=*.
     • Pour autoriser une liste nommée de domaines tiers, ajoutez Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
   • Ajoutez une balise Meta Accept-CH avec les domaines tiers qui doivent recevoir la chaîne user-agent complète (uniquement dans Chrome 100 et versions ultérieures).
     • Pour autoriser une liste nommée de domaines tiers, ajoutez <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
     • Vous ne pouvez pas déléguer à tous les domaines tiers via * dans la balise Meta.

5. Chargez votre site Web dans Chrome 100 (ou version ultérieure) et continuez à recevoir la chaîne user-agent complète.

Remarque :Une intégration tierce peut s'inscrire à l'essai et s'y inscrire sans que le site de premier niveau ne délègue l'autorisation via les règles relatives aux autorisations ou <meta http-equiv="delegate-ch">. Les conseils standards pour les phases d'évaluation tierces s'appliquent.

Démonstration

Consultez https://uard-ot-demo.glitch.me pour une démonstration du test (avec le code source).

Comment vérifier que l'essai fonctionne ?

Pour vérifier que la phase d'évaluation fonctionne, examinez les en-têtes de requête et vérifiez les points suivants:

1. L'en-tête user-agent contient la version complète. Il ne doit pas contenir les valeurs réduites (disponibles dans la liste des exemples de chaînes user-agent réduites). Pour savoir facilement que la chaîne de la version mineure de Chrome ne doit pas être 0.0.0,
2. L'en-tête Sec-CH-UA-Full est défini sur ?1.

Les en-têtes de la réponse initiale contenant le jeton "origin-trial" doivent se présenter comme suit:

Les en-têtes de requêtes suivants contenant la chaîne user-agent complète doivent se présenter comme suit:

Comment puis-je arrêter de participer à l'essai d'abandon de la réduction user-agent ?

Au cours de la période d'essai, vous pouvez à tout moment arrêter de participer et recevoir la chaîne user-agent réduite. Pour ne plus participer:

1. Envoyez dans votre réponse HTTP un en-tête Accept-CH qui n'inclut pas Sec-CH-UA-Full. Notez que Accept-CH avec une valeur vide constitue un moyen valide d'effectuer cette opération si votre site ne demande aucun autre Client Hint.
2. Supprimez l'en-tête Origin-Trial de l'essai d'abandon de la réduction user-agent de votre réponse HTTP.
3. Si ce champ est défini, supprimez Sec-CH-UA-Full de l'en-tête Critical-CH dans votre réponse HTTP.

En quoi ce test est-il différent des autres phases d'évaluation User-Agent ?

Chrome exécute deux phases d'évaluation liées à la réduction user-agent. La première était la phase d'évaluation de la fonctionnalité User-Agent Reduction, qui permettait aux sites de recevoir la chaîne user-agent réduite pour tester leurs cas d'utilisation et envoyer des commentaires avant qu'elle ne devienne le comportement par défaut dans Chrome.

Le deuxième, mentionné ici, est un essai d'abandon destiné aux sites qui ont besoin d'un peu plus de temps pour migrer vers l'API User-Agent Client Hints. Elle permet aux sites de continuer à recevoir la chaîne user-agent complète.

Combien de temps durera l'évaluation avant arrêt ?

L'essai d'abandon de la réduction user-agent se déroulera de Chrome 100 à Chrome 115. Chrome 116 sera la première version dans laquelle seule la chaîne user-agent entièrement réduite sera envoyée.

Comment envoyer des commentaires sur l'essai d'amortissement de réduction user-agent ?

Si vous rencontrez des problèmes ou envoyez des commentaires, accédez au dépôt GitHub "User-Agent Reduction".