aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/http/headers/index.html
blob: a493fb6715378e57e6a64851a48811c4fead2c1b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
---
title: En-têtes HTTP
slug: Web/HTTP/Headers
tags:
  - En-têtes
  - HTTP
  - Headers
  - Networking
  - Overview
  - Reference
translation_of: Web/HTTP/Headers
---
<div>{{HTTPSidebar}}</div>

<p>Les en-têtes HTTP permettent au client et au serveur de transmettre des informations supplémentaires avec la requête ou la réponse. Un en-tête de requête est constitué de son nom (insensible à la casse) suivi d'un deux-points <code>:</code>, puis de sa valeur (sans saut de ligne). L'espace blanc avant la valeur est ignoré.</p>

<p>Des en-têtes propriétaires personnalisés peuvent être ajoutés en utilisant le préfixe <code>X-</code>, mais cette convention a été abandonnée en juin 2012, en raison des inconvénients qu'elle a présenté lorsque des champs non standard sont devenus standard dans <a class="external" href="https://tools.ietf.org/html/rfc6648">RFC 6648</a>; les autres en-têtes possibles sont listés dans une <a class="external" href="https://www.iana.org/assignments/message-headers/message-headers.xhtml">liste IANA</a> et ont été définis dans la <a class="external" href="https://tools.ietf.org/html/rfc4229">RFC 4229</a>. IANA maintient également une <a class="external" href="https://www.iana.org/assignments/message-headers/message-headers.xhtml">liste des propositions de nouveaux entêtes HTTP</a>.</p>

<p>Les en-têtes peuvent être groupés selon leur contexte :</p>

<ul>
 <li>{{Glossary("General header","En-tête général")}} : en-têtes s'appliquant à la fois aux requêtes et aux réponses mais sans rapport avec les données éventuellement transmises dans le corps de la requête ou de la réponse.</li>
 <li>{{Glossary("Request header","En-tête de requête")}} : en-têtes contenant plus d'informations au sujet de la ressource à aller chercher ou à propos du client lui-même.</li>
 <li>{{Glossary("Response header","En-tête de réponse")}} : en-têtes contenant des informations additionnelles au sujet de la réponse comme son emplacement, ou au sujet du serveur lui-même (nom et version, etc.)</li>
 <li>{{Glossary("Entity header","En-tête d'entité")}} : en-têtes contenant plus d'informations au sujet du corps de l'entité comme la longueur de son contenu ou son <a href="/fr/docs/Glossaire/Type_MIME">type MIME</a>.</li>
</ul>

<p>Les en-têtes peuvent aussi être groupés par la manière dont les {{Glossary("Proxy_server", "serveurs mandataires (proxies)")}} les traitent :</p>

<ul>
 <li>{{httpheader("Connection")}}</li>
 <li>{{httpheader("Keep-Alive")}}</li>
 <li>{{httpheader("Proxy-Authenticate")}}</li>
 <li>{{httpheader("Proxy-Authorization")}}</li>
 <li>{{httpheader("TE")}}</li>
 <li>{{httpheader("Trailer")}}</li>
 <li>{{httpheader("Transfer-Encoding")}}</li>
 <li>{{httpheader("Upgrade")}} (voir aussi <a href="/fr/docs/Web/HTTP/Protocol_upgrade_mechanism">mécanisme de mise à jour de protocole</a>)</li>
</ul>

<dl>
 <dt>En-têtes de bout en bout ('End-to-end headers') :</dt>
 <dd>Ces entêtes doivent être transmis au destinataire final du message ; c'est-à-dire le serveur dans le cas d'une requête ou le client dans le cas d'une réponse. Les serveurs mandataires intermédiaires doivent retransmettre les en-têtes de bout en bout sans modification et doivent les mettre en cache.</dd>
 <dt>En-têtes de point à point ('Hop-by-hop headers') :</dt>
 <dd>Ces en-têtes n'ont de sens que pour une unique connexion de la <a class="external" href="https://fr.wikipedia.org/wiki/Couche_transport">couche transport</a> et ne doivent pas être retransmis par des serveurs mandataires ou mis en cache. Il s'agit d'en-têtes tels que: {{httpheader("Connection")}}, {{httpheader("Keep-Alive")}}, {{httpheader("Proxy-Authenticate")}}, {{httpheader("Proxy-Authorization")}}, {{httpheader("TE")}}, {{httpheader("Trailer")}}, {{ httpheader("Transfer-Encoding")}} et {{httpheader("Upgrade")}}. A noter que seuls les en-têtes de point à point peuvent être utilisés avec l'en-tête général {{httpheader("Connection")}}.</dd>
</dl>

<p>La liste suivante résume les en-têtes HTTP en fonction de leur utilisation. Une liste triée par ordre alphabétique est disponible dans le panneau de navigation à gauche.</p>

<h2 id="Authentification">Authentification</h2>

