mod_auth_form.html.fr revision 38ba70f0f7aec8025f2e8800749c5997e15ca35e
<?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">
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>
<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>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <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"> en </a> |
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification � l'aide d'un formulaire</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>auth_form_module</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir d'Apache 2.3</td></tr></table>
<h3>Sommaire</h3>
<div class="warning"><h3>Avertissement</h3>
<p>L'authentification � 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 � des attaques de type Cross Site
Scripting, ou risquent de divulguer des informations � caract�re
priv� aux clients. Assurez-vous que ces risques ont bien �t� pris
en compte avant d'activer les sessions sur votre serveur.</p>
</div>
<p>Ce module permet de restreindre l'acc�s en recherchant les
utilisateurs dans les fournisseurs sp�cifi�s � l'aide d'un
formulaire de connexion HTML. Les formulaires HTML requi�rent
davantage de configuration que les m�thodes d'authentification
alternatives, mais ils peuvent s'av�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 � base
de condens� 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 �tre utilis� 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
<p>Lorsque l'utilisateur a �t� authentifi� avec succ�s, ses
informations de connexion sont stock�s dans une session fournie par
</p>
</div>
<div id="quickview"><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="#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="#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="#authformsitepassphrase">AuthFormSitePassphrase</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
conservation du contenu</a></li>
passe</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
l'authentification</a></li>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="section">
<h2><a name="basicconfig" id="basicconfig">Configuration de base</a></h2>
<p>Pour prot�ger une URL particuli�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�es dans une session � 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 �choue,
l'utilisateur dera redirig� vers la page du formulaire de
connexion.</p>
<div class="example"><h3>Exemple simple</h3><pre class="prettyprint lang-config">AuthFormProvider file
AuthType form
AuthName realm
AuthFormLoginRequiredLocation http://example.com/login.html
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret</pre>
</div>
<p>L'authentification <code class="module"><a href="/mod/mod_auth_form.html">mod_auth_form</a></code> est activ�e
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
<code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> et
sp�cifient que les noms d'utilisateurs et mots de passe seront
v�rifi�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�ent une session chiffr�e stock�e dans un cookie HTTP au niveau
du navigateur. Pour plus d'informations � propos des diff�rentes
options de configuration des sessions, reportez-vous � 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 �t� prot�g�e par
<code class="module"><a href="/mod/mod_auth_form.html">mod_auth_form</a></code>, mais on doit maintenant fournir
� l'utilisateur un moyen d'entrer un nom et un mot de passe. � cet
effet, on peut soit �crire une page de connexion ind�pendante
d�di�e, soit inclure le formulaire de connexion dans la page
courante.</p>
<div class="section">
<h2><a name="standalone" id="standalone">Page de connexion d�di�e</a></h2>
<p>Le formulaire de connexion peut �tre contenu dans une page
ind�pendante, ou �tre inclus dans la page courante. </p>
<p>Lorsque la connexion s'effectue � partir d'une page
ind�pendante et si la tentative d'authentification �choue,
l'utilisateur doit �tre redirig� vers un formulaire de connexion,
cr�� � cet effet sur le site web, en utilisant la directive
<code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>.
En g�n�ral, la page de connexion contiendra un formulaire HTML
demandant � 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"><form method="POST" action="/dologin.html">
Username: <input type="text" name="httpd_username" value="" />
Password: <input type="password" name="httpd_password" value="" />
<input type="submit" name="login" value="Login" />
</form></pre>
</div>
<p>La partie o� s'effectue la connexion proprement dite est
trait�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
SetHandler form-login-handler
AuthFormLoginRequiredLocation http://example.com/login.html
AuthFormLoginSuccessLocation http://example.com/success.html
AuthFormProvider file
AuthType form
AuthName realm
Session On
SessionCookieName session path=/
SessionCryptoPassphrase secret
</Location></pre>
</div>
<p>L'URL sp�cifi�e par la directive
<code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
r�f�rencera en g�n�ral une page expliquant � l'utilisateur que sa
tentative de connexion a �chou�, et qu'il doit la renouveler. La
directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
sp�cifie l'URL vers laquelle l'utilisateur doit �tre redirig� s'il
s'est authentifi� avec succ�s.</p>
<p>Alternativement, l'URL vers laquelle doit �tre redirig�
l'utilisateur s'il s'est authentifi� avec succ�s peut �tre
int�gr�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 �tre utilis� pour diff�rentes
zones du site web.</p>
<div class="example"><h3>Exemple de formulaire d'authentification multizone</h3><pre class="prettyprint lang-html"><form method="POST" action="/dologin.html">
Username: <input type="text" name="httpd_username" value="" />
Password: <input type="password" name="httpd_password" value="" />
<input type="submit" name="login" value="Login" />
<input type="hidden" name="httpd_location" value="http://example.com/success.html" />
</form></pre>
</div>
<div class="section">
<h2><a name="inline" id="inline">Connexion � la vol�e</a></h2>
<div class="warning"><h3>Avertissement</h3>
<p>Il existe un risque, dans certaines circonstances, que le
formulaire de connexion configur� pour une connexion � la vol�e
soit soumis plusieurs fois, r�v�lant de ce fait les param�tres
de connexion � l'application sous-jacente. L'administrateur doit
s'assurer que cette derni�re est correctement s�curis�e afin
d'�viter les �ventuels abus. En cas de doute, utilisez une page
de connexion ind�pendante d�di�e.</p>
</div>
<p>Comme alternative � la page de connexion d�di�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 � la vol�e, sans les rediriger
vers une autre page, ce qui permet de conserver l'�tat de la page
courante au cours de la tentative de connexion. Ceci peut s'av�rer
utile dans le cas d'une session limit�e dans le temps, si le d�lai
de la session a expir� pendant la requ�te de l'utilisateur. Ce
dernier peut alors se r�authentifier � la m�me place, et
poursuivre son activit� � partir du point o� il en �tait rest�.</p>
<p>Si un utilisateur non authentifi� tente d'acc�der � une page
prot�g�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� avec une directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>,
un code de statut <var>HTTP_UNAUTHORIZED</var> est renvoy� vers le
navigateur, indiquant � l'utilisateur qu'il n'est pas autoris� �
acc�der � cette page.</p>
<p>Pour configurer l'authentification � la vol�e, l'administrateur
remplace le message d'erreur renvoy� par le code de statut
<var>HTTP_UNAUTHORIZED</var> par un message d'erreur personnalis�
contenant le formulaire de connexion comme suit :</p>
<div class="example"><h3>Exemple simple d'authentification � la vol�e</h3><pre class="prettyprint lang-config">AuthFormProvider file
ErrorDocument 401 /login.shtml
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�t� action est vide, comme dans l'exemple
ci-dessous. Ceci a pour effet de soumettre le formulaire � l'URL
prot�g�e originale, cette derni�re n'ayant pas besoin d'�tre
connue de la page en cours.</p>
<div class="example"><h3>Exemple de formulaire de connexion � la vol�e</h3><pre class="prettyprint lang-html"><form method="POST" <strong>action=""</strong>>
Username: <input type="text" name="httpd_username" value="" />
Password: <input type="password" name="httpd_password" value="" />
<input type="submit" name="login" value="Login" />
</form></pre>
</div>
<p>Lorsque l'utilisateur final a entr� ses informations de
connexion, le formulaire effectue une requ�te HTTP POST pour l'URL
originale prot�g�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�te
POST, et dans le cas o� des champs HTML Utilisateur et Mot de
passe corrects sont pr�sents, l'utilisateur sera connect�, et
l'URL originale prot�g�e par mot de passe lui sera retourn�e en
tant que requ�te GET.</p>
<div class="section">
<h2><a name="inlinepreservebody" id="inlinepreservebody">Connexion � la vol�e avec
conservation du contenu</a></h2>
<p>Il existe une limite � la technique de connexion � la vol�e
d�crite ci-dessus ; si un formulaire HTML POST entra�ne une
demande d'authentification ou de r�authentification, le contenu du
formulaire original envoy� par le navigateur sera perdu. Cela peut
s'av�rer plus ou moins g�nant pour l'utilisateur final selon la
fonction du site web.</p>
<p>Comme solution � ce probl�me, <code class="module"><a href="/mod/mod_auth_form.html">mod_auth_form</a></code>
permet d'int�grer la m�thode et le contenu de la requ�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'�tat de la requ�te originale.</p>
<p>Pour mettre en oeuvre la conservation du contenu, vous devez
ajouter trois champs suppl�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"><form method="POST" action="">
Username: <input type="text" name="httpd_username" value="" />
Password: <input type="password" name="httpd_password" value="" />
<input type="submit" name="login" value="Login" />
<br /> <strong><input type="hidden" name="httpd_method" value="POST" />
<input type="hidden" name="httpd_mimetype" value="application/x-www-form-urlencoded" />
<input type="hidden" name="httpd_body" value="name1=value1&name2=value2" /></strong><br />
</form></pre>
</div>
<p>La mani�re dont la m�thode, le type MIME et le contenu de la
requ�te originale seront int�gr�s dans le formulaire de connexion
vont d�pendre de la plate-forme et de la technologie utilis�es au
sein du site web.
</p>
<p>Une option consiste � utiliser le module
<code class="module"><a href="/mod/mod_include.html">mod_include</a></code> en association avec la directive
qu'un script CGI adapt� pour int�grer les variables dans le
formulaire.</p>
<p>Une autre option consiste � pr�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
...</pre>
</div>
<div class="section">
<h2><a name="loggingout" id="loggingout">D�connexion</a></h2>
<p>Pour permettre � un utilisateur de se d�connecter d'une session
particuli�re, vous devez configurer une page pour qu'elle soit
trait�e par le gestionnaire <var>form-logout-handler</var>. Tout
acc�s � cette URL va entra�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�cifier une URL vers laquelle le navigateur sera
redirig� 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 � l'utilisateur qu'il a �t� d�connect�, et lui
donner la possibilit� de se connecter � 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�e, mais ce n'est pas garanti. Si vous voulez
�tre s�r que la session sera supprim�e, affectez une valeur faible
� la directive <code class="directive"><a href="/mod/mod_session.html#sessionmaxage">SessionMaxAge</a></code>, par exemple 1
(affecter � cette directive la valeur z�ro signifie une session
sans limite d'�ge).
</p>
<div class="example"><h3>Exemple simple avec dur�e de validit� de session
limit�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 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�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�res susceptibles
d'�tre encod�s URL lors de la soumission du formulaire, sous peine
d'obtenir des r�sultats inattendus.</p>
</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�s �
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>
</table>
<p>Normalement, chacun des modules d'autorisation sp�cifi�s par la
directive <code class="directive"><a href="#authformprovider">AuthFormProvider</a></code> va tenter de
v�rifier l'identit� de l'utilisateur, et si ce dernier n'est trouv�
dans aucun fournisseur, l'acc�s sera refus�. En d�finissant
explicitement la directive
<code class="directive">AuthFormAuthoritative</code> � <code>Off</code> on
confie les processus d'authentification et d'autorisation � des
modules ne s'appuyant pas sur des fournisseurs, si <strong>aucun
identifiant utilisateur</strong> ou aucune <strong>r�gle</strong> ne
correspond � l'identifiant utilisateur fourni. Ceci ne peut s'av�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�e dans leur code source, et n'est pas configurable.</p>
</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�te � 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#Compatibility">Compatibilit�:</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�cifie le nom du champ HTML qui, s'il existe, contiendra le corps
de la requ�te � 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�te qui a �t� �ventuellement interrompue
par l'�cran de connexion, ou par l'expiration d'un d�lai de
session.</p>
</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#Compatibility">Compatibilit�:</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�e, si l'utilisateur n'est pas
encore connect�. 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�ler le nom d'utilisateur et le mot de passe �
l'application sous-jacente. Vous devez �tre conscient des risques
encourus si vous le d�sactivez.</p>
</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#Compatibility">Compatibilit�:</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�e aux en-t�tes de la requ�te. On peut utiliser cette
m�thode pour pr�senter le nom d'utilisateur et le mot de passe �
l'application sous-jacente, sans que cette derni�re ait besoin de
conna�tre la mani�re dont le processus de connexion a �t� men� �
bien.</p>
</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� en cas de connexion
r�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#Compatibility">Compatibilit�:</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�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="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 �tre redirig� 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#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr�tation des expressions rationnelles est support�e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></code>
sp�cifie l'URL vers laquelle l'utilisateur devra �tre
redirig� s'il n'est pas autoris� � acc�der � une page. Sa valeur est
avant d'�tre envoy�e au client. Par d�faut,
si un utilisateur n'est pas autoris� � acc�der � une page, le code
de r�ponse HTTP <code>HTTP_UNAUTHORIZED</code> est renvoy� avec la
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>
permet de remplacer cette valeur par d�faut.</p>
<p>Vous pouvez utiliser cette directive si vous voulez pr�senter une
page de connexion personnalis�e � vos utilisateurs.</p>
</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 �tre redirig� 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#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr�tation des expressions rationnelles est support�e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></code>
sp�cifie l'URL vers laquelle l'utilisateur doit �tre
redirig� en cas de connexion r�ussie. Sa valeur est
avant d'�tre envoy�e au client. L'effet de cette directive
peut �tre annul� si l'on a d�fini un champ de formulaire contenant
une autre URL � l'aide de la directive <code class="directive"><a href="#authformlocation">AuthFormLocation</a></code>.</p>
<p>Vous pouvez utiliser cette directive si vous poss�dez une URL de
connexion personnalis�e, et si vous n'avez pas int�gr� la page de
destination dans le formulaire de connexion.</p>
</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 �tre redirig�
apr�s s'�tre d�connect�</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#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.0 du serveur HTTP
Apache. L'interpr�tation des expressions rationnelles est support�e
depuis la version 2.4.4.</td></tr>
</table>
<p>La directive <code class="directive"><a href="#authformlogoutlocation">AuthFormLogoutLocation</a></code>
sp�cifie l'URL de la page du serveur vers laquelle l'utilisateur
devra �tre redirig� s'il se d�connecte. Sa valeur est
avant d'�tre envoy�e au client.</p>
<p>Lorsqu'un acc�s est tent� sur un URI trait� par le gestionnaire
<code>form-logout-handler</code>, la page sp�cifi�e par cette
directive sera pr�sent�e � l'utilisateur final. Par exemple :</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location /logout>
SetHandler form-logout-handler
AuthFormLogoutLocation http://example.com/loggedout.html
Session on
#...
</Location></pre>
</div>
<p>Si un utilisateur tente d'acc�der � l'URI <var>/logout/</var>, il
pas prot�g�e par mot de passe, car dans le cas contraire, elle ne
serait pas affich�e.</p>
</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�te � 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#Compatibility">Compatibilit�:</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�cifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requ�te � 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�te qui a �t� �ventuellement interrompue
par l'�cran de connexion, ou par l'expiration d'un d�lai de
session.</p>
</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�te � effectuer en cas de connexion
r�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#Compatibility">Compatibilit�:</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�cifie le nom du champ HTML qui, s'il existe, contiendra le type
MIME de la requ�te � 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�te qui a �t� �ventuellement interrompue
par l'�cran de connexion, ou par l'expiration d'un d�lai de
session.</p>
</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#Compatibility">Compatibilit�:</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�cifier le nom du champ HTML qui, s'il existe, contiendra le mot
de passe qui sera utilis� pour la connexion.</p>
</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�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>
</table>
<p>La directive <code class="directive">AuthFormProvider</code> permet de
d�finir quel fournisseur sera utilis� pour authentifier les
utilisateurs pour la zone concern�e. Le fournisseur par d�faut
<code>file</code> est impl�ment� 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�sent dans le serveur.</p>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location /secure>
AuthType form
AuthName "private area"
AuthFormProvider dbm
AuthDBMType SDBM
Require valid-user
#...
</Location></pre>
</div>
<p>Les diff�rents fournisseurs sont impl�ment�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>,
</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 � 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#Compatibility">Compatibilit�:</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�cifie un mot de passe qui, s'il est pr�sent dans la session
utilisateur, indique � Apache httpd de court-circuiter l'authentification
pour l'URL consid�r�e. On peut l'utiliser dans le cas de sites web �
fort trafic afin de r�duire la charge induite sur l'infrastructure
d'authentification.</p>
<p>On peut ins�rer le mot de passe dans une session utilisateur en
ajoutant cette directive � la configuration concernant le
gestionnaire <var>form-login-handler</var>. Le gestionnaire
<var>form-login-handler</var>, quant � lui, effectuera toujours les
v�rifications d'authentification, qu'un mot de passe soit sp�cifi�
ou non.</p>
<div class="warning"><h3>Avertissement</h3>
<p>Si la session est pr�sent�e � l'utilisateur � 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�g�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�e dans un espace d'URLs contenant
des donn�es priv�es, ou � partir desquelles des transactions
sensibles pourraient �tre men�es. En tout �tat de cause, vous
devez �tre conscient des risques encourus avant de l'utiliser.</p>
</div>
</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#Compatibility">Compatibilit�:</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�cifie
la taille maximale du corps de la requ�te qui sera utilis�e pour
trouver le formulaire de connexion.</p>
<p>Si une requ�te de connexion entrante poss�de une taille
sup�rieure � cette valeur, elle sera rejet�e avec le code de r�ponse
HTTP <code>HTTP_REQUEST_TOO_LARGE</code>.</p>
<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�
de d�finir cette directive � une valeur similaire � celle de la
directive <code class="directive"><a href="/mod/mod_request.html#keptbodysize">KeptBodySize</a></code>.</p>
</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#Compatibility">Compatibilit�:</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�cifier le nom du champ HTML qui, s'il existe, contiendra le nom
d'utilisateur qui sera utilis� 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"> en </a> |
</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
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 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>
<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>