granicus.if.org Git - apache/blob - docs/manual/mod/mod_auth_form.html.fr

   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_auth_form - Serveur Apache HTTP Version 2.5</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/quickreference.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.5</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.5</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Module Apache mod_auth_form</h1>
  26 <div class="toplang">
  27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/mod/mod_auth_form.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>Authentification à l'aide d'un formulaire</td></tr>
  31 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
  32 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_form_module</td></tr>
  33 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_form.c</td></tr>
  34 <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir d'Apache 2.3</td></tr></table>
  35 <h3>Sommaire</h3>
  36
  37     <div class="warning"><h3>Avertissement</h3>
  38       <p>L'authentification à base de formulaire dépend des modules
  39       <code class="module"><a href="../mod/mod_session.html">mod_session</a></code> qui utilisent les cookies HTTP, et en
  40       tant que tels s'exposent à des attaques de type Cross Site
  41       Scripting, ou risquent de divulguer des informations à caractère
  42       privé aux clients. Assurez-vous que ces risques ont bien été pris
  43       en compte avant d'activer les sessions sur votre serveur.</p>
  44     </div>
  45
  46     <p>Ce module permet de restreindre l'accès en recherchant les
  47     utilisateurs dans les fournisseurs spécifiés à l'aide d'un
  48     formulaire de connexion HTML. Les formulaires HTML requièrent
  49     davantage de configuration que les méthodes d'authentification
  50     alternatives, mais ils peuvent s'avérer beaucoup plus conviviaux
  51     pour les utilisateurs.
  52     </p>
  53
  54     <p>L'authentification HTTP de base est fournie par le module
  55     <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, et l'authentification HTTP à base
  56     de condensé par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. Le
  57     module <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> doit être utilisé avec au
  58     moins un module d'authentification du style
  59     <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et un module d'autorisation comme
  60     <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p>
  61
  62     <p>Lorsque l'utilisateur a été authentifié avec succès, ses
  63     informations de connexion sont stockés dans une session fournie par
  64     le module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>.
  65     </p>
  66
  67 </div>
  68 <div id="quickview"><h3 class="directives">Directives</h3>
  69 <ul id="toc">
  70 <li><img alt="" src="../images/down.gif" /> <a href="#authformauthoritative">AuthFormAuthoritative</a></li>
  71 <li><img alt="" src="../images/down.gif" /> <a href="#authformbody">AuthFormBody</a></li>
  72 <li><img alt="" src="../images/down.gif" /> <a href="#authformdisablenostore">AuthFormDisableNoStore</a></li>
  73 <li><img alt="" src="../images/down.gif" /> <a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></li>
  74 <li><img alt="" src="../images/down.gif" /> <a href="#authformlocation">AuthFormLocation</a></li>
  75 <li><img alt="" src="../images/down.gif" /> <a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#authformlogoutlocation">AuthFormLogoutLocation</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#authformmethod">AuthFormMethod</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#authformmimetype">AuthFormMimetype</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#authformpassword">AuthFormPassword</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#authformprovider">AuthFormProvider</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#authformsitepassphrase">AuthFormSitePassphrase</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#authformsize">AuthFormSize</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#authformusername">AuthFormUsername</a></li>
  85 </ul>
  86 <h3>Sujets</h3>
  87 <ul id="topics">
  88 <li><img alt="" src="../images/down.gif" /> <a href="#basicconfig">Configuration de base</a></li>
  89 <li><img alt="" src="../images/down.gif" /> <a href="#standalone">Page de connexion dédiée</a></li>
  90 <li><img alt="" src="../images/down.gif" /> <a href="#inline">Connexion à la volée</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#inlinepreservebody">Connexion à la volée avec
  92     conservation du contenu</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#loggingout">Déconnexion</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#urlencoding">Noms d'utilisateurs et mots de
  95     passe</a></li>
  96 </ul><h3>Voir aussi</h3>
  97 <ul class="seealso">
  98 <li><code class="module"><a href="../mod/mod_session.html">mod_session</a></code></li>
  99 <li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li>
 100 <li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li>
 101 <li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li>
 102 <li><a href="../howto/auth.html">Mise en oeuvre de
 103 l'authentification</a></li>
 104 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
 105 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 106 <div class="section">
 107 <h2><a name="basicconfig" id="basicconfig">Configuration de base</a></h2>
 108
 109       <p>Pour protéger une URL particulière avec le module
 110       <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, vous devez déterminer l'endroit où
 111       vous allez stocker votre <var>session</var>, ainsi que la méthode
 112       d'authentification. Dans cet exemple simple, les informations de
 113       connexion sont stockées dans une session à l'aide du module
 114       <code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et l'authentification utilise
 115       un fichier en s'appuyant sur le module
 116       <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Si l'authentification échoue,
 117       l'utilisateur dera redirigé vers la page du formulaire de
 118       connexion.</p>
 119
 120       <div class="example"><h3>Exemple simple</h3><pre class="prettyprint lang-config">AuthFormProvider file
 121 AuthUserFile conf/passwd
 122 AuthType form
 123 AuthName realm
 124 AuthFormLoginRequiredLocation http://example.com/login.html
 125 Session On
 126 SessionCookieName session path=/
 127 SessionCryptoPassphrase secret</pre>
 128 </div>
 129
 130       <p>L'authentification <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> est activée
 131       en affectant la valeur <var>form</var> à la directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>. Les directives
 132       <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> et
 133       <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
 134       spécifient que les noms d'utilisateurs et mots de passe seront
 135       vérifiés en utilisant le fichier choisi.</p>
 136
 137       <p>Les directives <code class="directive"><a href="../mod/mod_session.html#session">Session</a></code>, <code class="directive"><a href="../mod/mod_session_cookie.html#sessioncookiename">SessionCookieName</a></code> et
 138       <code class="directive"><a href="../mod/mod_session_crypto.html#sessioncryptopassphrase">SessionCryptoPassphrase</a></code>
 139       créent une session chiffrée stockée dans un cookie HTTP au niveau
 140       du navigateur. Pour plus d'informations à propos des différentes
 141       options de configuration des sessions, reportez-vous à la
 142       documentation du module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>.</p>
 143
 144       <p>Dans l'exemple simple ci-dessus, une URL a été protégée par
 145       <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, mais on doit maintenant fournir
 146       à l'utilisateur un moyen d'entrer un nom et un mot de passe. À cet
 147       effet, on peut soit écrire une page de connexion indépendante
 148       dédiée, soit inclure le formulaire de connexion dans la page
 149       courante.</p>
 150     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 151 <div class="section">
 152 <h2><a name="standalone" id="standalone">Page de connexion dédiée</a></h2>
 153
 154       <p>Le formulaire de connexion peut être contenu dans une page
 155       indépendante, ou être inclus dans la page courante. </p>
 156
 157       <p>Lorsque la connexion s'effectue à partir d'une page
 158       indépendante et si la tentative d'authentification échoue,
 159       l'utilisateur doit être redirigé vers un formulaire de connexion,
 160       créé à cet effet sur le site web, en utilisant la directive
 161       <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>.
 162       En général, la page de connexion contiendra un formulaire HTML
 163       demandant à l'utilisateur de fournir un nom et un mot de passe.</p>
 164
 165       <div class="example"><h3>Exemple de formulaire de connexion</h3><pre class="prettyprint lang-html">&lt;form method="POST" action="/dologin.html"&gt;
 166   Username: &lt;input type="text" name="httpd_username" value="" /&gt;
 167   Password: &lt;input type="password" name="httpd_password" value="" /&gt;
 168   &lt;input type="submit" name="login" value="Login" /&gt;
 169 &lt;/form&gt;</pre>
 170 </div>
 171
 172       <p>La partie où s'effectue la connexion proprement dite est
 173       traitée par le gestionnaire <var>form-login-handler</var>.
 174       L'action de ce formulaire doit pointer vers ce gestionnaire, ce
 175       que l'on configure dans Apache httpd comme suit :</p>
 176
 177       <div class="example"><h3>Exemple de configuration du gestionnaire de
 178       formulaire de connexion</h3><pre class="prettyprint lang-config">&lt;Location /dologin.html&gt;
 179     SetHandler form-login-handler
 180     AuthFormLoginRequiredLocation http://example.com/login.html
 181     AuthFormLoginSuccessLocation http://example.com/success.html
 182     AuthFormProvider file
 183     AuthUserFile conf/passwd
 184     AuthType form
 185     AuthName realm
 186     Session On
 187     SessionCookieName session path=/
 188     SessionCryptoPassphrase secret
 189 &lt;/Location&gt;</pre>
 190 </div>
 191
 192       <p>L'URL spécifiée par la directive
 193       <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
 194       référencera en général une page expliquant à l'utilisateur que sa
 195       tentative de connexion a échoué, et qu'il doit la renouveler. La
 196       directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
 197       spécifie l'URL vers laquelle l'utilisateur doit être redirigé s'il
 198       s'est authentifié avec succès.</p>
 199
 200       <p>Alternativement, l'URL vers laquelle doit être redirigé
 201       l'utilisateur s'il s'est authentifié avec succès peut être
 202       intégrée dans le formulaire de connexion, comme dans l'exemple
 203       ci-dessous. Il en découle que le même gestionnaire
 204       <var>form-login-handler</var> pourra être utilisé pour différentes
 205       zones du site web.</p>
 206
 207       <div class="example"><h3>Exemple de formulaire d'authentification multizone</h3><pre class="prettyprint lang-html">&lt;form method="POST" action="/dologin.html"&gt;
 208   Username: &lt;input type="text" name="httpd_username" value="" /&gt;
 209   Password: &lt;input type="password" name="httpd_password" value="" /&gt;
 210   &lt;input type="submit" name="login" value="Login" /&gt;
 211   &lt;input type="hidden" name="httpd_location" value="http://example.com/success.html" /&gt;
 212 &lt;/form&gt;</pre>
 213 </div>
 214
 215     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 216 <div class="section">
 217 <h2><a name="inline" id="inline">Connexion à la volée</a></h2>
 218
 219       <div class="warning"><h3>Avertissement</h3>
 220         <p>Il existe un risque, dans certaines circonstances, que le
 221         formulaire de connexion configuré pour une connexion à la volée
 222         soit soumis plusieurs fois, révélant de ce fait les paramètres
 223         de connexion à l'application sous-jacente. L'administrateur doit
 224         s'assurer que cette dernière est correctement sécurisée afin
 225         d'éviter les éventuels abus. En cas de doute, utilisez une page
 226         de connexion indépendante dédiée.</p>
 227       </div>
 228
 229       <p>Comme alternative à la page de connexion dédiée pour un site
 230       web, il est possible de configurer <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>
 231       pour authentifier les utilisateurs à la volée, sans les rediriger
 232       vers une autre page, ce qui permet de conserver l'état de la page
 233       courante au cours de la tentative de connexion. Ceci peut s'avérer
 234       utile dans le cas d'une session limitée dans le temps, si le délai
 235       de la session a expiré pendant la requête de l'utilisateur. Ce
 236       dernier peut alors se réauthentifier à la même place, et
 237       poursuivre son activité à partir du point où il en était resté.</p>
 238
 239       <p>Si un utilisateur non authentifié tente d'accéder à une page
 240       protégée par <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, et si ce dernier
 241       n'est pas configuré avec une directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>,
 242       un code de statut <var>HTTP_UNAUTHORIZED</var> est renvoyé vers le
 243       navigateur, indiquant à l'utilisateur qu'il n'est pas autorisé à
 244       accéder à cette page.</p>
 245
 246       <p>Pour configurer l'authentification à la volée, l'administrateur
 247       remplace le message d'erreur renvoyé par le code de statut
 248       <var>HTTP_UNAUTHORIZED</var> par un message d'erreur personnalisé
 249       contenant le formulaire de connexion comme suit :</p>
 250
 251       <div class="example"><h3>Exemple simple d'authentification à la volée</h3><pre class="prettyprint lang-config">AuthFormProvider file
 252 ErrorDocument 401 /login.shtml
 253 AuthUserFile conf/passwd
 254 AuthType form
 255 AuthName realm
 256 AuthFormLoginRequiredLocation http://example.com/login.html
 257 Session On
 258 SessionCookieName session path=/
 259 SessionCryptoPassphrase secret</pre>
 260 </div>
 261
 262       <p>La page du message d'erreur doit contenir un formulaire de
 263       connexion dont la propriété action est vide, comme dans l'exemple
 264       ci-dessous. Ceci a pour effet de soumettre le formulaire à l'URL
 265       protégée originale, cette dernière n'ayant pas besoin d'être
 266       connue de la page en cours.</p>
 267
 268       <div class="example"><h3>Exemple de formulaire de connexion à la volée</h3><pre class="prettyprint lang-html">&lt;form method="POST" <strong>action=""</strong>&gt;
 269   Username: &lt;input type="text" name="httpd_username" value="" /&gt;
 270   Password: &lt;input type="password" name="httpd_password" value="" /&gt;
 271   &lt;input type="submit" name="login" value="Login" /&gt;
 272 &lt;/form&gt;</pre>
 273 </div>
 274
 275       <p>Lorsque l'utilisateur final a entré ses informations de
 276       connexion, le formulaire effectue une requête HTTP POST pour l'URL
 277       originale protégée par mot de passe.
 278       <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> va alors intercepter cette requête
 279       POST, et dans le cas où des champs HTML Utilisateur et Mot de
 280       passe corrects sont présents, l'utilisateur sera connecté, et
 281       l'URL originale protégée par mot de passe lui sera retournée en
 282       tant que requête GET.</p>
 283
 284     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 285 <div class="section">
 286 <h2><a name="inlinepreservebody" id="inlinepreservebody">Connexion à la volée avec
 287     conservation du contenu</a></h2>
 288
 289       <p>Il existe une limite à la technique de connexion à la volée
 290       décrite ci-dessus ; si un formulaire HTML POST entraîne une
 291       demande d'authentification ou de réauthentification, le contenu du
 292       formulaire original envoyé par le navigateur sera perdu. Cela peut
 293       s'avérer plus ou moins gênant pour l'utilisateur final selon la
 294       fonction du site web.</p>
 295
 296       <p>Comme solution à ce problème, <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>
 297       permet d'intégrer la méthode et le contenu de la requête originale
 298       dans le formulaire de connexion. Si l'authentification réussit,
 299       Apache httpd pourra refaire une tentative avec la méthode et le contenu
 300       originaux, tout en conservant l'état de la requête originale.</p>
 301
 302       <p>Pour mettre en oeuvre la conservation du contenu, vous devez
 303       ajouter trois champs supplémentaires au formulaire de connexion
 304       comme dans l'exemple suivant :</p>
 305
 306       <div class="example"><h3>Exemple de formulaire avec conservation du
 307       contenu</h3><pre class="prettyprint lang-html">&lt;form method="POST" action=""&gt;
 308   Username: &lt;input type="text" name="httpd_username" value="" /&gt;
 309   Password: &lt;input type="password" name="httpd_password" value="" /&gt;
 310   &lt;input type="submit" name="login" value="Login" /&gt;
 311   <br />  <strong>&lt;input type="hidden" name="httpd_method" value="POST" /&gt;
 312   &lt;input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" /&gt;
 313   &lt;input type="hidden" name="httpd_body" value="name1=value1&amp;name2=value2" /&gt;</strong><br />
 314 &lt;/form&gt;</pre>
 315 </div>
 316
 317       <p>La manière dont la méthode, le type MIME et le contenu de la
 318       requête originale seront intégrés dans le formulaire de connexion
 319       vont dépendre de la plate-forme et de la technologie utilisées au
 320       sein du site web.
 321       </p>
 322
 323       <p>Une option consiste à utiliser le module
 324       <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> en association avec la directive
 325       <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>, ainsi
 326       qu'un script CGI adapté pour intégrer les variables dans le
 327       formulaire.</p>
 328
 329       <p>Une autre option consiste à présenter le formulaire de
 330       connexion en utilisant un script CGI ou une autre technologie
 331       dynamique.</p>
 332
 333       <div class="example"><h3>Exemple avec script CGI</h3><pre class="prettyprint lang-config">        AuthFormProvider file
 334         ErrorDocument 401 /cgi-bin/login.cgi
 335         ...</pre>
 336 </div>
 337
 338     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 339 <div class="section">
 340 <h2><a name="loggingout" id="loggingout">Déconnexion</a></h2>
 341
 342       <p>Pour permettre à un utilisateur de se déconnecter d'une session
 343       particulière, vous devez configurer une page pour qu'elle soit
 344       traitée par le gestionnaire <var>form-logout-handler</var>. Tout
 345       accès à cette URL va entraîner la suppression de l'Utilisateur et
 346       du Mot de passe de la session courante, ce qui aura pour effet de
 347       déconnecter l'utilisateur.</p>
 348
 349       <p>Vous pouvez spécifier une URL vers laquelle le navigateur sera
 350       redirigé en cas de déconnection réussie, en définissant la
 351       directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>. Cette
 352       URL devra expliquer à l'utilisateur qu'il a été déconnecté, et lui
 353       donner la possibilité de se connecter à nouveau.</p>
 354
 355       <div class="example"><h3>Exemple simple de configuration de la
 356       déconnexion</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler
 357 AuthName realm
 358 AuthFormLogoutLocation http://example.com/loggedout.html
 359 Session On
 360 SessionCookieName session path=/
 361 SessionCryptoPassphrase secret</pre>
 362 </div>
 363
 364       <p>Notez que la déconnexion d'un utilisateur ne supprime pas la
 365       session ; elle supprime seulement l'utilisateur et le mot de passe
 366       de la session. Si la session qui en résulte est vide, elle sera
 367       probablement supprimée, mais ce n'est pas garanti. Si vous voulez
 368       être sûr que la session sera supprimée, affectez une valeur faible
 369       à la directive <code class="directive"><a href="../mod/mod_session.html#sessionmaxage">SessionMaxAge</a></code>, par exemple 1
 370       (affecter à cette directive la valeur zéro signifie une session
 371       sans limite d'âge).
 372       </p>
 373
 374       <div class="example"><h3>Exemple simple avec durée de validité de session
 375       limitée</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler
 376 AuthFormLogoutLocation http://example.com/loggedout.html
 377 Session On
 378 SessionMaxAge 1
 379 SessionCookieName session path=/
 380 SessionCryptoPassphrase secret</pre>
 381 </div>
 382
 383     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 384 <div class="section">
 385 <h2><a name="urlencoding" id="urlencoding">Noms d'utilisateurs et mots de
 386     passe</a></h2>
 387     <p>Notez que la soumission d'un formulaire implique l'encodage URL
 388     (URLEncoding) des données du formulaire, ici le nom d'utilisateur et
 389     le mot de passe. Vous devez donc choisir des noms d'utilisateurs et
 390     mots de passe qui ne contiennent pas de caractères susceptibles
 391     d'être encodés URL lors de la soumission du formulaire, sous peine
 392     d'obtenir des résultats inattendus.</p>
 393     </div>
 394 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 395 <div class="directive-section"><h2><a name="authformauthoritative" id="authformauthoritative">Directive</a> <a name="AuthFormAuthoritative" id="AuthFormAuthoritative">AuthFormAuthoritative</a></h2>
 396 <table class="directive">
 397 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si l'autorisation et l'authentification sont confiés à
 398 des modules de plus bas niveau</td></tr>
 399 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormAuthoritative On|Off</code></td></tr>
 400 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormAuthoritative On</code></td></tr>
 401 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 402 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
 403 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 404 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 405 </table>
 406     <p>Normalement, chacun des modules d'autorisation spécifiés par la
 407     directive <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> va tenter de
 408     vérifier l'identité de l'utilisateur, et si ce dernier n'est trouvé
 409     dans aucun fournisseur, l'accès sera refusé. En définissant
 410     explicitement la directive
 411     <code class="directive">AuthFormAuthoritative</code> à <code>Off</code> on
 412     confie les processus d'authentification et d'autorisation à des
 413     modules ne s'appuyant pas sur des fournisseurs, si <strong>aucun
 414     identifiant utilisateur</strong> ou aucune <strong>règle</strong> ne
 415     correspond à l'identifiant utilisateur fourni. Ceci ne peut s'avérer
 416     nécessaire que si l'on combine <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> avec
 417     des modules tiers qui ne se configurent pas avec la directive
 418     <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code>.
 419     Lorsqu'on utilise de tels modules, la chronologie du processus est
 420     déterminée dans leur code source, et n'est pas configurable.</p>
 421
 422 </div>
 423 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 424 <div class="directive-section"><h2><a name="authformbody" id="authformbody">Directive</a> <a name="AuthFormBody" id="AuthFormBody">AuthFormBody</a></h2>
 425 <table class="directive">
 426 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le corps de la
 427 requête à effectuer en cas de connexion réussie</td></tr>
 428 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormBody <var>nom du champ</var></code></td></tr>
 429 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_body</code></td></tr>
 430 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 431 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 432 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 433 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 434 </table>
 435     <p>La directive <code class="directive"><a href="#authformbody">AuthFormBody</a></code>
 436     spécifie le nom du champ HTML qui, s'il existe, contiendra le corps
 437     de la requête à effectuer en cas de connexion réussie.</p>
 438
 439     <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
 440     mesure de relancer une requête qui a été éventuellement interrompue
 441     par l'écran de connexion, ou par l'expiration d'un délai de
 442     session.</p>
 443
 444 </div>
 445 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 446 <div class="directive-section"><h2><a name="authformdisablenostore" id="authformdisablenostore">Directive</a> <a name="AuthFormDisableNoStore" id="AuthFormDisableNoStore">AuthFormDisableNoStore</a></h2>
 447 <table class="directive">
 448 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive l'en-tête CacheControl no-store sur la page de
 449 connexion</td></tr>
 450 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormDisableNoStore <var>On|Off</var></code></td></tr>
 451 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormDisableNoStore Off</code></td></tr>
 452 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 453 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 454 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 455 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 456 </table>
 457     <p>Le drapeau <code class="directive"><a href="#authformdisablenostore">AuthFormDisableNoStore</a></code> supprime
 458     l'envoi d'un en-tête <code>Cache-Control no-store</code> lorsqu'une
 459     page avec code d'erreur 401 est renvoyée, si l'utilisateur n'est pas
 460     encore connecté. Avec cette en-tête, il est plus difficile pour une
 461     application <code>ecmascript</code> de resoumettre un formulaire de connexion, et
 462     ainsi révéler le nom d'utilisateur et le mot de passe à
 463     l'application sous-jacente. Vous devez être conscient des risques
 464     encourus si vous le désactivez.</p>
 465
 466
 467 </div>
 468 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 469 <div class="directive-section"><h2><a name="authformfakebasicauth" id="authformfakebasicauth">Directive</a> <a name="AuthFormFakeBasicAuth" id="AuthFormFakeBasicAuth">AuthFormFakeBasicAuth</a></h2>
 470 <table class="directive">
 471 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Simule une en-tête d'authentification de base</td></tr>
 472 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormFakeBasicAuth <var>On|Off</var></code></td></tr>
 473 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormFakeBasicAuth Off</code></td></tr>
 474 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 475 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 476 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 477 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 478 </table>
 479     <p>Le drapeau <code class="directive"><a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></code>
 480     détermine si une en-tête d'<code>Authentification de base</code>
 481     sera ajoutée aux en-têtes de la requête. On peut utiliser cette
 482     méthode pour présenter le nom d'utilisateur et le mot de passe à
 483     l'application sous-jacente, sans que cette dernière ait besoin de
 484     connaître la manière dont le processus de connexion a été mené à
 485     bien.</p>
 486
 487
 488 </div>
 489 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 490 <div class="directive-section"><h2><a name="authformlocation" id="authformlocation">Directive</a> <a name="AuthFormLocation" id="AuthFormLocation">AuthFormLocation</a></h2>
 491 <table class="directive">
 492 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contiendra l'URL vers
 493 laquelle l'utilisateur sera redirigé en cas de connexion
 494 réussie</td></tr>
 495 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLocation <var>nom du champ</var></code></td></tr>
 496 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_location</code></td></tr>
 497 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 498 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 499 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 500 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 501 </table>
 502     <p>La directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>
 503     spécifie le nom du champ HTML qui, s'il existe, contiendra l'URL
 504     vers laquelle rediriger le navigateur en cas de connexion
 505     réussie.</p>
 506
 507 </div>
 508 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 509 <div class="directive-section"><h2><a name="authformloginrequiredlocation" id="authformloginrequiredlocation">Directive</a> <a name="AuthFormLoginRequiredLocation" id="AuthFormLoginRequiredLocation">AuthFormLoginRequiredLocation</a></h2>
 510 <table class="directive">
 511 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit être redirigé si une
 512 authentification est requise</td></tr>
 513 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginRequiredLocation <var>url</var></code></td></tr>
 514 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
 515 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 516 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 517 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 518 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
 519 Apache. L'interprétation des expressions rationnelles est supportée
 520 depuis la version 2.4.4.</td></tr>
 521 </table>
 522     <p>La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
 523     spécifie l'URL vers laquelle l'utilisateur devra être
 524     redirigé s'il n'est pas autorisé à accéder à une page. Sa valeur est
 525     interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
 526     avant d'être envoyée au client. Par défaut,
 527     si un utilisateur n'est pas autorisé à accéder à une page, le code
 528     de réponse HTTP <code>HTTP_UNAUTHORIZED</code> est renvoyé avec la
 529     page spécifiée par la directive <code class="directive"><a href="../mod/core.html#errordocument">ErrorDocument</a></code>. La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
 530     permet de remplacer cette valeur par défaut.</p>
 531
 532     <p>Vous pouvez utiliser cette directive si vous voulez présenter une
 533     page de connexion personnalisée à vos utilisateurs.</p>
 534
 535
 536 </div>
 537 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 538 <div class="directive-section"><h2><a name="authformloginsuccesslocation" id="authformloginsuccesslocation">Directive</a> <a name="AuthFormLoginSuccessLocation" id="AuthFormLoginSuccessLocation">AuthFormLoginSuccessLocation</a></h2>
 539 <table class="directive">
 540 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit être redirigé en cas
 541 de connexion réussie</td></tr>
 542 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginSuccessLocation <var>url</var></code></td></tr>
 543 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
 544 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 545 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 546 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 547 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
 548 Apache. L'interprétation des expressions rationnelles est supportée
 549 depuis la version 2.4.4.</td></tr>
 550 </table>
 551     <p>La directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
 552     spécifie l'URL vers laquelle l'utilisateur doit être
 553     redirigé en cas de connexion réussie. Sa valeur est
 554     interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
 555     avant d'être envoyée au client. L'effet de cette directive
 556     peut être annulé si l'on a défini un champ de formulaire contenant
 557     une autre URL à l'aide de la directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>.</p>
 558
 559     <p>Vous pouvez utiliser cette directive si vous possédez une URL de
 560     connexion personnalisée, et si vous n'avez pas intégré la page de
 561     destination dans le formulaire de connexion.</p>
 562
 563
 564 </div>
 565 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 566 <div class="directive-section"><h2><a name="authformlogoutlocation" id="authformlogoutlocation">Directive</a> <a name="AuthFormLogoutLocation" id="AuthFormLogoutLocation">AuthFormLogoutLocation</a></h2>
 567 <table class="directive">
 568 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL vers laquelle un utilisateur devra être redirigé
 569 après s'être déconnecté</td></tr>
 570 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLogoutLocation <var>uri</var></code></td></tr>
 571 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
 572 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 573 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 574 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 575 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
 576 Apache. L'interprétation des expressions rationnelles est supportée
 577 depuis la version 2.4.4.</td></tr>
 578 </table>
 579     <p>La directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>
 580     spécifie l'URL de la page du serveur vers laquelle l'utilisateur
 581     devra être redirigé s'il se déconnecte. Sa valeur est
 582     interprétée via l'interpréteur <a href="../expr.html">ap_expr</a>
 583     avant d'être envoyée au client.</p>
 584
 585     <p>Lorsqu'un accès est tenté sur un URI traité par le gestionnaire
 586     <code>form-logout-handler</code>, la page spécifiée par cette
 587     directive sera présentée à l'utilisateur final. Par exemple :</p>
 588
 589     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">&lt;Location /logout&gt;
 590     SetHandler form-logout-handler
 591     AuthFormLogoutLocation http://example.com/loggedout.html
 592     Session on
 593     #...
 594 &lt;/Location&gt;</pre>
 595 </div>
 596
 597     <p>Si un utilisateur tente d'accéder à l'URI <var>/logout/</var>, il
 598     sera déconnecté, et la page <var>/loggedout.html</var> lui sera
 599     présentée. Assurez-vous que la page <var>loggedout.html</var> n'est
 600     pas protégée par mot de passe, car dans le cas contraire, elle ne
 601     serait pas affichée.</p>
 602
 603
 604 </div>
 605 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 606 <div class="directive-section"><h2><a name="authformmethod" id="authformmethod">Directive</a> <a name="AuthFormMethod" id="AuthFormMethod">AuthFormMethod</a></h2>
 607 <table class="directive">
 608 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant la méthode de la
 609 requête à effectuer en cas de connexion réussie</td></tr>
 610 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMethod <var>nom du champ</var></code></td></tr>
 611 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_method</code></td></tr>
 612 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 613 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 614 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 615 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 616 </table>
 617     <p>La directive <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>
 618     spécifie le nom du champ HTML qui, s'il existe, contiendra le type
 619     MIME de la requête à effectuer en cas de connexion réussie.</p>
 620
 621     <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
 622     mesure de relancer une requête qui a été éventuellement interrompue
 623     par l'écran de connexion, ou par l'expiration d'un délai de
 624     session.</p>
 625
 626 </div>
 627 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 628 <div class="directive-section"><h2><a name="authformmimetype" id="authformmimetype">Directive</a> <a name="AuthFormMimetype" id="AuthFormMimetype">AuthFormMimetype</a></h2>
 629 <table class="directive">
 630 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le type MIME du
 631 corps de la requête à effectuer en cas de connexion
 632 réussie</td></tr>
 633 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMimetype <var>nom du champ</var></code></td></tr>
 634 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_mimetype</code></td></tr>
 635 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 636 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 637 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 638 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 639 </table>
 640     <p>La directive <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code>
 641     spécifie le nom du champ HTML qui, s'il existe, contiendra le type
 642     MIME de la requête à effectuer en cas de connexion réussie.</p>
 643
 644     <p>En ajoutant au formulaire les champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, un site web sera en
 645     mesure de relancer une requête qui a été éventuellement interrompue
 646     par l'écran de connexion, ou par l'expiration d'un délai de
 647     session.</p>
 648
 649 </div>
 650 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 651 <div class="directive-section"><h2><a name="authformpassword" id="authformpassword">Directive</a> <a name="AuthFormPassword" id="AuthFormPassword">AuthFormPassword</a></h2>
 652 <table class="directive">
 653 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le mot de passe
 654 de connexion</td></tr>
 655 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormPassword <var>nom du champ</var></code></td></tr>
 656 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_password</code></td></tr>
 657 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 658 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 659 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 660 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 661 </table>
 662     <p>La directive <code class="directive"><a href="#authformpassword">AuthFormPassword</a></code> permet de
 663     spécifier le nom du champ HTML qui, s'il existe, contiendra le mot
 664     de passe qui sera utilisé pour la connexion.</p>
 665
 666 </div>
 667 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 668 <div class="directive-section"><h2><a name="authformprovider" id="authformprovider">Directive</a> <a name="AuthFormProvider" id="AuthFormProvider">AuthFormProvider</a></h2>
 669 <table class="directive">
 670 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(s) fournisseur(s) d'authentification pour la
 671 zone concernée</td></tr>
 672 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormProvider <var>nom fournisseur</var>
 673 [<var>nom fournisseur</var>] ...</code></td></tr>
 674 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthFormProvider file</code></td></tr>
 675 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
 676 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
 677 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 678 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 679 </table>
 680     <p>La directive <code class="directive">AuthFormProvider</code> permet de
 681     définir quel fournisseur sera utilisé pour authentifier les
 682     utilisateurs pour la zone concernée. Le fournisseur par défaut
 683     <code>file</code> est implémenté par le module
 684     <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le fournisseur
 685     choisi soit bien présent dans le serveur.</p>
 686
 687     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">&lt;Location /secure&gt;
 688     AuthType form
 689     AuthName "private area"
 690     AuthFormProvider  dbm
 691     AuthDBMType        SDBM
 692     AuthDBMUserFile    /www/etc/dbmpasswd
 693     Require            valid-user
 694     #...
 695 &lt;/Location&gt;</pre>
 696 </div>
 697
 698     <p>Les différents fournisseurs sont implémentés par les modules
 699     <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>,
 700     <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et
 701     <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p>
 702
 703 </div>
 704 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 705 <div class="directive-section"><h2><a name="authformsitepassphrase" id="authformsitepassphrase">Directive</a> <a name="AuthFormSitePassphrase" id="AuthFormSitePassphrase">AuthFormSitePassphrase</a></h2>
 706 <table class="directive">
 707 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Court-circuite l'authentification pour les sites à fort
 708 trafic</td></tr>
 709 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSitePassphrase <var>secret</var></code></td></tr>
 710 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
 711 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 712 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 713 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 714 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 715 </table>
 716     <p>La directive <code class="directive"><a href="#authformsitepassphrase">AuthFormSitePassphrase</a></code>
 717     spécifie un mot de passe qui, s'il est présent dans la session
 718     utilisateur, indique à Apache httpd de court-circuiter l'authentification
 719     pour l'URL considérée. On peut l'utiliser dans le cas de sites web à
 720     fort trafic afin de réduire la charge induite sur l'infrastructure
 721     d'authentification.</p>
 722
 723     <p>On peut insérer le mot de passe dans une session utilisateur en
 724     ajoutant cette directive à la configuration concernant le
 725     gestionnaire <var>form-login-handler</var>. Le gestionnaire
 726     <var>form-login-handler</var>, quant à lui, effectuera toujours les
 727     vérifications d'authentification, qu'un mot de passe soit spécifié
 728     ou non.</p>
 729
 730     <div class="warning"><h3>Avertissement</h3>
 731       <p>Si la session est présentée à l'utilisateur à l'aide du module
 732       <code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et si la session n'est pas
 733       protégée par le module <code class="module"><a href="../mod/mod_session_crypto.html">mod_session_crypto</a></code>, le mot
 734       de passe peut faire l'objet d'une attaque de type dictionnaire.
 735       Quelle que soit la configuration de la session, assurez-vous que
 736       cette directive n'est pas utilisée dans un espace d'URLs contenant
 737       des données privées, ou à partir desquelles des transactions
 738       sensibles pourraient être menées. En tout état de cause, vous
 739       devez être conscient des risques encourus avant de l'utiliser.</p>
 740     </div>
 741
 742
 743 </div>
 744 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 745 <div class="directive-section"><h2><a name="authformsize" id="authformsize">Directive</a> <a name="AuthFormSize" id="AuthFormSize">AuthFormSize</a></h2>
 746 <table class="directive">
 747 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille maximale en octets du formulaire dont seront
 748 extraites les informations de connexion</td></tr>
 749 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSize <var>taille</var></code></td></tr>
 750 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>8192</code></td></tr>
 751 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 752 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 753 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 754 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
 755 </table>
 756     <p>La directive <code class="directive"><a href="#authformsize">AuthFormSize</a></code> spécifie
 757     la taille maximale du corps de la requête qui sera utilisée pour
 758     trouver le formulaire de connexion.</p>
 759
 760     <p>Si une requête de connexion entrante possède une taille
 761     supérieure à cette valeur, elle sera rejetée avec le code de réponse
 762     HTTP <code>HTTP_REQUEST_TOO_LARGE</code>.</p>
 763
 764     <p>Si vous avez ajouté au formulaire des champs décrits dans <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>, <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code> et <code class="directive"><a href="#authformbody">AuthFormBody</a></code>, il est recommandé
 765     de définir cette directive à une valeur similaire à celle de la
 766     directive <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>.</p>
 767
 768
 769 </div>
 770 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 771 <div class="directive-section"><h2><a name="authformusername" id="authformusername">Directive</a> <a name="AuthFormUsername" id="AuthFormUsername">AuthFormUsername</a></h2>
 772 <table class="directive">
 773 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le nom de
 774 connexion</td></tr>
 775 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormUsername <var>nom du champ</var></code></td></tr>
 776 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>httpd_username</code></td></tr>
 777 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr>
 778 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
 779 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
 780 <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>
 781 </table>
 782     <p>La directive <code class="directive"><a href="#authformusername">AuthFormUsername</a></code> permet de
 783     spécifier le nom du champ HTML qui, s'il existe, contiendra le nom
 784     d'utilisateur qui sera utilisé pour la connexion.</p>
 785
 786 </div>
 787 </div>
 788 <div class="bottomlang">
 789 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 790 <a href="../fr/mod/mod_auth_form.html" title="Français">&nbsp;fr&nbsp;</a></p>
 791 </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>
 792 <script type="text/javascript"><!--//--><![CDATA[//><!--
 793 var comments_shortname = 'httpd';
 794 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_form.html';
 795 (function(w, d) {
 796     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 797         d.write('<div id="comments_thread"><\/div>');
 798         var s = d.createElement('script');
 799         s.type = 'text/javascript';
 800         s.async = true;
 801         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 802         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 803     }
 804     else {
 805         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 806     }
 807 })(window, document);
 808 //--><!]]></script></div><div id="footer">
 809 <p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 810 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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[//><!--
 811 if (typeof(prettyPrint) !== 'undefined') {
 812     prettyPrint();
 813 }
 814 //--><!]]></script>
 815 </body></html>