<dl>
 <dt>{{HTTPHeader("WWW-Authenticate")}}</dt>
 <dd>définit la méthode d'authentification qui doit être utilisée pour obtenir l'accès à la ressource.</dd>
 <dt>{{HTTPHeader("Authorization")}}</dt>
 <dd>contient les informations d'identification pour authentifier un agent utilisateur avec un serveur.</dd>
 <dt>{{HTTPHeader("Proxy-Authenticate")}}</dt>
 <dd>définit la méthode d'authentification qui doit être utilisée pour obtenir la ressource derrière un serveur mandataire.</dd>
 <dt>{{HTTPHeader("Proxy-Authorization")}}</dt>
 <dd>contient les informations d'identification nécessaires pour authentifier un agent utilisateur avec un serveur mandataire.</dd>
</dl>

<h2 id="Mise_en_cache">Mise en cache</h2>

<dl>
 <dt>{{HTTPHeader("Age")}}</dt>
 <dd>la durée en secondes passée par l'objet dans un cache proxy.</dd>
 <dt>{{HTTPHeader("Cache-Control")}}</dt>
 <dd>spécifie des directives pour les mécanismes de mise en cache dans les requêtes et les réponses.</dd>
 <dt>{{HTTPHeader("Clear-Site-Data")}}</dt>
 <dd>nettoie les données de navigation (mouchards (<em>cookies</em>), stockage et cache) associé au site demandé.</dd>
 <dt>{{HTTPHeader("Expires")}}</dt>
 <dd>la date et l'heure après lesquelles la réponse est considérée comme périmée.</dd>
 <dt>{{HTTPHeader("Pragma")}}</dt>
 <dd>en-tête spécifique à la mise en œuvre pouvant avoir divers effets le long de la chaîne de requête-réponse. Utilisé pour la rétrocompatibilité avec les caches HTTP / 1.0 où l'en-tête <code>Cache-Control</code> n'est pas encore présent.</dd>
 <dt>{{HTTPHeader("Warning")}}</dt>
 <dd>un champ d'avertissement général contenant des informations sur les problèmes possibles.</dd>
</dl>

<h2 id="Astuces_client">Astuces client</h2>

<p>Les {{Glossary("Client_hints", "astuces clients")}} HTTP sont enc cours de création. La documentation actuelle est disponible sur le <a href="https://httpwg.org/http-extensions/client-hints.html">site du groupe de travail sur HTTP</a>.</p>

<dl>
 <dt>{{HTTPHeader("Accept-CH")}} {{experimental_inline}}</dt>
 <dd>les serveurs peuvent informer de leur niveau de support pour les Client Hints en utilisant l'en-tête <code>Accept-CH</code> ou en HTML avec l'élément <code>&lt;meta&gt;</code> ayant l'attribut <code>http-equiv</code> (<a href="https://httpwg.org/http-extensions/client-hints.html#HTML5"><cite>[HTML5]</cite></a>).</dd>
 <dt>{{HTTPHeader("Accept-CH-Lifetime")}} {{experimental_inline}}</dt>
 <dd>les serveurs peuvent demander au client de mémoriser l'ensemble des Client Hints que le serveur supporte pour une période de temps donnée, afin de permettre la livraison de Client Hints sur les requêtes suivantes vers l'origine du serveur (<a href="https://httpwg.org/http-extensions/client-hints.html#RFC6454"><cite>[RFC6454]</cite></a>).</dd>
 <dt>{{HTTPHeader("Content-DPR")}} {{experimental_inline}}</dt>
 <dd>un nombre indiquant le rapport entre le nombre de pixels physiques et le nombre de pixels CSS de l'image réponse sélectionnée.</dd>
 <dt>{{HTTPHeader("DPR")}} {{experimental_inline}}</dt>
 <dd>un nombre indiquant le Device Pixel Ratio (DPR) actuel du client, qui est le rapport du nombre de pixels physiques sur le nombre de pixels CSS (Section 5.2 of <a href="https://httpwg.org/http-extensions/client-hints.html#CSSVAL"><cite>[CSSVAL]</cite></a>) de la zone d'affichage (Section 9.1.1 of <a href="https://httpwg.org/http-extensions/client-hints.html#CSS2"><cite>[CSS2]</cite></a>) sur l'appareil.</dd>
 <dt>{{HTTPHeader("Device-Memory")}} {{experimental_inline}}</dt>
 <dd>faisant techniquement partie de l'API Device Memory, cet en-tête représente la quantité approximative de mémoire vive dont le client dispose.</dd>
 <dt>{{HTTPHeader("Early-Data")}} {{experimental_inline}}</dt>
 <dd>indique que les requêtes doivent être communiquées en TLS early data.</dd>
 <dt>{{HTTPHeader("Save-Data")}} {{experimental_inline}}</dt>
 <dd>booléen indiquant les préférences de l'agent utilisateur pour réduire la quantité de données transmises.</dd>
 <dt>{{HTTPHeader("Viewport-Width")}} {{experimental_inline}}</dt>
 <dd>la largeur de la zone d'affichage, soit le nombre de pixels CSS. La valeur fournise est arrondie au plus grand proche supérieur.</dd>
 <dd>Si <code>Viewport-Width</code> apparait dans un message plus d'une fois, la dernière valeur écrase toutes les valeurs précédentes.</dd>
 <dt>{{HTTPHeader("Width")}} {{experimental_inline}}</dt>
 <dd>l'en-tête de requête <code>Width</code> représente la largeur de la ressource voulue en nombre de pixels physiques. La valeur fournise est arrondie au plus proche entier supérieur.</dd>
 <dd>Si la largeur de la ressource voulue est inconnue quand la requête ou la ressource n'a pas de largeur d'affichage, l'en-tête <code>Width</code> peut être omise. Si <code>Width</code> apparait dans un message plus d'une fois, la dernière valeur écrase toutes les valeurs précédentes.</dd>
