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="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <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"> en </a> | 28<a href="/fr/mod/mod_proxy_ftp.html" title="Fran�ais"> fr </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"> en </a> | 270<a href="/fr/mod/mod_proxy_ftp.html" title="Fran�ais"> fr </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&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>