| <?xml version="1.0" encoding="ISO-8859-1" ?> |
| <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision: 1721975 --> |
| <!-- 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 |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| 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 |
| href="http://svn.apache.org/viewvc/apr/apr/trunk/crypto/apr_md5.c?view=markup">apr_md5.c</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 'digest/sha1'<br /> |
| 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><title>Python</title> |
| import base64<br /> |
| import hashlib<br /> |
| "{SHA}" + format(base64.b64encode(hashlib.sha1(password).digest())) |
| </example> |
| |
| <example> |
| <title>PostgreSQL (avec les fonctions contrib/pgcrypto |
| 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 /> |
| java.math.BigInteger bi = new java.math.BigInteger(1, b);<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> |
| require 'digest/md5'<br /> |
| Digest::MD5.hexdigest(user + ':' + realm + ':' + password) |
| </example> |
| |
| <example> |
| <title>PostgreSQL (avec les fonctions contrib/pgcrypto |
| installées)</title> |
| encode(digest( user || ':' || realm || ':' || password , 'md5'), 'hex') |
| </example> |
| |
| </section> |
| </section> |
| |
| </manualpage> |