</dl>

<h2 id="Conditionnels">Conditionnels</h2>

<dl>
 <dt>{{HTTPHeader("Last-Modified")}}</dt>
 <dd>c'est un validateur, la dernière date de modification de la ressource, utilisée pour comparer plusieurs versions de la même ressource. Il est moins précis que {{HTTPHeader("ETag")}}, mais plus facile à calculer dans certains environnements. Les requêtes conditionnelles utilisant {{HTTPHeader("If-Modified-Since")}} et {{HTTPHeader("If-Unmodified-Since")}} utilisent cette valeur pour modifier le comportement de la requête.</dd>
 <dt>{{HTTPHeader("ETag")}}</dt>
 <dd>c'est un validateur, une chaîne unique identifiant la version de la ressource. Les requêtes conditionnelles utilisant {{HTTPHeader("If-Match")}} et {{HTTPHeader("If-None-Match")}} utilisent cette valeur pour changer le comportement de la requête.</dd>
 <dt>{{HTTPHeader("If-Match")}}</dt>
 <dd>rend la requête conditionnelle et n'applique la méthode que si la ressource stockée correspond à l'un des ETags donnés.</dd>
 <dt>{{HTTPHeader("If-None-Match")}}</dt>
 <dd>rend la requête conditionnelle et n'applique la méthode que si la ressource stockée ne correspond à aucun des ETags donnés. Ceci est utilisé pour mettre à jour les caches (pour les requêtes sécurisées), ou pour empêcher de télécharger une nouvelle ressource lorsqu'elle existe déjà.</dd>
 <dt>{{HTTPHeader("If-Modified-Since")}}</dt>
 <dd>rend la requête conditionnelle et attend que l'entité soit transmise seulement si elle a été modifiée après la date donnée. Ceci est utilisé pour transmettre des données uniquement lorsque le cache est obsolète.</dd>
 <dt>{{HTTPHeader("If-Unmodified-Since")}}</dt>
 <dd>rend la demande conditionnelle et attend que l'entité soit transmise seulement si elle n'a pas été modifiée après la date donnée. Ceci est utilisé pour assurer la cohérence d'un nouveau fragment d'une plage spécifique avec les précédentes, ou pour implémenter un système de contrôle de concurrence optimiste lors de la modification de documents existants.</dd>
 <dt>{{HTTPHeader("Vary")}}</dt>
 <dd>détermine comment faire correspondre les futurs en-têtes de demande pour décider si une réponse mise en cache peut être utilisée plutôt que d'en demander une nouvelle au serveur d'origine.</dd>
</dl>

<h2 id="Gestion_de_connexion">Gestion de connexion</h2>

<dl>
 <dt>{{HTTPHeader("Connection")}}</dt>
 <dd>contrôle si la connexion réseau reste ouverte après la fin de la transaction en cours.</dd>
 <dt>{{HTTPHeader("Keep-Alive")}}</dt>
 <dd>contrôle la durée pendant laquelle une connexion persistante doit rester ouverte.</dd>
</dl>

<h2 id="Négociation_de_contenu">Négociation de contenu</h2>

<dl>
 <dt>{{HTTPHeader("Accept")}}</dt>
 <dd>informe le serveur des types de données pouvant être renvoyés. C'est un type MIME.</dd>
 <dt>{{HTTPHeader("Accept-Charset")}}</dt>
 <dd>informe le serveur du jeu de caractères que le client peut comprendre.</dd>
 <dt>{{HTTPHeader("Accept-Encoding")}}</dt>
 <dd>informe le serveur sur l'algorithme de codage, généralement un algorithme de compression, qui peut être utilisé sur la ressource renvoyée.</dd>
 <dt>{{HTTPHeader("Accept-Language")}}</dt>
 <dd>informe le serveur de la langue que le serveur doit renvoyer. Ceci est un indice et n'est pas nécessairement sous le contrôle total de l'utilisateur : le serveur doit toujours faire attention à ne pas remplacer un choix explicite de l'utilisateur (telle la sélection d'une langue dans une liste déroulante).</dd>
</dl>

