En-tête Sec-CH-UA
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
L'en-tête de requête HTTP Sec-CH-UA est une indication client de l'agent utilisateur qui fournit les informations de marque et de version significative de l'agent utilisateur.
L'en-tête Sec-CH-UA fournit la marque et la version significative pour chaque marque associée au navigateur dans une liste séparée par des virgules.
L'en-tête permet donc au serveur de personnaliser sa réponse en fonction des marques partagées et des personnalisations particulières dans leurs versions respectives.
Sec-CH-UA est une indication à faible entropie.
Sauf blocage explicite par une politique de permission de l'agent utilisateur, il est envoyé par défaut, sans que le serveur ait besoin de s'inscrire en envoyant Accept-CH.
L'en-tête peut inclure des marques « fausses » à n'importe quelle position et avec n'importe quel nom. C'est une fonctionnalité conçue pour empêcher les serveurs de rejeter complètement les agents utilisateurs inconnus, obligeant ainsi les agents utilisateurs à mentir sur leur identité de marque.
Note :
L'en-tête Sec-CH-UA-Full-Version-List est identique à Sec-CH-UA, mais inclut le numéro de version complet plutôt que le numéro de version significatif pour chaque marque.
| Type d'en-tête | En-tête de requête, Indication du client |
|---|---|
| En-tête de requête interdit | Oui (préfixe Sec-) |
Syntaxe
Sec-CH-UA: "<brand>";v="<significant version>", …
La valeur est une liste séparée par des virgules des marques dans la liste des marques de l'agent utilisateur, et de leur numéro de version significatif associé.
Directives
<brand>-
Une marque associée à l'agent utilisateur, comme « Chromium », « Google Chrome », ou une marque intentionnellement incorrecte comme
"Not A;Brand". <significant version>-
Le numéro de version « marketing » associé aux fonctionnalités distinctives exposées sur le web.
Description
Une marque est un nom commercial pour l'agent utilisateur, comme : Chromium, Opera, Google Chrome, Microsoft Edge, Firefox et Safari.
Un agent utilisateur peut avoir plusieurs marques associées.
Par exemple, Opera, Chrome et Edge sont tous basés sur Chromium, et fourniront donc les deux marques dans l'en-tête Sec-CH-UA.
Le numéro de version significatif est l'identifiant de version « marketing » utilisé pour distinguer les principales versions de la marque. Par exemple, une build de Chromium avec un numéro de version complet « 96.0.4664.45 » a un numéro de version significatif de « 96 ».
Exemples
Différentes marques Sec-CH-UA
Sec-CH-UA est une indication de faible entropie.
Sauf blocage explicite par une politique de l'agent utilisateur, elle est envoyée dans toutes les requêtes (sans que le serveur ait à s'inscrire en envoyant Accept-CH).
Les chaînes provenant des navigateurs de bureau Chromium, Chrome, Edge et Opera sont affichées ci-dessous. Notez qu'ils partagent tous la marque « Chromium », mais ont une marque supplémentaire indiquant leur origine. Ils ont également une chaîne de caractères de marque intentionnellement incorrecte, qui peut apparaître à n'importe quelle position et avoir un texte différent.
Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"
Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"
Spécifications
| Spécification |
|---|
| User-Agent Client Hints # sec-ch-ua |
Compatibilité des navigateurs
Voir aussi
- Indications du client
- L'API d'indications de l'agent utilisateur du client
- L'en-tête
Accept-CH - HTTP Caching : Vary et l'en-tête
Vary - Améliorer la confidentialité des utilisateur·ice·s et l'expérience des développeur·euse·s avec les indications de l'agent utilisateur du client (angl.) sur developer.chrome.com