<?xml version="1.0" encoding="ISO-8859-1" ?>
<!-- English Revision : 1420686 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="password_encryptions.xml.meta">
<parentdocument href="./">Documentations diverses</parentdocument>
<title>Formats de mots de passe</title>
<summary>
<p>Notes à propos des formats de chiffrement des mots de passe
générés et reconnus par Apache.</p>
</summary>
<section id="basic"><title>Authentification de base</title>
<p>Voici les cinq formats de mots de passe qu'Apache reconnaît
pour l'authentification de base. Notez que tous les formats ne sont
pas supportés par toutes les plates-formes :</p>
<dl>
<dt>bcrypt</dt>
<dd>"$2y$" + résultat de l'algorithme de chiffrement crypt_blowfish. Voir le fichier
source APR <a
href="http://svn.apache.org/viewvc/apr/apr/trunk/crypto/crypt_blowfish.c?view=markup">crypt_blowfish.c</a>
pour plus de détails à propos de cet algorithme.</dd>
<dt>MD5</dt>
<dd>"$apr1$" + le résultat d'un algorithme spécifique à Apache
utilisant un condensé MD5 réitéré (1000 fois) de combinaisons
variées du mot de passe et d'une source d'entropie sur 32 bits.
Voir le fichier source APR <a
pour les détails de l'algorithme.</dd>
<dt>SHA1</dt>
<dd>"{SHA}" + un condensé SHA-1 du mot de passe codé en
Base64. Non sécurisé.</dd>
<dt>CRYPT</dt>
<dd>Unix seulement. Utilise la fonction Unix traditionnelle
<code>crypt(3)</code> avec une source d'entropie sur 32 bits
(seuls 12 bits sont utilisés), et seulement les 8 premiers
caractères du mot de passe. Non sécurisé.</dd>
<dt>PLAIN TEXT (autrement dit <em>non chiffré</em>)</dt>
<dd>Windows & Netware seulement. Non sécurisé.</dd>
</dl>
<section><title>Générer des mots de passe avec htpasswd</title>
<example><title>bcrypt</title>
$ htpasswd -nbB monNom Mon-Mot-de-passe<br />
monNom:$2y$05$c4WoMPo3SXsafkva.HHa6uXQZWr7oboPiC2bT/r7q1BB8I2s0BRqC
</example>
<example><title>MD5</title>
$ htpasswd -nbm monNom Mon-Mot-de-passe<br />
monNom:$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
</example>
<example><title>SHA1</title>
$ htpasswd -nbs monNom Mon-Mot-de-passe<br />
monNom:{SHA}VBPuJHI7uixaa6LQGWx4s+5GKNE=
</example>
<example><title>CRYPT</title>
$ htpasswd -nbd monNom Mon-Mot-de-passe<br />
monNom:rqXexS6ZhobKA
</example>
</section>
<section>
<title>Générer des mots de passe CRYPT et MD5 avec le programme
OpenSSL en ligne de commande</title>
<p>OpenSSL connaît l'algorithme MD5 spécifique à Apache.</p>
<example><title>MD5</title>
$ openssl passwd -apr1 Mon-Mot-de-passe<br />
$apr1$qHDFfhPC$nITSVHgYbDAK1Y0acGRnY0
</example>
<example><title>CRYPT</title>
openssl passwd -crypt Mon-Mot-de-passe<br />
qQ5vTYO3c8dsU
</example>
</section>
<section>
<title>Valider des mots de passe CRYPT et MD5 avec le programme
OpenSSL en ligne de commande</title>
<p>La source d'entropie pour un mot de passe CRYPT est constituée
des deux premiers caractères (convertis en valeur binaire). Pour
valider <code>Mon-Mot-de-passe</code> par rapport à
<code>rqXexS6ZhobKA</code></p>
<example><title>CRYPT</title>
$ openssl passwd -crypt -salt rq Mon-Mot-de-passe<br />
Warning: truncating password to 8 characters<br />
rqXexS6ZhobKA
</example>
<p>Notez que spécifier <code>Mon-Mot-</code> au lieu de
<code>Mon-Mot-de-passe</code> produira le même résultat car seuls
les 8 premiers caractères des mots de passe CRYPT sont pris en
compte.</p>
<p>La source d'entropie pour un mot de passe MD5 se situe entre
<code>$apr1$</code> et le caractère <code>$</code> suivant (sous
la forme d'une valeur binaire codée en Base64 - au maximum 8
caractères). Pour valider <code>Mon-Mot-de-passe</code> par rapport
à <code>$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/</code></p>
<example><title>MD5</title>
$ openssl passwd -apr1 -salt r31..... Mon-Mot-de-passe<br />
$apr1$r31.....$HqJZimcKQFAMYayBlzkrA/
</example>
</section>
<section><title>Champs mot de passe de base de données pour
mod_dbd</title>
<p>La variante SHA1 constitue probablement le format le mieux
approprié pour l'authentification DBD. Comme les fonctions SHA1 et
Base64 sont en général disponibles, d'autres logiciels peuvent
renseigner une base de données avec des mots de passe chiffrés
utilisables par l'authentification basique d'Apache.</p>
<p>Pour créer des mots de passe au format SHA1 pour
l'authentification de base d'Apache dans divers langages :</p>
<example><title>PHP</title>
'{SHA}' . base64_encode(sha1($password, TRUE))
</example>
<example><title>Java</title>
"{SHA}" + new sun.misc.BASE64Encoder().encode(java.security.MessageDigest.getInstance("SHA1").digest(password.getBytes()))
</example>
<example><title>ColdFusion</title>
"{SHA}" & ToBase64(BinaryDecode(Hash(password, "SHA1"), "Hex"))
</example>
<example><title>Ruby</title>
require 'base64'<br />
'{SHA}' + Base64.encode64(Digest::SHA1.digest(password))
</example>
<example><title>C ou C++</title>
Utilisez la fonction APR : apr_sha1_base64
</example>
<example>
installées)</title>
'{SHA}'||encode(digest(password,'sha1'),'base64')
</example>
</section>
</section>
<section id="digest"><title>Authentification à base de condensés - (digest)</title>
<p>Apache ne reconnaît qu'un format pour les mots de passe
d'authentification à base de condensés - le condensé MD5 de la
chaîne <code>utilisateur:domaine-de-protection:mot-de-passe</code>
sous la forme d'une chaîne de 32 caractères au format hexadécimal.
<code>domaine-de-protection</code> est l'identifiant du domaine de
protection de l'autorisation passé en argument à la directive
<directive module="mod_authn_core">AuthName</directive> dans
httpd.conf.</p>
<section><title>Champs de mot de passe de base de données pour
mod_dbd</title>
<p>Comme la fonction MD5 est en général disponible, d'autres
logiciels peuvent renseigner une base de données avec des mots de
passe chiffrés utilisables par l'authentification à base de
condensés d'Apache.</p>
<p>Pour créer des mots de passe pour l'authentification à base de
condensés d'Apache dans divers langages :</p>
<example><title>PHP</title>
md5($user . ':' . $realm . ':' .$password)
</example>
<example><title>Java</title>
byte b[] = java.security.MessageDigest.getInstance("MD5").digest( (user + ":" + realm + ":" + password ).getBytes());<br />
String s = bi.toString(16);<br />
while (s.length() < 32)<br />
<indent>
s = "0" + s;
</indent>
// La chaîne s contient le mot de passe chiffré
</example>
<example><title>ColdFusion</title>
LCase(Hash( (user & ":" & realm & ":" & password) , "MD5"))
</example>
<example><title>Ruby</title>
Digest::MD5.hexdigest(user + ':' + realm + ':' + password)
</example>
<example>
installées)</title>
encode(digest( user || ':' || realm || ':' || password , 'md5'), 'hex')
</example>
</section>
</section>
</manualpage>