1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5              This file is generated from xml source: DO NOT EDIT
6        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7      -->
8<title>mod_proxy_ftp - Serveur Apache HTTP</title>
9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
12<script src="/style/scripts/prettify.min.js" type="text/javascript">
13</script>
14
15<link href="/images/favicon.ico" rel="shortcut icon" /></head>
16<body>
17<div id="page-header">
18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
19<p class="apache">Serveur Apache HTTP Version 2.4</p>
20<img alt="" src="/images/feather.gif" /></div>
21<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
22<div id="path">
23<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Modules</a></div>
24<div id="page-content">
25<div id="preamble"><h1>Module Apache mod_proxy_ftp</h1>
26<div class="toplang">
27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
28<a href="/fr/mod/mod_proxy_ftp.html" title="Fran�ais">&nbsp;fr&nbsp;</a></p>
29</div>
30<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support FTP �
31<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code></td></tr>
32<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
33<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>proxy_ftp_module</td></tr>
34<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_proxy_ftp.c</td></tr></table>
35<h3>Sommaire</h3>
36
37    <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
38    chargement de <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du
39    mandatement des sites FTP. Notez que le support FTP est
40    actuellement limit� � la m�thode GET.</p>
41
42    <p>Ainsi, pour pouvoir traiter les requ�tes FTP mandat�es,
43    <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>, et <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>
44    doivent �tre charg�s dans le serveur.</p>
45
46    <div class="warning"><h3>Avertissement</h3>
47      <p>N'activez pas la fonctionnalit� de mandataire avant d'avoir <a href="mod_proxy.html#access">s�curis� votre serveur</a>. Les
48      serveurs mandataires ouverts sont dangereux non seulement pour
49      votre r�seau, mais aussi pour l'Internet au sens large.</p>
50    </div>
51</div>
52<div id="quickview"><h3 class="directives">Directives</h3>
53<ul id="toc">
54<li><img alt="" src="/images/down.gif" /> <a href="#proxyftpdircharset">ProxyFtpDirCharset</a></li>
55<li><img alt="" src="/images/down.gif" /> <a href="#proxyftpescapewildcards">ProxyFtpEscapeWildcards</a></li>
56<li><img alt="" src="/images/down.gif" /> <a href="#proxyftplistonwildcard">ProxyFtpListOnWildcard</a></li>
57</ul>
58<h3>Sujets</h3>
59<ul id="topics">
60<li><img alt="" src="/images/down.gif" /> <a href="#mimetypes">Pourquoi les fichiers du type
61    <var>xxx</var> ne sont-ils pas t�l�chargeables par FTP ?</a></li>
62<li><img alt="" src="/images/down.gif" /> <a href="#type">Comment puis-je forcer le t�l�chargement
63    FTP en mode ASCII du fichier <var>xxx</var> ?</a></li>
64<li><img alt="" src="/images/down.gif" /> <a href="#ftpnonget">Comment puis-je effectuer un
65    chargement FTP ?</a></li>
66<li><img alt="" src="/images/down.gif" /> <a href="#percent2fhck">Comment puis-je acc�der par FTP �
67    des fichiers situ�s en dehors de mon r�pertoire home ?</a></li>
68<li><img alt="" src="/images/down.gif" /> <a href="#ftppass">Comment puis-je dissimuler le mot de
69    passe FTP apparaissant en clair dans la ligne d'URL de mon
70    navigateur ?</a></li>
71<li><img alt="" src="/images/down.gif" /> <a href="#wildcard">Pourquoi re�ois-je un listing de
72    fichiers alors que j'ai demand� le t�l�chargement d'un fichier
73    ?</a></li>
74</ul><h3>Voir aussi</h3>
75<ul class="seealso">
76<li><code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code></li>
77</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
78<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
79<div class="section">
80<h2><a name="mimetypes" id="mimetypes">Pourquoi les fichiers du type
81    <var>xxx</var> ne sont-ils pas t�l�chargeables par FTP ?</a></h2>
82      <p>Ce type particulier de fichier n'est probablement pas d�fini en
83      temps que <code>application/octet-stream</code> dans le fichier
84      de configuration mime.types de votre mandataire. La ligne suivante
85      peut y rem�dier :</p>
86
87      <div class="example"><pre>application/octet-stream   bin dms lha lzh exe class tgz taz</pre></div>
88    <p>Vous pouvez aussi d�finir par d�faut tous les types de fichiers
89    en tant que fichiers binaires :</p>
90      <div class="example"><pre class="prettyprint lang-config">ForceType application/octet-stream</pre>
91</div>
92    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
93<div class="section">
94<h2><a name="type" id="type">Comment puis-je forcer le t�l�chargement
95    FTP en mode ASCII du fichier <var>xxx</var> ?</a></h2>
96      <p>Dans les rares siruations o� vous devez t�l�charger un fichier
97      sp�cifique en utilisant la m�thode de transfert FTP
98      <code>ASCII</code> (alors que le mode transfert par d�faut est
99      <code>binary</code>), vous pouvez modifier le mode de transfert de
100      <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> en suffixant la requ�te avec
101      <code>;type=a</code> pour forcer un transfert en mode ASCII (les
102      listings de r�pertoires FTP sont cependant quant � eux transmis en
103      mode ASCII).</p>
104    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
105<div class="section">
106<h2><a name="ftpnonget" id="ftpnonget">Comment puis-je effectuer un
107    chargement FTP ?</a></h2>
108    <p>Actuellement, seule la m�thode GET est support�e pour FTP dans
109    mod_proxy. Vous pouvez en revanche utiliser le chargement HTTP (POST
110    or PUT) via un mandataire Apache.</p>
111    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
112<div class="section">
113<h2><a name="percent2fhck" id="percent2fhck">Comment puis-je acc�der par FTP �
114    des fichiers situ�s en dehors de mon r�pertoire home ?</a></h2>
115      <p>Un URI FTP est consid�r� comme relatif au r�pertoire home de
116      l'utilisateur connect�. H�las, vous ne pouvez pas utiliser /../
117      pour atteindre des r�pertoires de niveau sup�rieur, car les points
118      sont interpr�t�s par le navigateur et ne sont donc pas vraiment
119      envoy�s au serveur FTP. Pour traiter ce probl�me, une m�thode
120      nomm�e <dfn>Squid %2f hack</dfn> a �t� impl�ment�e dans le
121      mandataire FTP Apache ; cette solution est aussi utilis�e par
122      d'autres serveurs mandataires courants comme le <a href="http://www.squid-cache.org/">Cache mandataire Squid</a>. En
123      pr�fixant par <code>/%2f</code> le chemin de votre requ�te, vous
124      pouvez faire en sorte que le mandataire modifie le r�pertoire FTP
125      racine en <code>/</code> (au lieu du r�pertoire home). Par
126      exemple, pour extraire le fichier <code>/etc/motd</code>, vous
127      pourriez utiliser l'URL :</p>
128
129      <div class="example"><p><code>
130        ftp://<var>utilisateur</var>@<var>serveur</var>/%2f/etc/motd
131      </code></p></div>
132    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
133<div class="section">
134<h2><a name="ftppass" id="ftppass">Comment puis-je dissimuler le mot de
135    passe FTP apparaissant en clair dans la ligne d'URL de mon
136    navigateur ?</a></h2>
137      <p>Apache utilise diff�rentes strat�gies pour effectuer une
138      connexion � un serveur FTP � l'aide d'un nom d'utilisateur et d'un
139      mot de passe. En l'absence de nom d'utilisateur et de mot de passe
140      dans l'URL, Apache tente une connexion anonyme aupr�s du serveur
141      FTP comme suit :</p>
142
143      <div class="example"><p><code>
144        utilisateur : anonymous<br />
145        mot de passe : apache_proxy@
146      </code></p></div>
147
148      <p>Ceci fonctionne avec tous les serveurs FTP courants configur�s
149      pour accepter les connexions anonymes.</p>
150
151      <p>Pour une connexion personnalis�e avec un nom d'utilisateur
152      sp�cifique, vous pouvez int�grer ce dernier dans l'URL comme suit
153      :</p>
154
155      <div class="example"><p><code>
156        ftp://<var>nom-utilisateur</var>@<var>serveur</var>/mon-fichier
157      </code></p></div>
158
159      <p>Si le serveur FTP demande un mot de passe pour ce nom
160      d'utilisateur (ce qu'il est cens� faire), Apache va renvoyer au
161      client une r�ponse <code>401</code> (Autorisation requise), ce qui
162      fera afficher au navigateur une bo�te de dialogue utilisateur/mot
163      de passe. Une fois le mot de passe saisi, la connexion est tent�e
164      � nouveau, et si elle r�ussit, la ressource demand�e est
165      pr�sent�e. L'avantage de cette proc�dure r�side dans le fait que
166      votre navigateur n'affiche pas le mot de passe en clair, ce qu'il
167      aurait fait si vous aviez utilis� l'URL :</p>
168
169      <div class="example"><p><code>
170        ftp://<var>nom-utilisateur</var>:<var>mot-de-passe</var>
171	@<var>serveur</var>/mon-fichier
172      </code></p></div>
173
174      <div class="note"><h3>Note</h3>
175        <p>Le mot de passe transmis de cette mani�re n'est pas chiffr�
176	lorsqu'il est envoy�. Il transite entre votre navigateur et le
177	serveur mandataire Apache sous la forme d'une cha�ne de texte en
178	clair cod�e en base64, et entre le mandataire Apache et le
179	serveur FTP en texte pur. Vous devez par cons�quent r�fl�chir �
180	deux fois avant d'acc�der � votre serveur FTP via HTTP (et d'une
181	mani�re g�n�rale avant d'acc�der � vos fichiers personnels via
182	FTP !) sur des canaux non s�curis�s, car des oreilles
183	indiscr�tes pourraient intercepter votre mot de passe au cours
184	de son transfert.</p>
185      </div>
186    </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
187<div class="section">
188<h2><a name="wildcard" id="wildcard">Pourquoi re�ois-je un listing de
189    fichiers alors que j'ai demand� le t�l�chargement d'un fichier
190    ?</a></h2>
191      <p>Apache examine l'URL de la requ�te afin de permettre la
192      navigation dans les r�pertoires d'un serveur FTP ainsi que le
193      t�l�chargement de fichiers. Si elle ressemble � un r�pertoire, ou
194      contient des caract�res g�n�riques ("*?[{~"), alors Apache
195      consid�re que c'est un listing qui est demand�, et non un
196      t�l�chargement.</p>
197      <p>Vous pouvez d�sactiver le traitement sp�cial des noms contenant
198      des caract�res g�n�riques. Voir � cet effet la directive
199      <code class="directive">ProxyFtpListOnWildcard</code>.
200      </p>
201    </div>
202<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
203<div class="directive-section"><h2><a name="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a> <a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a></h2>
204<table class="directive">
205<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le jeu de caract�res des listings FTP
206mandat�s</td></tr>
207<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caract�res</var></code></td></tr>
208<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</code></td></tr>
209<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
210<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
211<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
212<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.7 d'Apache. D�plac�
213depuis <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> � partir de la version 2.3.5 d'Apache</td></tr>
214</table>
215    <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de
216    d�finir le jeu de caract�res � utiliser pour les listings FTP en
217    HTML g�n�r�s par <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>.</p>
218
219</div>
220<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
221<div class="directive-section"><h2><a name="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a> <a name="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a></h2>
222<table class="directive">
223<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caract�res g�n�riques dans les noms de fichiers
224doivent-ils �tre �chapp�s lorsqu'ils sont envoy�s au serveur FTP ?</td></tr>
225<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpEscapeWildcards [on|off]</code></td></tr>
226<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>on</code></td></tr>
227<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
228<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
229<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
230<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
231</table>
232  <p>La directive <code class="directive">ProxyFtpEscapeWildcards</code> permet
233  de d�terminer si les caract�res g�n�riques ("*?[{~") que contiennent
234  les noms de fichiers demand�s doivent �tre �chapp�s pas un slash
235  invers� avant d'�tre envoy�s au serveur FTP. Il s'agit du comportement
236  par d�faut ; cependant, de nombreux serveurs FTP n'ont aucune
237  connaissance de la notion d'�chappement, et tentent de servir le
238  fichier demand� sous sa forme litt�rale, en incluant les slashes
239  invers�s dans son nom.</p>
240    <p>D�finissez cette directive � "off" pour permettre le
241    t�l�chargement de fichiers dont les noms contiennent des caract�res
242    g�n�riques depuis des serveurs FTP qui ne connaissent pas
243    l'�chappement des caract�res g�n�riques.</p>
244
245</div>
246<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
247<div class="directive-section"><h2><a name="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a> <a name="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a></h2>
248<table class="directive">
249<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caract�res g�n�riques dans les noms de fichiers
250demand�s doivent-ils d�clencher l'affichage d'un listing ?</td></tr>
251<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpListOnWildcard [on|off]</code></td></tr>
252<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>on</code></td></tr>
253<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire</td></tr>
254<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
255<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr>
256<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
257</table>
258  <p>La directive <code class="directive">ProxyFtpListOnWildcard</code> permet
259  de d�terminer si les caract�res g�n�riques ("*?[{~") que contiennent
260  les noms de fichiers demand�s provoquent l'affichage d'un listing de
261  fichiers par <code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> au lieu de t�l�charger un
262  fichier. Il s'agit de leur comportement par d�faut (valeur on).
263  D�finissez cette directive � "off" pour permettre le t�l�chargement de
264  fichiers m�me si leur nom contient des caract�res g�n�riques.</p>
265
266</div>
267</div>
268<div class="bottomlang">
269<p><span>Langues Disponibles: </span><a href="/en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
270<a href="/fr/mod/mod_proxy_ftp.html" title="Fran�ais">&nbsp;fr&nbsp;</a></p>
271</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
272<script type="text/javascript"><!--//--><![CDATA[//><!--
273var comments_shortname = 'httpd';
274var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_proxy_ftp.html';
275(function(w, d) {
276    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
277        d.write('<div id="comments_thread"><\/div>');
278        var s = d.createElement('script');
279        s.type = 'text/javascript';
280        s.async = true;
281        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
282        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
283    }
284    else { 
285        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
286    }
287})(window, document);
288//--><!]]></script></div><div id="footer">
289<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
290<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
291if (typeof(prettyPrint) !== 'undefined') {
292    prettyPrint();
293}
294//--><!]]></script>
295</body></html>