www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-07-08 20:42:01 +03:00
Code Activity
Files
8c84b4ceac215d2bb2b51b23b8e9ee60f768d196
apache/docs/manual/mod/mod_auth_form.html.fr
Lucien Gentis 5339349598 Rebuild. 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1746003 13f79535-47bb-0310-9956-ffa450edef68
2016-05-29 13:10:45 +00:00

821 lines
54 KiB
Plaintext
Raw Blame History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_auth_form - Serveur Apache HTTP Version 2.5</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<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" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<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>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_auth_form</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_auth_form.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification <20> l'aide d'un formulaire</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>auth_form_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_auth_form.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible <20> partir d'Apache 2.3</td></tr></table>
<h3>Sommaire</h3>
<div class="warning"><h3>Avertissement</h3>
<p>L'authentification <20> base de formulaire d<>pend des modules
<code class="module"><a href="../mod/mod_session.html">mod_session</a></code> qui utilisent les cookies HTTP, et en
tant que tels s'exposent <20> des attaques de type Cross Site
Scripting, ou risquent de divulguer des informations <20> caract<63>re
priv<69> aux clients. Assurez-vous que ces risques ont bien <20>t<EFBFBD> pris
en compte avant d'activer les sessions sur votre serveur.</p>
</div>
<p>Ce module permet de restreindre l'acc<63>s en recherchant les
utilisateurs dans les fournisseurs sp<73>cifi<66>s <20> l'aide d'un
formulaire de connexion HTML. Les formulaires HTML requi<75>rent
davantage de configuration que les m<>thodes d'authentification
alternatives, mais ils peuvent s'av<61>rer beaucoup plus conviviaux
pour les utilisateurs.
</p>
<p>L'authentification HTTP de base est fournie par le module
<code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code>, et l'authentification HTTP <20> base
de condens<6E> par le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. Le
module <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> doit <20>tre utilis<69> avec au
moins un module d'authentification du style
<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et un module d'autorisation comme
<code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>.</p>
<p>Lorsque l'utilisateur a <20>t<EFBFBD> authentifi<66> avec succ<63>s, ses
informations de connexion sont stock<63>s dans une session fournie par
le module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>.
</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#basicconfig">Configuration de base</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#standalone">Page de connexion d<>di<64>e</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#inline">Connexion <20> la vol<6F>e</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#inlinepreservebody">Connexion <20> la vol<6F>e avec
conservation du contenu</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#loggingout">D<>connexion</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#urlencoding">Noms d'utilisateurs et mots de
passe</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#authformauthoritative">AuthFormAuthoritative</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformbody">AuthFormBody</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformdisablenostore">AuthFormDisableNoStore</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformlocation">AuthFormLocation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformlogoutlocation">AuthFormLogoutLocation</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformmethod">AuthFormMethod</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformmimetype">AuthFormMimetype</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformpassword">AuthFormPassword</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformprovider">AuthFormProvider</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformsitepassphrase">AuthFormSitePassphrase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformsize">AuthFormSize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#authformusername">AuthFormUsername</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_auth_form">Probl<62>mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_auth_form">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><code class="module"><a href="../mod/mod_session.html">mod_session</a></code></li>
<li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li>
<li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li>
<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li>
<li><a href="../howto/auth.html">Mise en oeuvre de
l'authentification</a></li>
<li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="basicconfig" id="basicconfig">Configuration de base</a></h2>
<p>Pour prot<6F>ger une URL particuli<6C>re avec le module
<code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, vous devez d<>terminer l'endroit o<>
vous allez stocker votre <var>session</var>, ainsi que la m<>thode
d'authentification. Dans cet exemple simple, les informations de
connexion sont stock<63>es dans une session <20> l'aide du module
<code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et l'authentification utilise
un fichier en s'appuyant sur le module
<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Si l'authentification <20>choue,
l'utilisateur dera redirig<69> vers la page du formulaire de
connexion.</p>
<div class="example"><h3>Exemple simple</h3><pre class="prettyprint lang-config">&lt;Location "/admin"&gt;
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName "/admin"
AuthFormLoginRequiredLocation "http://example.com/login.html"
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret
Require valid-user
&lt;/Location&gt;</pre>
</div>
<p>L'authentification <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> est activ<69>e
en affectant la valeur <var>form</var> <20> la directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>. Les directives
<code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> et
<code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code>
sp<73>cifient que les noms d'utilisateurs et mots de passe seront
v<>rifi<66>s en utilisant le fichier choisi.</p>
<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
<code class="directive"><a href="../mod/mod_session_crypto.html#sessioncryptopassphrase">SessionCryptoPassphrase</a></code>
cr<63>ent une session chiffr<66>e stock<63>e dans un cookie HTTP au niveau
du navigateur. Pour plus d'informations <20> propos des diff<66>rentes
options de configuration des sessions, reportez-vous <20> la
documentation du module <code class="module"><a href="../mod/mod_session.html">mod_session</a></code>.</p>
<p>Dans l'exemple simple ci-dessus, une URL a <20>t<EFBFBD> prot<6F>g<EFBFBD>e par
<code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, mais on doit maintenant fournir
<20> l'utilisateur un moyen d'entrer un nom et un mot de passe. <20> cet
effet, on peut soit <20>crire une page de connexion ind<6E>pendante
d<>di<64>e, soit inclure le formulaire de connexion dans la page
courante.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="standalone" id="standalone">Page de connexion d<>di<64>e</a></h2>
<p>Le formulaire de connexion peut <20>tre contenu dans une page
ind<6E>pendante, ou <20>tre inclus dans la page courante. </p>
<p>Lorsque la connexion s'effectue <20> partir d'une page
ind<6E>pendante et si la tentative d'authentification <20>choue,
l'utilisateur doit <20>tre redirig<69> vers un formulaire de connexion,
cr<63><72> <20> cet effet sur le site web, en utilisant la directive
<code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>.
En g<>n<EFBFBD>ral, la page de connexion contiendra un formulaire HTML
demandant <20> l'utilisateur de fournir un nom et un mot de passe.</p>
<div class="example"><h3>Exemple de formulaire de connexion</h3><pre class="prettyprint lang-html">&lt;form method="POST" action="/dologin.html"&gt;
Username: &lt;input type="text" name="httpd_username" value="" /&gt;
Password: &lt;input type="password" name="httpd_password" value="" /&gt;
&lt;input type="submit" name="login" value="Login" /&gt;
&lt;/form&gt;</pre>
</div>
<p>La partie o<> s'effectue la connexion proprement dite est
trait<69>e par le gestionnaire <var>form-login-handler</var>.
L'action de ce formulaire doit pointer vers ce gestionnaire, ce
que l'on configure dans Apache httpd comme suit :</p>
<div class="example"><h3>Exemple de configuration du gestionnaire de
formulaire de connexion</h3><pre class="prettyprint lang-config">&lt;Location "/dologin.html"&gt;
SetHandler form-login-handler
AuthFormLoginRequiredLocation "http://example.com/login.html"
AuthFormLoginSuccessLocation "http://example.com/success.html"
AuthFormProvider file
AuthUserFile "conf/passwd"
AuthType form
AuthName realm
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret
&lt;/Location&gt;</pre>
</div>
<p>L'URL sp<73>cifi<66>e par la directive
<code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
r<>f<EFBFBD>rencera en g<>n<EFBFBD>ral une page expliquant <20> l'utilisateur que sa
tentative de connexion a <20>chou<6F>, et qu'il doit la renouveler. La
directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
sp<73>cifie l'URL vers laquelle l'utilisateur doit <20>tre redirig<69> s'il
s'est authentifi<66> avec succ<63>s.</p>
<p>Alternativement, l'URL vers laquelle doit <20>tre redirig<69>
l'utilisateur s'il s'est authentifi<66> avec succ<63>s peut <20>tre
int<6E>gr<67>e dans le formulaire de connexion, comme dans l'exemple
ci-dessous. Il en d<>coule que le m<>me gestionnaire
<var>form-login-handler</var> pourra <20>tre utilis<69> pour diff<66>rentes
zones du site web.</p>
<div class="example"><h3>Exemple de formulaire d'authentification multizone</h3><pre class="prettyprint lang-html">&lt;form method="POST" action="/dologin.html"&gt;
Username: &lt;input type="text" name="httpd_username" value="" /&gt;
Password: &lt;input type="password" name="httpd_password" value="" /&gt;
&lt;input type="submit" name="login" value="Login" /&gt;
&lt;input type="hidden" name="httpd_location" value="http://example.com/success.html" /&gt;
&lt;/form&gt;</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="inline" id="inline">Connexion <20> la vol<6F>e</a></h2>
<div class="warning"><h3>Avertissement</h3>
<p>Il existe un risque, dans certaines circonstances, que le
formulaire de connexion configur<75> pour une connexion <20> la vol<6F>e
soit soumis plusieurs fois, r<>v<EFBFBD>lant de ce fait les param<61>tres
de connexion <20> l'application sous-jacente. L'administrateur doit
s'assurer que cette derni<6E>re est correctement s<>curis<69>e afin
d'<27>viter les <20>ventuels abus. En cas de doute, utilisez une page
de connexion ind<6E>pendante d<>di<64>e.</p>
</div>
<p>Comme alternative <20> la page de connexion d<>di<64>e pour un site
web, il est possible de configurer <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>
pour authentifier les utilisateurs <20> la vol<6F>e, sans les rediriger
vers une autre page, ce qui permet de conserver l'<27>tat de la page
courante au cours de la tentative de connexion. Ceci peut s'av<61>rer
utile dans le cas d'une session limit<69>e dans le temps, si le d<>lai
de la session a expir<69> pendant la requ<71>te de l'utilisateur. Ce
dernier peut alors se r<>authentifier <20> la m<>me place, et
poursuivre son activit<69> <20> partir du point o<> il en <20>tait rest<73>.</p>
<p>Si un utilisateur non authentifi<66> tente d'acc<63>der <20> une page
prot<6F>g<EFBFBD>e par <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>, et si ce dernier
n'est pas configur<75> avec une directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>,
un code de statut <var>HTTP_UNAUTHORIZED</var> est renvoy<6F> vers le
navigateur, indiquant <20> l'utilisateur qu'il n'est pas autoris<69> <20>
acc<63>der <20> cette page.</p>
<p>Pour configurer l'authentification <20> la vol<6F>e, l'administrateur
remplace le message d'erreur renvoy<6F> par le code de statut
<var>HTTP_UNAUTHORIZED</var> par un message d'erreur personnalis<69>
contenant le formulaire de connexion comme suit :</p>
<div class="example"><h3>Exemple simple d'authentification <20> la vol<6F>e</h3><pre class="prettyprint lang-config">AuthFormProvider file
ErrorDocument 401 "/login.shtml"
AuthUserFile "conf/passwd"
AuthType form
AuthName realm
AuthFormLoginRequiredLocation "http://example.com/login.html"
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret</pre>
</div>
<p>La page du message d'erreur doit contenir un formulaire de
connexion dont la propri<72>t<EFBFBD> action est vide, comme dans l'exemple
ci-dessous. Ceci a pour effet de soumettre le formulaire <20> l'URL
prot<6F>g<EFBFBD>e originale, cette derni<6E>re n'ayant pas besoin d'<27>tre
connue de la page en cours.</p>
<div class="example"><h3>Exemple de formulaire de connexion <20> la vol<6F>e</h3><pre class="prettyprint lang-html">&lt;form method="POST" <strong>action=""</strong>&gt;
Username: &lt;input type="text" name="httpd_username" value="" /&gt;
Password: &lt;input type="password" name="httpd_password" value="" /&gt;
&lt;input type="submit" name="login" value="Login" /&gt;
&lt;/form&gt;</pre>
</div>
<p>Lorsque l'utilisateur final a entr<74> ses informations de
connexion, le formulaire effectue une requ<71>te HTTP POST pour l'URL
originale prot<6F>g<EFBFBD>e par mot de passe.
<code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> va alors intercepter cette requ<71>te
POST, et dans le cas o<> des champs HTML Utilisateur et Mot de
passe corrects sont pr<70>sents, l'utilisateur sera connect<63>, et
l'URL originale prot<6F>g<EFBFBD>e par mot de passe lui sera retourn<72>e en
tant que requ<71>te GET.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="inlinepreservebody" id="inlinepreservebody">Connexion <20> la vol<6F>e avec
conservation du contenu</a></h2>
<p>Il existe une limite <20> la technique de connexion <20> la vol<6F>e
d<>crite ci-dessus ; si un formulaire HTML POST entra<72>ne une
demande d'authentification ou de r<>authentification, le contenu du
formulaire original envoy<6F> par le navigateur sera perdu. Cela peut
s'av<61>rer plus ou moins g<>nant pour l'utilisateur final selon la
fonction du site web.</p>
<p>Comme solution <20> ce probl<62>me, <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code>
permet d'int<6E>grer la m<>thode et le contenu de la requ<71>te originale
dans le formulaire de connexion. Si l'authentification r<>ussit,
Apache httpd pourra refaire une tentative avec la m<>thode et le contenu
originaux, tout en conservant l'<27>tat de la requ<71>te originale.</p>
<p>Pour mettre en oeuvre la conservation du contenu, vous devez
ajouter trois champs suppl<70>mentaires au formulaire de connexion
comme dans l'exemple suivant :</p>
<div class="example"><h3>Exemple de formulaire avec conservation du
contenu</h3><pre class="prettyprint lang-html">&lt;form method="POST" action=""&gt;
Username: &lt;input type="text" name="httpd_username" value="" /&gt;
Password: &lt;input type="password" name="httpd_password" value="" /&gt;
&lt;input type="submit" name="login" value="Login" /&gt;
<br /> <strong>&lt;input type="hidden" name="httpd_method" value="POST" /&gt;
&lt;input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" /&gt;
&lt;input type="hidden" name="httpd_body" value="name1=value1&amp;name2=value2" /&gt;</strong><br />
&lt;/form&gt;</pre>
</div>
<p>La mani<6E>re dont la m<>thode, le type MIME et le contenu de la
requ<71>te originale seront int<6E>gr<67>s dans le formulaire de connexion
vont d<>pendre de la plate-forme et de la technologie utilis<69>es au
sein du site web.
</p>
<p>Une option consiste <20> utiliser le module
<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> en association avec la directive
<code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>, ainsi
qu'un script CGI adapt<70> pour int<6E>grer les variables dans le
formulaire.</p>
<p>Une autre option consiste <20> pr<70>senter le formulaire de
connexion en utilisant un script CGI ou une autre technologie
dynamique.</p>
<div class="example"><h3>Exemple avec script CGI</h3><pre class="prettyprint lang-config"> AuthFormProvider file
ErrorDocument 401 "/cgi-bin/login.cgi"
...</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="loggingout" id="loggingout">D<>connexion</a></h2>
<p>Pour permettre <20> un utilisateur de se d<>connecter d'une session
particuli<6C>re, vous devez configurer une page pour qu'elle soit
trait<69>e par le gestionnaire <var>form-logout-handler</var>. Tout
acc<63>s <20> cette URL va entra<72>ner la suppression de l'Utilisateur et
du Mot de passe de la session courante, ce qui aura pour effet de
d<>connecter l'utilisateur.</p>
<p>Vous pouvez sp<73>cifier une URL vers laquelle le navigateur sera
redirig<69> en cas de d<>connection r<>ussie, en d<>finissant la
directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>. Cette
URL devra expliquer <20> l'utilisateur qu'il a <20>t<EFBFBD> d<>connect<63>, et lui
donner la possibilit<69> de se connecter <20> nouveau.</p>
<div class="example"><h3>Exemple simple de configuration de la
d<>connexion</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler
AuthName realm
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret</pre>
</div>
<p>Notez que la d<>connexion d'un utilisateur ne supprime pas la
session ; elle supprime seulement l'utilisateur et le mot de passe
de la session. Si la session qui en r<>sulte est vide, elle sera
probablement supprim<69>e, mais ce n'est pas garanti. Si vous voulez
<20>tre s<>r que la session sera supprim<69>e, affectez une valeur faible
<20> la directive <code class="directive"><a href="../mod/mod_session.html#sessionmaxage">SessionMaxAge</a></code>, par exemple 1
(affecter <20> cette directive la valeur z<>ro signifie une session
sans limite d'<27>ge).
</p>
<div class="example"><h3>Exemple simple avec dur<75>e de validit<69> de session
limit<69>e</h3><pre class="prettyprint lang-config">SetHandler form-logout-handler
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session On
SessionMaxAge 1
SessionCookieName session path=/
SessionCryptoPassphrase secret</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="urlencoding" id="urlencoding">Noms d'utilisateurs et mots de
passe</a></h2>
<p>Notez que la soumission d'un formulaire implique l'encodage URL
(URLEncoding) des donn<6E>es du formulaire, ici le nom d'utilisateur et
le mot de passe. Vous devez donc choisir des noms d'utilisateurs et
mots de passe qui ne contiennent pas de caract<63>res susceptibles
d'<27>tre encod<6F>s URL lors de la soumission du formulaire, sous peine
d'obtenir des r<>sultats inattendus.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformauthoritative" id="authformauthoritative">Directive</a> <a name="AuthFormAuthoritative" id="AuthFormAuthoritative">AuthFormAuthoritative</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>termine si l'autorisation et l'authentification sont confi<66>s <20>
des modules de plus bas niveau</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormAuthoritative On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>AuthFormAuthoritative On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
</table>
<p>Normalement, chacun des modules d'autorisation sp<73>cifi<66>s par la
directive <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> va tenter de
v<>rifier l'identit<69> de l'utilisateur, et si ce dernier n'est trouv<75>
dans aucun fournisseur, l'acc<63>s sera refus<75>. En d<>finissant
explicitement la directive
<code class="directive">AuthFormAuthoritative</code> <20> <code>Off</code> on
confie les processus d'authentification et d'autorisation <20> des
modules ne s'appuyant pas sur des fournisseurs, si <strong>aucun
identifiant utilisateur</strong> ou aucune <strong>r<>gle</strong> ne
correspond <20> l'identifiant utilisateur fourni. Ceci ne peut s'av<61>rer
n<>cessaire que si l'on combine <code class="module"><a href="../mod/mod_auth_form.html">mod_auth_form</a></code> avec
des modules tiers qui ne se configurent pas avec la directive
<code class="directive"><a href="#authformprovider">AuthFormProvider</a></code>.
Lorsqu'on utilise de tels modules, la chronologie du processus est
d<>termin<69>e dans leur code source, et n'est pas configurable.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformbody" id="authformbody">Directive</a> <a name="AuthFormBody" id="AuthFormBody">AuthFormBody</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le corps de la
requ<EFBFBD>te <20> effectuer en cas de connexion r<>ussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormBody <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_body</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformbody">AuthFormBody</a></code>
sp<73>cifie le nom du champ HTML qui, s'il existe, contiendra le corps
de la requ<71>te <20> effectuer en cas de connexion r<>ussie.</p>
<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
mesure de relancer une requ<71>te qui a <20>t<EFBFBD> <20>ventuellement interrompue
par l'<27>cran de connexion, ou par l'expiration d'un d<>lai de
session.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformdisablenostore" id="authformdisablenostore">Directive</a> <a name="AuthFormDisableNoStore" id="AuthFormDisableNoStore">AuthFormDisableNoStore</a></h2>
<table class="directive">
<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
connexion</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormDisableNoStore <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>AuthFormDisableNoStore Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>Le drapeau <code class="directive"><a href="#authformdisablenostore">AuthFormDisableNoStore</a></code> supprime
l'envoi d'un en-t<>te <code>Cache-Control no-store</code> lorsqu'une
page avec code d'erreur 401 est renvoy<6F>e, si l'utilisateur n'est pas
encore connect<63>. Avec cette en-t<>te, il est plus difficile pour une
application <code>ecmascript</code> de resoumettre un formulaire de connexion, et
ainsi r<>v<EFBFBD>ler le nom d'utilisateur et le mot de passe <20>
l'application sous-jacente. Vous devez <20>tre conscient des risques
encourus si vous le d<>sactivez.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformfakebasicauth" id="authformfakebasicauth">Directive</a> <a name="AuthFormFakeBasicAuth" id="AuthFormFakeBasicAuth">AuthFormFakeBasicAuth</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Simule une en-t<>te d'authentification de base</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormFakeBasicAuth <var>On|Off</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>AuthFormFakeBasicAuth Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>Le drapeau <code class="directive"><a href="#authformfakebasicauth">AuthFormFakeBasicAuth</a></code>
d<>termine si une en-t<>te d'<code>Authentification de base</code>
sera ajout<75>e aux en-t<>tes de la requ<71>te. On peut utiliser cette
m<>thode pour pr<70>senter le nom d'utilisateur et le mot de passe <20>
l'application sous-jacente, sans que cette derni<6E>re ait besoin de
conna<6E>tre la mani<6E>re dont le processus de connexion a <20>t<EFBFBD> men<65> <20>
bien.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformlocation" id="authformlocation">Directive</a> <a name="AuthFormLocation" id="AuthFormLocation">AuthFormLocation</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contiendra l'URL vers
laquelle l'utilisateur sera redirig<69> en cas de connexion
r<EFBFBD>ussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLocation <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_location</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>
sp<73>cifie le nom du champ HTML qui, s'il existe, contiendra l'URL
vers laquelle rediriger le navigateur en cas de connexion
r<>ussie.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformloginrequiredlocation" id="authformloginrequiredlocation">Directive</a> <a name="AuthFormLoginRequiredLocation" id="AuthFormLoginRequiredLocation">AuthFormLoginRequiredLocation</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit <20>tre redirig<69> si une
authentification est requise</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginRequiredLocation <var>url</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr<70>tation des expressions rationnelles est support<72>e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
sp<73>cifie l'URL vers laquelle l'utilisateur devra <20>tre
redirig<69> s'il n'est pas autoris<69> <20> acc<63>der <20> une page. Sa valeur est
interpr<70>t<EFBFBD>e via l'interpr<70>teur <a href="../expr.html">ap_expr</a>
avant d'<27>tre envoy<6F>e au client. Par d<>faut,
si un utilisateur n'est pas autoris<69> <20> acc<63>der <20> une page, le code
de r<>ponse HTTP <code>HTTP_UNAUTHORIZED</code> est renvoy<6F> avec la
page sp<73>cifi<66>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>
permet de remplacer cette valeur par d<>faut.</p>
<p>Vous pouvez utiliser cette directive si vous voulez pr<70>senter une
page de connexion personnalis<69>e <20> vos utilisateurs.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformloginsuccesslocation" id="authformloginsuccesslocation">Directive</a> <a name="AuthFormLoginSuccessLocation" id="AuthFormLoginSuccessLocation">AuthFormLoginSuccessLocation</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL de la page vers laquelle on doit <20>tre redirig<69> en cas
de connexion r<>ussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLoginSuccessLocation <var>url</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr<70>tation des expressions rationnelles est support<72>e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
sp<73>cifie l'URL vers laquelle l'utilisateur doit <20>tre
redirig<69> en cas de connexion r<>ussie. Sa valeur est
interpr<70>t<EFBFBD>e via l'interpr<70>teur <a href="../expr.html">ap_expr</a>
avant d'<27>tre envoy<6F>e au client. L'effet de cette directive
peut <20>tre annul<75> si l'on a d<>fini un champ de formulaire contenant
une autre URL <20> l'aide de la directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>.</p>
<p>Vous pouvez utiliser cette directive si vous poss<73>dez une URL de
connexion personnalis<69>e, et si vous n'avez pas int<6E>gr<67> la page de
destination dans le formulaire de connexion.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformlogoutlocation" id="authformlogoutlocation">Directive</a> <a name="AuthFormLogoutLocation" id="AuthFormLogoutLocation">AuthFormLogoutLocation</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'URL vers laquelle un utilisateur devra <20>tre redirig<69>
apr<EFBFBD>s s'<27>tre d<>connect<63></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormLogoutLocation <var>uri</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr<70>tation des expressions rationnelles est support<72>e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>
sp<73>cifie l'URL de la page du serveur vers laquelle l'utilisateur
devra <20>tre redirig<69> s'il se d<>connecte. Sa valeur est
interpr<70>t<EFBFBD>e via l'interpr<70>teur <a href="../expr.html">ap_expr</a>
avant d'<27>tre envoy<6F>e au client.</p>
<p>Lorsqu'un acc<63>s est tent<6E> sur un URI trait<69> par le gestionnaire
<code>form-logout-handler</code>, la page sp<73>cifi<66>e par cette
directive sera pr<70>sent<6E>e <20> l'utilisateur final. Par exemple :</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">&lt;Location "/logout"&gt;
SetHandler form-logout-handler
AuthFormLogoutLocation "http://example.com/loggedout.html"
Session on
#...
&lt;/Location&gt;</pre>
</div>
<p>Si un utilisateur tente d'acc<63>der <20> l'URI <var>/logout/</var>, il
sera d<>connect<63>, et la page <var>/loggedout.html</var> lui sera
pr<70>sent<6E>e. Assurez-vous que la page <var>loggedout.html</var> n'est
pas prot<6F>g<EFBFBD>e par mot de passe, car dans le cas contraire, elle ne
serait pas affich<63>e.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformmethod" id="authformmethod">Directive</a> <a name="AuthFormMethod" id="AuthFormMethod">AuthFormMethod</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant la m<>thode de la
requ<EFBFBD>te <20> effectuer en cas de connexion r<>ussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMethod <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_method</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformmethod">AuthFormMethod</a></code>
sp<73>cifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requ<71>te <20> effectuer en cas de connexion r<>ussie.</p>
<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
mesure de relancer une requ<71>te qui a <20>t<EFBFBD> <20>ventuellement interrompue
par l'<27>cran de connexion, ou par l'expiration d'un d<>lai de
session.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformmimetype" id="authformmimetype">Directive</a> <a name="AuthFormMimetype" id="AuthFormMimetype">AuthFormMimetype</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire contenant le type MIME du
corps de la requ<71>te <20> effectuer en cas de connexion
r<EFBFBD>ussie</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormMimetype <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_mimetype</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformmimetype">AuthFormMimetype</a></code>
sp<73>cifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requ<71>te <20> effectuer en cas de connexion r<>ussie.</p>
<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
mesure de relancer une requ<71>te qui a <20>t<EFBFBD> <20>ventuellement interrompue
par l'<27>cran de connexion, ou par l'expiration d'un d<>lai de
session.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformpassword" id="authformpassword">Directive</a> <a name="AuthFormPassword" id="AuthFormPassword">AuthFormPassword</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le mot de passe
de connexion</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormPassword <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_password</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformpassword">AuthFormPassword</a></code> permet de
sp<73>cifier le nom du champ HTML qui, s'il existe, contiendra le mot
de passe qui sera utilis<69> pour la connexion.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformprovider" id="authformprovider">Directive</a> <a name="AuthFormProvider" id="AuthFormProvider">AuthFormProvider</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D<>finit le(s) fournisseur(s) d'authentification pour la
zone concern<72>e</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormProvider <var>nom fournisseur</var>
[<var>nom fournisseur</var>] ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>AuthFormProvider file</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
</table>
<p>La directive <code class="directive">AuthFormProvider</code> permet de
d<>finir quel fournisseur sera utilis<69> pour authentifier les
utilisateurs pour la zone concern<72>e. Le fournisseur par d<>faut
<code>file</code> est impl<70>ment<6E> par le module
<code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le fournisseur
choisi soit bien pr<70>sent dans le serveur.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">&lt;Location "/secure"&gt;
AuthType form
AuthName "private area"
AuthFormProvider dbm
AuthDBMType SDBM
AuthDBMUserFile "/www/etc/dbmpasswd"
Require valid-user
#...
&lt;/Location&gt;</pre>
</div>
<p>Les diff<66>rents fournisseurs sont impl<70>ment<6E>s par les modules
<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>,
<code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code> et
<code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformsitepassphrase" id="authformsitepassphrase">Directive</a> <a name="AuthFormSitePassphrase" id="AuthFormSitePassphrase">AuthFormSitePassphrase</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Court-circuite l'authentification pour les sites <20> fort
trafic</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSitePassphrase <var>secret</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>none</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformsitepassphrase">AuthFormSitePassphrase</a></code>
sp<73>cifie un mot de passe qui, s'il est pr<70>sent dans la session
utilisateur, indique <20> Apache httpd de court-circuiter l'authentification
pour l'URL consid<69>r<EFBFBD>e. On peut l'utiliser dans le cas de sites web <20>
fort trafic afin de r<>duire la charge induite sur l'infrastructure
d'authentification.</p>
<p>On peut ins<6E>rer le mot de passe dans une session utilisateur en
ajoutant cette directive <20> la configuration concernant le
gestionnaire <var>form-login-handler</var>. Le gestionnaire
<var>form-login-handler</var>, quant <20> lui, effectuera toujours les
v<>rifications d'authentification, qu'un mot de passe soit sp<73>cifi<66>
ou non.</p>
<div class="warning"><h3>Avertissement</h3>
<p>Si la session est pr<70>sent<6E>e <20> l'utilisateur <20> l'aide du module
<code class="module"><a href="../mod/mod_session_cookie.html">mod_session_cookie</a></code>, et si la session n'est pas
prot<6F>g<EFBFBD>e par le module <code class="module"><a href="../mod/mod_session_crypto.html">mod_session_crypto</a></code>, le mot
de passe peut faire l'objet d'une attaque de type dictionnaire.
Quelle que soit la configuration de la session, assurez-vous que
cette directive n'est pas utilis<69>e dans un espace d'URLs contenant
des donn<6E>es priv<69>es, ou <20> partir desquelles des transactions
sensibles pourraient <20>tre men<65>es. En tout <20>tat de cause, vous
devez <20>tre conscient des risques encourus avant de l'utiliser.</p>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformsize" id="authformsize">Directive</a> <a name="AuthFormSize" id="AuthFormSize">AuthFormSize</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille maximale en octets du formulaire dont seront
extraites les informations de connexion</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormSize <var>taille</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>8192</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformsize">AuthFormSize</a></code> sp<73>cifie
la taille maximale du corps de la requ<71>te qui sera utilis<69>e pour
trouver le formulaire de connexion.</p>
<p>Si une requ<71>te de connexion entrante poss<73>de une taille
sup<75>rieure <20> cette valeur, elle sera rejet<65>e avec le code de r<>ponse
HTTP <code>HTTP_REQUEST_TOO_LARGE</code>.</p>
<p>Si vous avez ajout<75> 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<6E>
de d<>finir cette directive <20> une valeur similaire <20> celle de la
directive <code class="directive"><a href="../mod/mod_request.html#keptbodysize">KeptBodySize</a></code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="authformusername" id="authformusername">Directive</a> <a name="AuthFormUsername" id="AuthFormUsername">AuthFormUsername</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du champ de formulaire qui contient le nom de
connexion</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthFormUsername <var>nom du champ</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D<>faut:</a></th><td><code>httpd_username</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_form</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformusername">AuthFormUsername</a></code> permet de
sp<73>cifier le nom du champ HTML qui, s'il existe, contiendra le nom
d'utilisateur qui sera utilis<69> pour la connexion.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_form.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_auth_form.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a></p>
</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>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_form.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<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[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
View Git Blame Copy Permalink