granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_http2.xml.fr

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1836468 -->
   5 <!-- French translation : Lucien GENTIS -->
   6
   7 <!--
   8  Licensed to the Apache Software Foundation (ASF) under one or more
   9  contributor license agreements.  See the NOTICE file distributed with
  10  this work for additional information regarding copyright ownership.
  11  The ASF licenses this file to You under the Apache License, Version 2.0
  12  (the "License"); you may not use this file except in compliance with
  13  the License.  You may obtain a copy of the License at
  14
  15      http://www.apache.org/licenses/LICENSE-2.0
  16
  17  Unless required by applicable law or agreed to in writing, software
  18  distributed under the License is distributed on an "AS IS" BASIS,
  19  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  See the License for the specific language governing permissions and
  21  limitations under the License.
  22 -->
  23
  24 <modulesynopsis metafile="mod_proxy_http2.xml.meta">
  25
  26 <name>mod_proxy_http2</name>
  27 <description>Support de HTTP/2 pour <module>mod_proxy</module></description>
  28 <status>Experimental</status>
  29 <sourcefile>mod_proxy_http2.c</sourcefile>
  30 <identifier>proxy_http2_module</identifier>
  31
  32 <summary>
  33     <p><module>mod_proxy_http2</module> ne
  34     supporte que HTTP/2 et ne permet pas de r&eacute;trogradation vers HTTP/1.1. Cela
  35     signifie que le serveur d'arri&egrave;re-plan doit supporter HTTP/2 car HTTP/1.1 ne
  36     pourra alors pas &ecirc;tre utilis&eacute;.</p>
  37
  38     <p>Ce module <em>n&eacute;cessite</em> la pr&eacute;sence de <module>mod_proxy</module> ;
  39     pour pouvoir traiter les requ&ecirc;tes mandat&eacute;es HTTP/2,
  40     <module>mod_proxy</module> et <module>mod_proxy_http2</module> doivent donc
  41     &ecirc;tre charg&eacute;s par le serveur.</p>
  42
  43     <p><module>mod_proxy_http2</module> travaille avec des requ&ecirc;tes entrantes en
  44     HTTP/1.1 ou HTTP/2. Dans les deux cas, les requ&ecirc;tes vers le m&ecirc;me serveur
  45     d'arri&egrave;re-plan sont envoy&eacute;es
  46     via une seule connexion TCP, dans la mesure du possible (autrement dit
  47     lorsque la connexion peut &ecirc;tre r&eacute;utilis&eacute;e).</p>
  48
  49     <p>Avertissement : il ne sera effectu&eacute; aucune tentative de fusion de
  50     plusieurs requ&ecirc;tes entrantes HTTP/1 (devant &ecirc;tre mandat&eacute;es vers le m&ecirc;me
  51     serveur d'arri&egrave;re-plan) vers des flux HTTP/2 appartenant &agrave; la m&ecirc;me requ&ecirc;te
  52     HTTP/2.  Chaque requ&ecirc;te HTTP/1 entrante sera mandat&eacute;e vers le serveur
  53     d'arri&egrave;re-plan en utilisant une requ&ecirc;te HTTP/2 s&eacute;par&eacute;e (tout en r&eacute;utilisant
  54     si possible la m&ecirc;me connexion TCP).</p>
  55
  56     <p>Ce module s'appuie sur <a href="http://nghttp2.org/">libnghttp2</a> pour
  57     fournir le moteur central http/2.</p>
  58
  59     <note type="warning"><title>Avertissement</title> <p>Ce module en est au
  60     stade exp&eacute;rimental. Ses comportement, directives et valeurs par d&eacute;fauts sont
  61     donc susceptibles de modifications d'une version &agrave; l'autre plus fr&eacute;quentes
  62     que pour les autres modules. A ce titre, il est fortement conseill&eacute; aux
  63     utilisateurs de consulter le fichier "CHANGES" pour prendre connaissance de
  64     ces modifications.</p> </note>
  65
  66     <note type="warning"><title>Avertissement</title>
  67       <p>N'activez pas le mandatement avant d'avoir <a
  68       href="mod_proxy.html#access">s&eacute;curis&eacute; votre serveur</a>. Les serveurs
  69       mandataires ouverts sont dangereux non seulement pour votre propre r&eacute;seau,
  70       mais aussi pour l'Internet au sens large.</p>
  71     </note>
  72 </summary>
  73 <seealso><module>mod_http2</module></seealso>
  74 <seealso><module>mod_proxy</module></seealso>
  75 <seealso><module>mod_proxy_connect</module></seealso>
  76
  77     <section id="examples"><title>Exemples de base</title>
  78
  79     <p>Les exemples ci-dessous montrent comment configurer HTTP/2 pour des
  80     connexions d'arri&egrave;re-plan vers un mandataire inverse.</p>
  81
  82     <example><title>HTTP/2 (TLS)</title>
  83     <highlight language="config">
  84 ProxyPass "/app" "h2://app.example.com"
  85 ProxyPassReverse "/app" "https://app.example.com"
  86     </highlight>
  87     </example>
  88
  89     <example><title>HTTP/2 (non s&eacute;curis&eacute;)</title>
  90     <highlight language="config">
  91 ProxyPass "/app" "h2c://app.example.com"
  92 ProxyPassReverse "/app" "http://app.example.com"
  93     </highlight>
  94     </example>
  95
  96     <note>
  97       <p>Pour mandater en inverse les protocoles <code>h2</code> ou
  98       <code>h2c</code>, on utilise la directive
  99       <directive>ProxyPassReverse</directive> avec les sch&egrave;mes habituels
 100       <code>https</code> et respectivement
 101       <code>http</code> qui sont connus et utilis&eacute;s par l'agent utilisateur.</p>
 102     </note>
 103     </section> <!-- /examples -->
 104
 105 <section id="notes"><title>Informations sur les requ&ecirc;tes</title>
 106     <p><module>mod_proxy_http</module> fournit les informations sur les requ&ecirc;tes
 107     suivantes pour enregistrement dans les journaux en utilisant le format
 108     <code>%{VARNAME}n</code> avec les directives <directive
 109     module="mod_log_config">LogFormat</directive> ou <directive
 110     module="core">ErrorLogFormat</directive> :
 111     </p>
 112     <dl>
 113         <dt>proxy-source-port</dt>
 114         <dd>Le num&eacute;ro de port local utilis&eacute; pour la connexion vers le serveur
 115         d'arri&egrave;re-plan.</dd>
 116         <dt>proxy-status</dt>
 117         <dd>Le statut HTTP/2 en provenance du serveur d'arri&egrave;re-plan.</dd>
 118     </dl>
 119 </section>
 120
 121 <section id="h2push"><title>HTTP/2 PUSH</title>
 122     <p>Ce module ne supporte pas la fonctionnalité HTTP/2 PUSH. Les serveurs
 123     d'arrière-plan qui veulent indiquer des ressources à précharger doivent
 124     envoyer les en-têtes <code>Link</code> appropriés.</p>
 125     <p>En cas de besoin, il peuvent le faire en utilisant les réponses
 126     intermédiaires <code>"103 Early Hints"</code> comme indiqué dans la <a
 127     href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>, ce qui fournira
 128     les meilleures performances. Si le client comprend aussi le langage HTTP/2,
 129     il en résultera un PUSH de la part de httpd vers le celui-ci ou un simple
 130     transfert de la réponse 103.</p>
 131
 132 </section>
 133
 134 </modulesynopsis>