<h2 id="Contrôles">Contrôles</h2>

<dl>
 <dt>{{HTTPHeader("Expect")}}</dt>
 <dd>indique ce qui est attendu de la part du serveur afin de pouvoier gérer correctement la requête.</dd>
 <dt>{{HTTPHeader("Max-Forwards")}}</dt>
 <dd>...</dd>
</dl>

<h2 id="Cookies">Cookies</h2>

<dl>
 <dt>{{HTTPHeader("Cookie")}}</dt>
 <dd>contient les <a href="/fr/docs/HTTP/Cookies">cookies HTTP</a> stockés précédemment envoyés par le serveur à l'aide de l'en-tête {{HTTPHeader("Set-Cookie")}}.</dd>
 <dt>{{HTTPHeader("Set-Cookie")}}</dt>
 <dd>envoie des cookies du serveur à l'agent utilisateur.</dd>
 <dt>{{HTTPHeader("Cookie2")}} {{obsolete_inline}}</dt>
 <dd>utilisé pour contenir un cookie HTTP, précédemment envoyé par le serveur avec l'en-tête {{HTTPHeader("Set-Cookie2")}}, mais qui a été rendu obsolète par la spécification. Utilisez {{HTTPHeader("Cookie")}} à la place.</dd>
 <dt>{{HTTPHeader("Set-Cookie2")}} {{obsolete_inline}}</dt>
 <dd>utilisé pour envoyer des cookies du serveur à l'agent utilisateur, mais a été rendu obsolète par la spécification. Utilisez {{HTTPHeader("Set-Cookie")}} à la place.</dd>
</dl>

<h2 id="Cross-Origin_Resource_Sharing_CORS"><a href="/fr/docs/Web/HTTP/CORS">Cross-Origin Resource Sharing (CORS)</a></h2>

<dl>
 <dt>{{HTTPHeader("Access-Control-Allow-Origin")}}</dt>
 <dd>indique si la réponse peut être partagée.</dd>
 <dt>{{HTTPHeader("Access-Control-Allow-Credentials")}}</dt>
 <dd>indique si la réponse à la demande peut être exposée lorsque l'indicateur d'informations d'identification est vrai.</dd>
 <dt>{{HTTPHeader("Access-Control-Allow-Headers")}}</dt>
 <dd>utilisé en réponse à une demande de contrôle en amont pour indiquer quels en-têtes HTTP peuvent être utilisés lors de la requête effective.</dd>
 <dt>{{HTTPHeader("Access-Control-Allow-Methods")}}</dt>
 <dd>spécifie la ou les méthodes autorisées lors de l'accès à la ressource en réponse à une demande de contrôle en amont.</dd>
 <dt>{{HTTPHeader("Access-Control-Expose-Headers")}}</dt>
 <dd>indique en-têtes pouvant être exposés dans le cadre de la réponse en listant leurs noms.</dd>
 <dt>{{HTTPHeader("Access-Control-Max-Age")}}</dt>
 <dd>indique la durée pendant laquelle les résultats d'une demande de contrôle en amont peuvent être mis en cache.</dd>
 <dt>{{HTTPHeader("Access-Control-Request-Headers")}}</dt>
 <dd>utilisé lors de l'émission d'une demande de contrôle en amont pour indiquer au serveur les en-têtes HTTP qui seront utilisés lors de la requête effective.</dd>
 <dt>{{HTTPHeader("Access-Control-Request-Method")}}</dt>
 <dd>Utilisé lors de l'émission d'une demande de contrôle en amont pour indiquer au serveur la <a href="/fr/docs/Web/HTTP/Methods">méthode HTTP</a> à utiliser lors de la requête.</dd>
 <dt>{{HTTPHeader("Origin")}}</dt>
 <dd>indique l'origine d'une consultation.</dd>
 <dt>{{HTTPHeader("Timing-Allow-Origin")}}</dt>
 <dd>spécifie les origines autorisées à voir les valeurs des attributs récupérés via les fonctionnalités de l'<a href="/fr/docs/Web/API/Resource_Timing_API">API Resource Timing</a>, qui seraient autrement signalées comme étant zéro en raison des restrictions d'origines croisées.</dd>
</dl>

<h2 id="Ne_pas_suivre">Ne pas suivre</h2>

<dl>
 <dt>{{HTTPHeader("DNT")}}</dt>
 <dd>utilisé pour exprimer la préférence de suivi de l'utilisateur.</dd>
 <dt>{{HTTPHeader("Tk")}}</dt>
 <dd>indique l'état de suivi appliqué à la demande correspondante.</dd>
</dl>

<h2 id="Téléchargements">Téléchargements</h2>

<dl>
 <dt>{{HTTPHeader("Content-Disposition")}}</dt>
 <dd>est un en-tête de réponse si la ressource transmise doit être affichée en ligne (comportement par défaut lorsque l'en-tête n'est pas présent), ou doit être traitée comme un téléchargement et le navigateur doit présenter une fenêtre "Enregistrer sous".</dd>
