Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
<?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>htpasswd - Gestion des fichiers d'utilisateurs pour
l'authentification de base - Serveur Apache HTTP Version 2.4</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 id="manual-page"><div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.4</p>
<img alt="" src="../images/feather.png" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<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.4</a> > <a href="./">Programmes</a></div><div id="page-content"><div id="preamble"><h1>htpasswd - Gestion des fichiers d'utilisateurs pour
l'authentification de base</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" title="Franais"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Trke"> tr </a></p>
</div>
<p><code>htpasswd</code> permet de crer et de maintenir les
fichiers textes o sont stocks les noms d'utilisateurs et mots de
passe pour l'authentification de base des utilisateurs HTTP. Si
<code>htpasswd</code> rencontre un problme d'accs un fichier,
que ce soit pour crire dans le fichier de sortie, ou pour lire le
fichier d'entre dans le but de le mettre jour, il renvoie un code
d'erreur et n'effectue aucune modification.</p>
<p>Il est possible de limiter l'accs aux ressources du serveur HTTP
Apache aux seuls utilisateurs prsents dans les fichiers crs par
<code>htpasswd</code>. Ce programme ne sait grer les noms
d'utilisateurs et mots de passe que s'ils sont stocks dans des
fichiers textes. Il peut cependant chiffrer et afficher les mots de
passe des fins d'utilisation dans d'autres types de bases de
donnes. Pour utiliser une base de donnes DBM, voir le programme
<code class="program"><a href="../programs/dbmmanage.html">dbmmanage</a></code> ou <code class="program"><a href="../programs/htdbm.html">htdbm</a></code>.</p>
<p><code>htpasswd</code> chiffre les mots de passe en utilisant soit
bcrypt,
une version de MD5 modifie pour Apache, soit SHA1, soit la routine
<code>crypt()</code> du systme. Les fichiers grs par
<code>htpasswd</code> peuvent contenir deux types de mots de passe ;
certaines entres peuvent contenir des mots de passe chiffrs en
MD5 ou bcrypt, alors que d'autres entres du mme fichier contiendront des
mots de passe chiffrs avec <code>crypt()</code>.</p>
<p>Cette page de manuel ne dcrit que les arguments de la ligne de
commande. Pour plus de dtails propos des directives ncessaires
la configuration de l'authentification des utilisateurs dans
<code class="program"><a href="../programs/httpd.html">httpd</a></code>, voir le manuel Apache qui est fourni avec
la distribution ou peut tre consult <a href="http://httpd.apache.org">http://httpd.apache.org/</a>.</p>
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Syntaxe</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#exit">Valeur renvoye</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#security">Considrations propos de scurit</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#restrictions">Restrictions</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="program"><a href="../programs/httpd.html">httpd</a></code></li><li><code class="program"><a href="../programs/htdbm.html">htdbm</a></code></li><li>Les scripts fournis avec la distibution d'Apache et situs dans
support/SHA1.</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="synopsis" id="synopsis">Syntaxe</a></h2>
<p><code><strong>htpasswd</strong>
[ -<strong>c</strong> ]
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>b</strong>
[ -<strong>c</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ]
[ -<strong>D</strong> ]
[ -<strong>v</strong> ] <var>fichier-mots-de-passe</var> <var>nom-utilisateur</var>
<var>mot-de-passe</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>n</strong>
[ -<strong>i</strong> ]
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ] <var>nom-utilisateur</var></code></p>
<p><code><strong>htpasswd</strong> -<strong>nb</strong>
[ -<strong>m</strong> |
-<strong>B</strong> |
-<strong>d</strong> |
-<strong>s</strong> |
-<strong>p</strong> ]
[ -<strong>C</strong> <var>cost</var> ] <var>nom-utilisateur</var>
<var>mot-de-passe</var></code></p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="options" id="options">Options</a></h2>
<dl>
<dt><code>-b</code></dt>
<dd>Utilise le mode batch ; c'est dire, extrait le mot de passe de
la ligne de commande au lieu de le demander l'oprateur. Cette
option doit tre utilise avec la plus grande prudence, car
<strong>le mot de passe est visible en clair</strong> dans la ligne
de commande. Pour utiliser un script, voir l'option
<code>-i</code>.
Disponible partir de la version 2.4.4 du serveur HTTP Apache.</dd>
<dt><code>-i</code></dt>
<dd>Lit le mot de passe depuis stdin sans vrification ( utiliser
dans les scripts).</dd>
<dt><code>-c</code></dt>
<dd>Cre le <var>fichier-mots-de-passe</var>. Si
<var>fichier-mots-de-passe</var> existe dj, il est rcrit et
tronqu. Cette option ne peut pas tre combine avec l'option
<code>-n</code>.</dd>
<dt><code>-n</code></dt>
<dd>Affiche le rsultat du traitement sur la sortie standard au lieu
de mettre jour le fichier. Ceci peut s'avrer utile pour gnrer
des enregistrements de mots de passe qu'Apache pourra utiliser des
fins d'inclusion dans des fichiers de donnes au format autre que
texte. Cette option modifie la syntaxe de la ligne de commande, car
l'argument <var>fichier-mots-de-passe</var> (en gnral le premier)
est omis. Elle ne peut pas tre combine avec l'option
<code>-c</code> option.</dd>
<dt><code>-m</code></dt>
<dd>Utilise le chiffrement MD5 pour les mots de passe. C'est le
comportement par dfaut (depuis la version 2.2.18).</dd>
<dt><code>-B</code></dt>
<dd>Utilise bcrypt pour chiffrer les mots de passe. c'est un
algorythme de chiffrement actuellement considr comme sr.</dd>
<dt><code>-C</code></dt>
<dd>Ce drapeau n'est autoris qu'en conjonction avec le drapeau
<code>-B</code> (chiffrement bcrypt). Il permet de dfinir la dure
de traitement pour l'algorytme bcrypt (plus elle est longue,
meilleure sera la scurit, mais infrieure la rapidit). La valeur
par dfaut est 5 et les valeurs autorises vont de 4 31.</dd>
<dt><code>-d</code></dt>
<dd>Utilise le chiffrement <code>crypt()</code> pour les mots de
passe. Cette option n'est pas supporte par le
serveur <code class="program"><a href="../programs/httpd.html">httpd</a></code> sous Windows ou Netware. Cet
algorithme limite la longueur des mots de passe 8 caractres ; il
est considr comme <strong>non sur</strong> du point de vue des
standards actuels. C'tait l'algorithme par dfaut jusqu' la
version 2.2.17.</dd>
<dt><code>-s</code></dt>
<dd>Utilise le chiffrement SHA pour les mots de passe. Facilite la
migration vers/depuis les serveurs Netscape qui utilisent le format
LDAP Directory Interchange (ldif). Cet algorithme
est considr comme <strong>non sur</strong> du point de vue des
standards actuels.</dd>
<dt><code>-p</code></dt>
<dd>Enregistre les mots de passe en clair. Bien que
<code>htpasswd</code> supporte la cration des mots de passe en
clair sur toutes les plates-formes, le dmon
<code class="program"><a href="../programs/httpd.html">httpd</a></code> n'accepte les mots de passe en clair que
sous Windows et Netware.</dd>
<dt><code>-D</code></dt>
<dd>Supprime un utilisateur, sous rserve qu'il existe dans le
fichier spcifi par htpasswd.</dd>
<dt><code>-v</code></dt>
<dd>Vrifie si le mot de passe fourni correspond au mot de passe de
l'utilisateur enregistr dans le fichier de mots de passe spcifi.
Disponible partir de la version 2.4.5 du serveur HTTP Apache.</dd>
<dt><code><var>fichier-mots-de-passe</var></code></dt>
<dd>Le nom du fichier contenant les noms d'utilisateurs et mots de
passe. Avec l'option <code>-c</code>, le fichier est cr s'il
n'existe pas, ou rcrit et tronqu s'il existe dj.</dd>
<dt><code><var>nom-utilisateur</var></code></dt>
<dd>Le nom d'utilisateur crer ou mettre jour dans le
<var>fichier-mots-de-passe</var>. Si <var>nom-utilisateur</var>
n'existe pas, une nouvelle entre est ajoute. Dans le cas
contraire, le mot de passe est modifi.</dd>
<dt><code><var>mot-de-passe</var></code></dt>
<dd>Le mot de passe en clair et destin tre chiffr puis stock
dans le fichier. Cet argument ne s'utilise qu'avec l'option
<code>-b</code>.</dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="exit" id="exit">Valeur renvoye</a></h2>
<p><code>htpasswd</code> renvoie 0 ("true") si le nom d'utilisateur
et le mot de passe ont t enregistrs ou mis jour avec succs
dans le <var>fichier-mots-de-passe</var>. <code>htpasswd</code>
renvoie <code>1</code> s'il a rencontr un problme d'accs aux
fichiers, <code>2</code> si la ligne de commande comportait une
erreur de syntaxe, <code>3</code> si le mot de passe entr
interactivement ne correspondait pas au nom d'utilisateur,
<code>4</code> si l'opration a t interrompue, <code>5</code> si
une valeur tait trop longue (nom-utilisateur, nom-fichier,
mot-de-passe, ou l'enregistrement rsultant), <code>6</code> si le
nom d'utilisateur contenait des caractres illgaux (voir la section
<a href="#restrictions">Restrictions</a>), et <code>7</code> si le
fichier spcifi n'tait pas un fichier de mots de passe
valide.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">Exemples</a></h2>
<div class="example"><p><code>
htpasswd /usr/local/etc/apache/.utilisateurs-htpasswd jsmith
</code></p></div>
<p>Ajoute ou modifie le mot de passe de l'utilisateur
<code>jsmith</code>. Le mot de passe est demand l'oprateur. Le
mot de passe sera chiffr en utilisant l'algorithme MD5
modifi pour Apache. Si le fichier spcifi
n'existe pas, <code>htpasswd</code> renverra un code d'erreur.</p>
<div class="example"><p><code>
htpasswd -c /home/doe/public_html/.htpasswd jane
</code></p></div>
<p>Cre un nouveau fichier de mots de passe et y enregistre une
entre pour l'utilisateur <code>jane</code>. Le mot de passe est
demand l'oprateur. Si le fichier existe et ne peut tre ni lu ni
crit, il n'est pas modifi et <code>htpasswd</code> affichera un
message et renverra un code d'erreur.</p>
<div class="example"><p><code>
htpasswd -db /usr/web/.htpasswd-tous jones Pwd4Steve
</code></p></div>
<p>Chiffre le mot de passe spcifi dans la ligne de commande
(<code>Pwd4Steve</code>) en utilisant l'algorithme
<code>crypt()</code>, et le stocke dans le fichier spcifi.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="security" id="security">Considrations propos de scurit</a></h2>
<p>Les fichiers de mots de passe Web comme ceux que gre
<code>htpasswd</code> ne doivent <em>pas</em> tre situs dans
l'espace d'URI du serveur Web -- en d'autres termes, il ne doit pas
tre possible d'y accder partir d'un navigateur.</p>
<p>En tant qu'excutable setuid, ce programme n'est pas sr, et il
ne faut par consquent <em>pas</em> lui attribuer de permissions
setuid.</p>
<p>L'utilisation de l'option <code>-b</code> est dconseille, car
avec elle, les mots de passe apparaissent en clair dans la ligne de
commande.</p>
<p>Notez qu'avec l'algorithme <code>crypt()</code>, seuls les huit
premiers caractres du mot de passe spcifi sont pris en compte. Si
le mot de passe spcifi est plus long, les caractres
supplmentaires sont ignors.</p>
<p>Le format de chiffrement SHA n'utilise pas d'amorage alatoire
(salting) : un mot de passe donn correspond une seule
reprsentation chiffre. Les formats <code>crypt()</code> et MD5
permutent la reprsentation en la prfixant par une chane d'amorce
alatoire, afin de rendre les attaques de mots de passe base de
dictionnaires plus difficiles.</p>
<p>Les algorithmes de chiffrement SHA et <code>crypt()</code>
sont considrs comme <strong>non surs</strong> du point de vue des
standards actuels.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="restrictions" id="restrictions">Restrictions</a></h2>
<p>Sur les plates-formes Windows, la taille des mots de passe
chiffrs avec <code>htpasswd</code> est limite <code>255</code>
caractres. Les mots de passe dont la taille est suprieure seront
tronqus.</p>
<p>L'algorithme MD5 utilis par <code>htpasswd</code> est spcifique
Apache ; les mots de passe chiffrs en utilisant cet algorithme
seront inutilisables sur d'autres serveurs Web.</p>
<p>La taille des noms d'utilisateurs est limite <code>255</code>
octets et ceux-ci ne doivent pas contenir de caractre
<code>:</code>.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/programs/htpasswd.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/programs/htpasswd.html" title="Franais"> fr </a> |
<a href="../ko/programs/htpasswd.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
<a href="../tr/programs/htpasswd.html" hreflang="tr" rel="alternate" title="Trke"> tr </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&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/2.4/programs/htpasswd.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 2017 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/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>