]> granicus.if.org Git - apache/blob - docs/manual/mod/mod_auth_basic.html.fr
Update XForms.
[apache] / docs / manual / mod / mod_auth_basic.html.fr
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
5 <!--
6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7               This file is generated from xml source: DO NOT EDIT
8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
9       -->
10 <title>mod_auth_basic - Serveur Apache HTTP Version 2.5</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <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" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
15 </script>
16
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
18 <body>
19 <div id="page-header">
20 <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>
21 <p class="apache">Serveur Apache HTTP Version 2.5</p>
22 <img alt="" src="../images/feather.gif" /></div>
23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
24 <div id="path">
25 <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>
26 <div id="page-content">
27 <div id="preamble"><h1>Module Apache mod_auth_basic</h1>
28 <div class="toplang">
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
30 <a href="../fr/mod/mod_auth_basic.html" title="Français">&nbsp;fr&nbsp;</a> |
31 <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
32 <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
33 </div>
34 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Authentification HTTP de base</td></tr>
35 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
36 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>auth_basic_module</td></tr>
37 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_basic.c</td></tr></table>
38 <h3>Sommaire</h3>
39
40     <p>Ce module permet d'utiliser l'authentification basique HTTP pour
41     restreindre l'accès en recherchant les utilisateurs dans les
42     fournisseurs d'authentification spécifiés. Il est en général
43     combiné avec au moins un module d'authentification comme
44     <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> et un module d'autorisation comme
45     <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>. L'authentification HTTP à
46     base de condensé (digest), quant à elle, est fournie par le module
47     <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. </p>
48 </div>
49 <div id="quickview"><h3 class="directives">Directives</h3>
50 <ul id="toc">
51 <li><img alt="" src="../images/down.gif" /> <a href="#authbasicauthoritative">AuthBasicAuthoritative</a></li>
52 <li><img alt="" src="../images/down.gif" /> <a href="#authbasicfake">AuthBasicFake</a></li>
53 <li><img alt="" src="../images/down.gif" /> <a href="#authbasicprovider">AuthBasicProvider</a></li>
54 <li><img alt="" src="../images/down.gif" /> <a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></li>
55 </ul>
56 <h3>Voir aussi</h3>
57 <ul class="seealso">
58 <li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li>
59 <li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li>
60 <li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li>
61 <li><a href="../howto/auth.html">Mode d'emploi de
62 l'authentification</a></li>
63 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
64
65 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
66 <div class="directive-section"><h2><a name="authbasicauthoritative" id="authbasicauthoritative">Directive</a> <a name="AuthBasicAuthoritative" id="AuthBasicAuthoritative">AuthBasicAuthoritative</a></h2>
67 <table class="directive">
68 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si les processus d'autorisation et
69 d'authentification peuvent être confiés à des modules de plus bas
70 niveau</td></tr>
71 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicAuthoritative On|Off</code></td></tr>
72 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicAuthoritative On</code></td></tr>
73 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
74 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
75 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
76 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
77 </table>
78     <p>Normalement, chaque module d'autorisation énuméré dans la
79     directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> va tenter de
80     vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des
81     fournisseurs, l'accès sera refusé. Définir explicitement la
82     directive <code class="directive">AuthBasicAuthoritative</code> à
83     <code>Off</code> permet de confier l'autorisation et
84     l'authentification à d'autres modules non basés sur les fournisseurs
85     si <strong>aucun identifiant utilisateur</strong> ou aucune
86     <strong>règle</strong> ne correspondent à l'identifiant utilisateur
87     spécifié. Ceci ne peut s'avérer nécessaire que lorsque
88     <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> est combiné avec des modules tiers
89     qui n'ont pas été configurés à l'aide de la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>. Lorsqu'on
90     utilise de tels modules, l'ordre dans lequel s'effectue le
91     traitement est défini dans le code source des modules et n'est pas
92     configurable.</p>
93
94 </div>
95 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
96 <div class="directive-section"><h2><a name="authbasicfake" id="authbasicfake">Directive</a> <a name="AuthBasicFake" id="AuthBasicFake">AuthBasicFake</a></h2>
97 <table class="directive">
98 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Authentification de base simulée à l'aide des nom
99 d'utilisateur et mot de passe fournis</td></tr>
100 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicFake off|nom-utilisateur [mot-de-passe]</code></td></tr>
101 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>none</code></td></tr>
102 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
103 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
104 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
105 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
106 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
107 Apache</td></tr>
108 </table>
109     <p>Les nom d'utilisateur et mot de passe spécifiés sont rassemblés
110     dans un en-tête d'autorisation qui est transmis au serveur ou au
111     service sous-jacent au serveur. Ces nom d'utilisateur et mot de
112     passe sont interprétés par l'<a href="../expr.html">interpréteur
113     d'expression</a>, ce qui permet de les définir en fonction de
114     paramètres de la requête.</p>
115
116     <p>Si aucun mot de passe n'est spécifié, la valeur par défaut
117     "password" sera utilisée. Pour désactiver l'authentification de base
118     simulée pour un espace d'URL, définissez AuthBasicFake à "off".</p>
119
120     <p>Dans l'exemple suivant, un nom d'utilisateur et un mot de passe
121     prédéfinis sont transmis à un serveur d'arrière-plan :</p>
122
123     <div class="example"><h3>Exemple de transmission d'un nom d'utilisateur et
124     d'un mot de passe prédéfinis</h3><pre class="prettyprint lang-config">&lt;Location "/demo"&gt;
125     AuthBasicFake demo demopass
126 &lt;/Location&gt;</pre>
127 </div>
128
129     <p>Dans l'exemple suivant, l'adresse email extraite d'un certificat
130     client est transmise au serveur, étendant par là-même la
131     fonctionnalité de l'option FakeBasicAuth de la directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code>. Comme avec l'option
132     FakeBasicAuth, le mot de passe se voit attribué le contenu fixe de
133     la chaîne "password".</p>
134
135     <div class="example"><h3>Exemple d'utilisation avec un certificat</h3><pre class="prettyprint lang-config">&lt;Location "/secure"&gt;
136     AuthBasicFake "%{SSL_CLIENT_S_DN_Email}"
137 &lt;/Location&gt;</pre>
138 </div>
139
140     <p>Pour compléter l'exemple précédent, il est possible de générer la
141     valeur du mot de passe en procédant à un hashage de l'adresse email
142     à partir d'un mot d'une passphrase initial fixée, puis de transmettre le
143     résultat obtenu au serveur d'arrière-plan. Ceci peut s'avérer utile
144     pour donner accès à des serveurs anciens qui ne supportent pas les
145     certificats clients.</p>
146
147     <div class="example"><h3>Exemple de génération de mot de passe par hashage de
148     l'adresse email</h3><pre class="prettyprint lang-config">&lt;Location "/secure"&gt;
149     AuthBasicFake "%{SSL_CLIENT_S_DN_Email}" "%{sha1:passphrase-%{SSL_CLIENT_S_DN_Email}}"
150 &lt;/Location&gt;</pre>
151 </div>
152
153     <div class="example"><h3>Désactivation de l'authentification simulée</h3><pre class="prettyprint lang-config">&lt;Location "/public"&gt;
154     AuthBasicFake off
155 &lt;/Location&gt;</pre>
156 </div>
157
158
159 </div>
160 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
161 <div class="directive-section"><h2><a name="authbasicprovider" id="authbasicprovider">Directive</a> <a name="AuthBasicProvider" id="AuthBasicProvider">AuthBasicProvider</a></h2>
162 <table class="directive">
163 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(les) fournisseur(s) d'authentification pour
164 cette zone du site web</td></tr>
165 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>nom fournisseur</var>
166 [<var>nom fournisseur</var>] ...</code></td></tr>
167 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicProvider file</code></td></tr>
168 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
169 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
170 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
171 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
172 </table>
173     <p>La directive <code class="directive">AuthBasicProvider</code> permet de
174     définir le fournisseur utilisé pour authentifier les utilisateurs
175     pour la zone du site web concernée. Le fournisseur par défaut
176     <code>file</code> est implémenté par le module
177     <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le module
178     implémentant le fournisseur choisi soit bien présent dans le
179     serveur.</p>
180
181     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">&lt;Location "/secure"&gt;
182     AuthType basic
183     AuthName "private area"
184     AuthBasicProvider  dbm
185     AuthDBMType        SDBM
186     AuthDBMUserFile    "/www/etc/dbmpasswd"
187     Require            valid-user
188 &lt;/Location&gt;</pre>
189 </div>
190     <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un
191     d'entre eux trouve une correspondance pour le nom d'utilisateur de
192     la requête ; alors, ce dernier fournisseur sera le seul à vérifier
193     le mot de passe. Un échec dans la vérification du mot de passe
194     n'entraîne pas le passage du contrôle au fournisseur suivant.</p>
195
196     <p>Les différents fournisseurs disponibles sont implémentés par les
197     modules <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>,
198     <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>,
199     <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> et <code class="module"><a href="../mod/mod_authn_socache.html">mod_authn_socache</a></code>.</p>
200
201 </div>
202 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
203 <div class="directive-section"><h2><a name="authbasicusedigestalgorithm" id="authbasicusedigestalgorithm">Directive</a> <a name="AuthBasicUseDigestAlgorithm" id="AuthBasicUseDigestAlgorithm">AuthBasicUseDigestAlgorithm</a></h2>
204 <table class="directive">
205 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie les mots de passe auprès des fournisseurs
206 d'authentification à la manière de l'authentification de type Digest.
207 </td></tr>
208 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicUseDigestAlgorithm MD5|Off</code></td></tr>
209 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicUseDigestAlgorithm Off</code></td></tr>
210 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr>
211 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</td></tr>
212 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
213 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_auth_basic</td></tr>
214 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.7 du serveur HTTP
215 Apache</td></tr>
216 </table>
217     <p>Normalement, lorsqu'on utilise l'authentification basique, les
218     fournisseurs spécifiés via la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> tentent de
219     contrôler l'identité d'un utilisateur en recherchant dans leurs
220     bases de données l'existence d'un couple utilisateur/mot de passe
221     correspondant. Les mots de passe enregistrés sont en général
222     chiffrés, mais ce n'est pas systématique ; chaque fournisseur peut
223     choisir son propre mode de stockage des mots de passe.</p>
224
225     <p>Lorsqu'on utilise l'authentification de type Digest, les
226     fournisseurs spécifiés par la directive <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> effectuent
227     une recherche similaire dans leurs bases de
228     données pour trouver un couple utilisateur/mot de passe
229     correspondant. Cependant, à la différence de l'authentification
230     basique, les données associées à chaque utilisateur et comportant le
231     nom d'utilisateur, le domaine de protection (realm) et le mot de
232     passe doivent être contenues dans une chaîne chiffrée (Voir le
233     document <a href="http://tools.ietf.org/html/rfc2617#section-3.2.2.2">RFC 2617,
234     Section 3.2.2.2</a> pour plus de détails à propos du type de
235     chiffrement utilisé pour cette chaîne).</p>
236
237     <p>A cause de la différence entre les méthodes de stockage des
238     données des authentifications de type basique et digest, le passage
239     d'une méthode d'authentification de type digest à une méthode
240     d'authentification de type basique requiert l'attribution de
241     nouveaux
242     mots de passe à chaque utilisateur, car leur mots de passe existant
243     ne peut pas être extrait à partir du schéma de stockage utilisé
244     par les fournisseurs d'authentification de type digest.</p>
245
246     <p>Si la directive <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code> est
247     définie à la valeur <code>MD5</code>, le mot de passe d'un
248     utilisateur dans le cas de l'authentification basique sera vérifié
249     en utilisant le même format de chiffrement que dans le cas de
250     l'authentification de type digest. Tout d'abord, une chaîne
251     comportant le nom d'utilisateur, le domaine de protection (realm) et
252     le mot de passe est générée sous forme de condensé (hash) en
253     utilisant l'algorithme MD5 ; puis le nom d'utilisateur et cette
254     chaîne chiffrée sont transmis aux fournisseurs spécifiés via la
255     directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> comme si la
256     directive <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code>
257     était définie à <code>Digest</code> et si l'authentification de type
258     Digest était utilisée.
259     </p>
260
261     <p>Grâce à cette directive, un site peut basculer d'une
262     authentification de type digest à basique sans devoir changer les
263     mots de passe des utilisateurs. </p>
264
265     <div class="note">
266       Le processus inverse consistant à passer d'une authentification de
267       type basique à digest sans changer les mots de passe n'est en
268       général pas possible. Les mots de passe enregistrés dans le cas
269       d'une authentification de type basique ne pourront être extraits
270       et chiffrés à nouveau selon le schéma de l'authentification de
271       type digest, que s'ils ont été stockés en clair ou selon un schéma de
272       chiffrement réversible.
273     </div>
274
275     <div class="note">
276       Seuls les fournisseurs qui supportent l'authentification de type
277       digest pourront authentifier les utilisateurs lorsque la directive
278       <code class="directive"><a href="#authbasicusedigestalgorithm">AuthBasicUseDigestAlgorithm</a></code>
279       est définie à <code>MD5</code>. L'utilisation d'un autre
280       fournisseur provoquera un message d'erreur et le client se verra
281       refuser l'accès.</div>
282
283 </div>
284 </div>
285 <div class="bottomlang">
286 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
287 <a href="../fr/mod/mod_auth_basic.html" title="Français">&nbsp;fr&nbsp;</a> |
288 <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
289 <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
290 </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>
291 <script type="text/javascript"><!--//--><![CDATA[//><!--
292 var comments_shortname = 'httpd';
293 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_auth_basic.html';
294 (function(w, d) {
295     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
296         d.write('<div id="comments_thread"><\/div>');
297         var s = d.createElement('script');
298         s.type = 'text/javascript';
299         s.async = true;
300         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
301         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
302     }
303     else {
304         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
305     }
306 })(window, document);
307 //--><!]]></script></div><div id="footer">
308 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
309 <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[//><!--
310 if (typeof(prettyPrint) !== 'undefined') {
311     prettyPrint();
312 }
313 //--><!]]></script>
314 </body></html>