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 : 1783722 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- $LastChangedRevision: 2017022501 $ -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <modulesynopsis metafile="mod_proxy_http2.xml.meta">
27 <name>mod_proxy_http2</name>
28 <description>Support de HTTP/2 pour <module>mod_proxy</module></description>
29 <status>Extension</status>
30 <sourcefile>mod_proxy_http2.c</sourcefile>
31 <identifier>proxy_http2_module</identifier>
34 <p><module>mod_proxy_http2</module> ne
35 supporte que HTTP/2 et ne permet pas de rétrogradation vers HTTP/1.1. Cela
36 signifie que le serveur d'arrière-plan doit supporter HTTP/2 car HTTP/1.1 ne
37 pourra alors pas être utilisé.</p>
39 <p>Ce module <em>nécessite</em> la présence de <module>mod_proxy</module> ;
40 pour pouvoir traiter les requêtes mandatées HTTP/2,
41 <module>mod_proxy</module> et <module>mod_proxy_http2</module> doivent donc
42 être chargés par le serveur.</p>
44 <p><module>mod_proxy_http2</module> travaille avec des requêtes entrantes en
45 HTTP/1.1 ou HTTP/2. Dans les deux cas, les requêtes vers le même serveur
46 d'arrière-plan sont envoyées
47 via une seule connexion TCP, dans la mesure du possible (autrement dit
48 lorsque la connexion peut être réutilisée).</p>
50 <p>Avertissement : il ne sera effectué aucune tentative de fusion de
51 plusieurs requêtes entrantes HTTP/1 (devant être mandatées vers le même
52 serveur d'arrière-plan) vers des flux HTTP/2 appartenant à la même requête
53 HTTP/2. Chaque requête HTTP/1 entrante sera mandatée vers le serveur
54 d'arrière-plan en utilisant une requête HTTP/2 séparée (tout en réutilisant
55 si possible la même connexion TCP).</p>
57 <p>Ce module s'appuie sur <a href="http://nghttp2.org/">libnghttp2</a> pour
58 fournir le moteur central http/2.</p>
60 <note type="warning"><title>Avertissement</title> <p>Ce module en est au
61 stade expérimental. Ses comportement, directives et valeurs par défauts sont
62 donc susceptibles de modifications d'une version à l'autre plus fréquentes
63 que pour les autres modules. A ce titre, il est fortement conseillé aux
64 utilisateurs de consulter le fichier "CHANGES" pour prendre connaissance de
65 ces modifications.</p> </note>
67 <note type="warning"><title>Avertissement</title>
68 <p>N'activez pas le mandatement avant d'avoir <a
69 href="mod_proxy.html#access">sécurisé votre serveur</a>. Les serveurs
70 mandataires ouverts sont dangereux non seulement pour votre propre réseau,
71 mais aussi pour l'Internet au sens large.</p>
74 <seealso><module>mod_http2</module></seealso>
75 <seealso><module>mod_proxy</module></seealso>
76 <seealso><module>mod_proxy_connect</module></seealso>
78 <section id="examples"><title>Exemples de base</title>
80 <p>Les exemples ci-dessous montrent comment configurer HTTP/2 pour des
81 connexions d'arrière-plan vers un mandataire inverse.</p>
83 <example><title>HTTP/2 (TLS)</title>
84 <highlight language="config">
85 ProxyPass "/app" "h2://app.example.com"
86 ProxyPassReverse "/app" "https://app.example.com"
90 <example><title>HTTP/2 (non sécurisé)</title>
91 <highlight language="config">
92 ProxyPass "/app" "h2c://app.example.com"
93 ProxyPassReverse "/app" "http://app.example.com"
98 <p>Pour mandater en inverse les protocoles <code>h2</code> ou
99 <code>h2c</code>, on utilise la directive
100 <directive>ProxyPassReverse</directive> avec les schèmes habituels
101 <code>https</code> et respectivement
102 <code>http</code> qui sont connus et utilisés par l'agent utilisateur.</p>
104 </section> <!-- /examples -->
106 <section id="notes"><title>Informations sur les requêtes</title>
107 <p><module>mod_proxy_http</module> fournit les informations sur les requêtes
108 suivantes pour enregistrement dans les journaux en utilisant le format
109 <code>%{VARNAME}n</code> avec les directives <directive
110 module="mod_log_config">LogFormat</directive> ou <directive
111 module="core">ErrorLogFormat</directive> :
114 <dt>proxy-source-port</dt>
115 <dd>Le numéro de port local utilisé pour la connexion vers le serveur
116 d'arrière-plan.</dd>
117 <dt>proxy-status</dt>
118 <dd>Le statut HTTP/2 en provenance du serveur d'arrière-plan.</dd>