</dl>

<h2 id="Informations_sur_le_corps_du_message">Informations sur le corps du message</h2>

<dl>
 <dt>{{HTTPHeader("Content-Length")}}</dt>
 <dd>indique la taille du corps d'entité, en nombre décimal d'octets, envoyée au destinataire.</dd>
 <dt>{{HTTPHeader("Content-Type")}}</dt>
 <dd>indique le type de média de la ressource.</dd>
 <dt>{{HTTPHeader("Content-Encoding")}}</dt>
 <dd>utilisé pour spécifier l'algorithme de compression.</dd>
 <dt>{{HTTPHeader("Content-Language")}}</dt>
 <dd>décrit la (les) langue(s) destinée(s) à l'audience, de sorte qu'elle permette à l'utilisateur de se différencier en fonction de la langue préférée de l'utilisateur.</dd>
 <dt>{{HTTPHeader("Content-Location")}}</dt>
 <dd>indique un emplacement pour les données renvoyées.</dd>
</dl>

<h2 id="Proxies">Proxies</h2>

<dl>
 <dt>{{HTTPHeader("Forwarded")}}</dt>
 <dd>contient des informations du côté client des serveurs proxy qui sont modifiées ou perdues lorsqu'un proxy est impliqué dans le chemin de la requête.</dd>
 <dt>{{HTTPHeader("X-Forwarded-For")}} {{non-standard_inline}}</dt>
 <dd>identifie les adresses IP d'origine d'un client se connectant à un serveur Web via un proxy HTTP ou un répartiteur de charge.</dd>
 <dt>{{HTTPHeader("X-Forwarded-Host")}} {{non-standard_inline}}</dt>
 <dd>identifie l'hôte d'origine demandé à un client pour se connecter à votre proxy ou à votre équilibreur de charge.</dd>
 <dt>{{HTTPHeader("X-Forwarded-Proto")}} {{non-standard_inline}}</dt>
 <dd>identifie le protocole (HTTP ou HTTPS) utilisé par un client pour se connecter à votre proxy ou votre équilibreur de charge.</dd>
 <dt>{{HTTPHeader("Via")}}</dt>
 <dd>ajoutés par des proxies, directs et inverses, et peuvent apparaître dans les en-têtes de requête et les en-têtes de réponse.</dd>
</dl>

<h2 id="Redirection">Redirection</h2>

<dl>
 <dt>{{HTTPHeader("Location")}}</dt>
 <dd>indique l'URL de la page de redirection.</dd>
</dl>

<h2 id="Contexte_de_requête">Contexte de requête</h2>

<dl>
 <dt>{{HTTPHeader("From")}}</dt>
 <dd>contient une adresse électronique Internet pour un utilisateur humain qui contrôle l'agent utilisateur demandeur.</dd>
 <dt>{{HTTPHeader("Host")}}</dt>
 <dd>indique le nom de domaine du serveur (pour l'hébergement virtuel) et (facultativement) le numéro de port TCP sur lequel le serveur écoute.</dd>
 <dt>{{HTTPHeader("Referer")}}</dt>
 <dd>L'adresse de la page Web précédente à partir de laquelle un lien vers la page actuellement demandée a été suivi.</dd>
 <dt>{{HTTPHeader("Referrer-Policy")}}</dt>
 <dd>indique quelles informations de provenance envoyées dans l'en-tête {{HTTPHeader("Referer")}} doivent être incluses dans les requêtes effectuées.</dd>
 <dt>{{HTTPHeader("User-Agent")}}</dt>
 <dd>contient une chaîne caractéristique qui permet aux homologues du protocole réseau d'identifier le type d'application, le système d'exploitation, le fournisseur du logiciel ou la version du logiciel de l'agent utilisateur du logiciel demandeur. Voir aussi <a href="/fr/docs/HTTP/Gecko_user_agent_string_reference">la référence de chaîne de l'agent utilisateur Firefox</a>.</dd>
</dl>

<h2 id="Contexte_de_réponse">Contexte de réponse</h2>

<dl>
 <dt>{{HTTPHeader("Allow")}}</dt>
 <dd>répertorie l'ensemble des méthodes de requête HTTP prises en charge par une ressource.</dd>
 <dt>{{HTTPHeader("Server")}}</dt>
 <dd>contient des informations sur le logiciel utilisé par le serveur d'origine pour gérer la demande.</dd>
</dl>

<h2 id="Demandes_de_plage">Demandes de plage</h2>

<dl>
 <dt>{{HTTPHeader("Accept-Ranges")}}</dt>
 <dd>indique si le serveur prend en charge les demandes de plage et, le cas échéant, dans quelle unité la plage peut être exprimée.</dd>
 <dt>{{HTTPHeader("Range")}}</dt>
 <dd>indique la partie d'un document que le serveur doit renvoyer.</dd>
 <dt>{{HTTPHeader("If-Range")}}</dt>
 <dd>crée une requête de plage conditionnelle qui n'est remplie que si l'étiquette et la date correspondent à la ressource distante. Utilisé pour empêcher le téléchargement de deux plages à partir d'une version incompatible de la ressource.</dd>
 <dt>{{HTTPHeader("Content-Range")}}</dt>
 <dd>situe une partie de message à l'intérieur du corps d'un message entier.</dd>
</dl>

<h2 id="Sécurité">Sécurité</h2>

<dl>
 <dt>{{HTTPHeader("Cross-Origin-Embedder-Policy")}} ({{Glossary("COEP")}})</dt>
 <dd>autorise un serveur à déclarer une règlementation sur les contenus embarqués pour un document donné.</dd>
</dl>

<dl>
 <dt>{{HTTPHeader("Cross-Origin-Opener-Policy")}} ({{Glossary("COOP")}})</dt>
 <dd>interdit les autres domaines d'ouvrir ou de contrôler une fenêtre.</dd>
</dl>

<dl>
 <dt>{{HTTPHeader("Cross-Origin-Resource-Policy")}} ({{Glossary("CORP")}})</dt>
 <dd>interdit les autre domaines de lire la réponse des ressources si cet en-tête leur est appliqué.</dd>
</dl>

<dl>
 <dt>{{HTTPHeader("Content-Security-Policy")}} ({{Glossary("CSP")}})</dt>
 <dd>contrôle les ressources que l'agent utilisateur est autorisé à charger pour une page donnée.</dd>
 <dt>{{HTTPHeader("Content-Security-Policy-Report-Only")}}</dt>
 <dd>permet aux développeurs web d'expérimenter des stratégies en surveillant (mais non en appliquant) leurs effets. Ces rapports de violation sont constitués de documents {{Glossary("JSON")}} envoyés via une requête HTTP <code>POST</code> à l'URI spécifié.</dd>
 <dt>{{HTTPHeader("Expect-CT")}}</dt>
 <dd>permet aux sites de contrôler de manière stricte ou non l'adhérence aux règles de transparence des certificats, permettant ainsi de limiter les utilisations frauduleuses du certificat associé au site grâce à une vérification publique.</dd>
 <dt>{{HTTPHeader("Feature-Policy")}}</dt>
 <dd>permet d'autoriser ou d'interdire l'utilisation de fonctionnalités du navigateur dans son propre cadre et dans les cadres embarqués.</dd>
 <dt>{{HTTPHeader("Origin-Isolation")}} {{experimental_inline}}</dt>
 <dd>permet aux application web d'isoler leurs origines.</dd>
 <dt>{{HTTPHeader("Strict-Transport-Security")}} ({{Glossary("HSTS")}})</dt>
 <dd>force la communication en utilisant HTTPS au lieu de HTTP.</dd>
 <dt>{{HTTPHeader("Upgrade-Insecure-Requests")}}</dt>
 <dd>envoie un signal au serveur exprimant la préférence du client pour une réponse chiffrée et authentifiée, et qu'il peut gérer avec succès la directive {{CSP("upgrade-insecure-requests")}}.</dd>
 <dt>{{HTTPHeader("X-Content-Type-Options")}}</dt>
 <dd>désactive le repérage MIME et force le navigateur à utiliser le type donné dans {{HTTPHeader("Content-Type")}}.</dd>
 <dt>{{HTTPHeader("X-Download-Options")}}</dt>
 <dd>indique que le navigateur (Internet Explorer uniquement) ne doit pas affiche l'option permettant d'ouvrir un fichier qui a été téléchargé depuis une application, pour empêcher les attaques par hameçonnage puisque le fichier pourrait autrement obtenir le droit de s'exécuter dans le contexte de l'application. Note : voir le <a href="https://developer.microsoft.com/en-us/microsoft-edge/platform/issues/18488178/">bogue MS Edge</a> associé.</dd>
 <dt>{{HTTPHeader("X-Frame-Options")}} (XFO)</dt>
 <dd>indique si un navigateur doit être autorisé à afficher une page dans un {{HTMLElement("frame")}}, {{HTMLElement("iframe")}} ou {{HTMLElement("object")}}.</dd>
 <dt>{{HTTPHeader("X-Permitted-Cross-Domain-Policies")}}</dt>
 <dd>Sépcifie si un fichier de règlementation interdomaines (<code>crossdomain.xml</code>) est autorisé. Ce fichier peut définir une règle pour accorder aux clients (comme Adobe Flash Player, Adobe Acrobat, Microsoft Silverlight ou Apache Flex) la permission de gérer des données entre domaines qui seraient autrement restreintes à cause de <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy">Same-Origin Policy</a>. Voir la <a href="https://www.adobe.com/devnet/articles/crossdomain_policy_file_spec.html">spécification Cross-domain Policy File</a> pour plus d'informations.</dd>
 <dt>{{HTTPHeader("X-Powered-By")}}</dt>
 <dd>peut être défini par l'environnement hôte ou par d'autres cadriciels, il contient des informations sur eux sans fournir aucun information utile à l'application ni aux visiteurs. Désactivez cet en-tête pour éviter d'exposer des informations et des vulnérabilités potentielles.</dd>
 <dt>{{HTTPHeader("X-XSS-Protection")}}</dt>
 <dd>active le filtrage de script intersite.</dd>
</dl>

<h3 id="HTTP_Public_Key_Pinning_GlossaryHPKP">HTTP Public Key Pinning {{Glossary("HPKP")}}</h3>

<p>HTTP Public Key Pinning a été déprécié et supprimé au profit de Certificate Transparency et {{HTTPHeader("Expect-CT")}}.</p>

<dl>
 <dt>{{HTTPHeader("Public-Key-Pins")}}</dt>
 <dd>associe une clé publique cryptographique spécifique à un certain serveur web pour réduire le risque d'attaques {{Glossary("MitM")}} à l'aide de certificats falsifiés.</dd>
 <dt>{{HTTPHeader("Public-Key-Pins-Report-Only")}}</dt>
 <dd>envoie des rapports au <em>report-uri</em> spécifié dans l'en-tête et permet toujours aux clients de se connecter au serveur même si l'association à la clé cryptographique est violée.</dd>
</dl>

<h3 id="En-têtes_de_requêtes_de_métadonnées">En-têtes de requêtes de métadonnées</h3>

<dl>
 <dt>{{HTTPHeader("Sec-Fetch-Site")}}</dt>
 <dd>en-tête de requête indiquant la relation entre l'origine ayant initiée la requête et l'origine cible ; c'est un en-tête srtucutré dont la valeur peut être <code>cross-site</code>, <code>same-origin</code>, <code>same-site</code> ou <code>none</code>.</dd>
 <dt>{{HTTPHeader("Sec-Fetch-Mode")}}</dt>
 <dd>en-tête de requête indiquant le mode de requête à un serveur ; c'est un en-tête structuré dont la valeur peut être <code>cors</code>, <code>navigate</code>, <code>nested-navigate</code>, <code>no-cors</code>, <code>same-origin</code> ou <code>websocket</code>.</dd>
 <dt>{{HTTPHeader("Sec-Fetch-User")}}</dt>
 <dd>en-tête de requête indiquant si une requête de navigation a été déclenchée ou non par une action de l'utilisateur ; c'est un en-tête structuré dont la valeur est un booléen, soit <code>?0</code> ou pour faux et <code>?1</code> pour vrai.</dd>
 <dt>{{HTTPHeader("Sec-Fetch-Dest")}}</dt>
 <dd>en-tête de requête indiquant la destination de la requête à un serveur ; c'est un en-tête structuré dont la valeur peut être <code>audio</code>, <code>audioworklet</code>, <code>document</code>, <code>embed</code>, <code>empty</code>, <code>font</code>, <code>image</code>, <code>manifest</code>, <code>object</code>, <code>paintworklet</code>, <code>report</code>, <code>script</code>, <code>serviceworker</code>, <code>sharedworker</code>, <code>style</code>, <code>track</code>, <code>video</code>, <code>worker</code>, <code>xslt</code> ou <code>nested-document</code>.</dd>
</dl>

<h2 id="Évènements_envoyés_par_le_serveur">Évènements envoyés par le serveur</h2>

<dl>
 <dt>{{HTTPHeader("Last-Event-ID")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("NEL")}} {{experimental_inline}}</dt>
 <dd>permet aux développeurs de déclarer une règlementation de rapportage d'erreur réseau.</dd>
 <dt>{{HTTPHeader("Ping-From")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Ping-To")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Report-To")}}</dt>
 <dd>utilisé pour spécifier un serveur de destination pour que le navigateur puisse y envoyer des rapports d'avertissements ou d'erreurs.</dd>
</dl>

<h2 id="Codage_de_transfert">Codage de transfert</h2>

<dl>
 <dt>{{HTTPHeader("Transfer-Encoding")}}</dt>
 <dd>spécifie la forme de codage utilisée pour transférer en toute sécurité l'entité à l'utilisateur.</dd>
 <dt>{{HTTPHeader("TE")}}</dt>
 <dd>spécifie les encodages de transfert que l'agent utilisateur est prêt à accepter.</dd>
 <dt>{{HTTPHeader("Trailer")}}</dt>
 <dd>permet à l'expéditeur d'inclure des champs supplémentaires à la fin du message segmenté.</dd>
</dl>

<h2 id="WebSockets">WebSockets</h2>

<dl>
 <dt>{{HTTPHeader("Sec-WebSocket-Key")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Sec-WebSocket-Extensions")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Sec-WebSocket-Accept")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Sec-WebSocket-Protocol")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Sec-WebSocket-Version")}}</dt>
 <dd>...</dd>
</dl>

<h2 id="Autres">Autres</h2>

<dl>
 <dt>{{HTTPHeader("Accept-Push-Policy")}} {{experimental_inline}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Accept-Signature")}} {{experimental_inline}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Alt-Svc")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Date")}}</dt>
 <dd>contient la date et l'heure à laquelle le message a été généré.</dd>
 <dt>{{HTTPHeader("Large-Allocation")}}</dt>
 <dd>indique au navigateur que la page en cours de chargement souhaite effectuer une allocation importante.</dd>
 <dt>{{HTTPHeader("Link")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Push-Policy")}} {{experimental_inline}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("Retry-After")}}</dt>
 <dd>indique combien de temps l'agent utilisateur doit attendre avant de faire une autre demande consécutive.</dd>
 <dt>{{HTTPHeader("Signature")}} {{experimental_inline}}</dt>
 <dd>communique une liste de signatures pour un échange, chacune accompagnée d'informations sur la manière de déterminer son autorité et de rafraichir cette signature.</dd>
 <dt>{{HTTPHeader("Signed-Headers")}} {{experimental_inline}}</dt>
 <dd>identifie une liste ordonnée de champs d'en-tête de réponse à inclure dans une signature.</dd>
 <dt>{{HTTPHeader("Server-Timing")}}</dt>
 <dd>communique un ou plusieurs indicateurs et descriptions pour le cycle requête-réponse donné.</dd>
 <dt>{{HTTPHeader("Service-Worker-Allowed")}}</dt>
 <dd>utilisé pour supprimer la <a href="https://w3c.github.io/ServiceWorker/#path-restriction">restriction de chemin</a> en incluant cet en-tête <a href="https://w3c.github.io/ServiceWorker/#service-worker-script-response">dans la réponse d'un script Service Worker</a>.</dd>
 <dt>{{HTTPHeader("SourceMap")}}</dt>
 <dd>liens ayant généré du code sur une <a href="/fr/docs/Outils/D%C3%A9bogueur/Comment/Utiliser_une_source_map">source</a>.</dd>
 <dt>{{HTTPHeader("Upgrade")}}</dt>
 <dd>le document RFC associé pour le <a href="https://tools.ietf.org/html/rfc7230#section-6.7">champ d'en-tête Upgrade est RFC 7230, section 6.7</a>. Le standard établit des règles pour la mise à niveau ou la modification d'un protocole différent sur le client, le serveur et la connexion au protocole de transport actuels. Par exemple, cette norme d'en-tête permet à un client de passer de HTTP 1.1 à HTTP 2.0, en supposant que le serveur décide de reconnaître et d'implémenter le champ d'en-tête Upgrade. Une requête de ce type ne peut etre contraignante et le serveur peut répondre en utilisant le protocole initial. Il peut être utilisé dans les en-têtes client et serveur. Si le champ d'en-tête Upgrade est spécifié, l'expéditeur DOIT également envoyer le champ d'en-tête Connection avec l'option de mise à niveau spécifiée. Pour plus de détails sur le <a href="https://tools.ietf.org/html/rfc7230#section-6.1">champ d'en-tête Connection, veuillez vous reporter à la section 6.1 du RFC susmentionné</a>.</dd>
 <dt>{{HTTPHeader("X-DNS-Prefetch-Control")}}</dt>
 <dd>contrôle le préchargement DNS, fonctionnalité par laquelle les navigateurs effectuent de manière proactive la résolution du nom de domaine sur les deux liens que l'utilisateur peut choisir de suivre ainsi que les URL des éléments référencés par le document, y compris les images, CSS, JavaScript, etc.</dd>
 <dt>{{HTTPHeader("X-Firefox-Spdy")}} {{deprecated_inline}} {{non-standard_inline}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("X-Pingback")}} {{non-standard_inline}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("X-Requested-With")}}</dt>
 <dd>...</dd>
 <dt>{{HTTPHeader("X-Robots-Tag")}} {{non-standard_inline}}</dt>
 <dd>indique comment une page doit être indexée dans les résultats publics des moteurs de recherche ; cet en-tête est équivalent à <code>&lt;meta name="robots" content="..."&gt;</code></dd>
 <dt>{{HTTPHeader("X-UA-Compatible")}} {{non-standard_inline}}</dt>
 <dd>Utilisé par Internet Explorer pour signaler quel mode de document utiliser.</dd>
</dl>

<h2 id="Contribuer">Contribuer</h2>

<p>Vous pouvez contribuer en <a href="/fr/docs/MDN/Contribute/Howto/Document_an_HTTP_header">ajoutant un nouvel en-tête à la liste</a> ou en améliorant la documentation existante.</p>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li><a class="external" href="https://fr.wikipedia.org/wiki/Liste_des_codes_HTTP">Page Wikipédia sur la liste des en-têtes HTTP</a></li>
 <li><a class="external" href="https://www.iana.org/assignments/message-headers/message-headers.xhtml">Registre des en-têtes par l'IANA</a> (en)</li>
 <li><a href="https://httpwg.org/specs/">Groupe de travail HTTP</a></li>
</ul>