Salage de mot de passe : Différence entre versions

Attention : vous consultez actuellement la documentation dédiée aux versions 1.x de Moodle. La documentation pour les versions 2.x de Moodle est consultable ici : Salage de mot de passe et celle pour Moodle 3.x est consultable là : Salage de mot de passe.

 
(12 révisions intermédiaires par 3 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{En cours de traduction}}
 
 
==Qu'est-ce que le salage de mot de passe ?==
 
==Qu'est-ce que le salage de mot de passe ?==
  
 
Dans la base de données de Moodle, les mots de passe sont stockés sous forme cryptée, que l'on appelle '[http://fr.wikipedia.org/wiki/MD5 empreinte md5] du mot de passe'.
 
Dans la base de données de Moodle, les mots de passe sont stockés sous forme cryptée, que l'on appelle '[http://fr.wikipedia.org/wiki/MD5 empreinte md5] du mot de passe'.
  
Le [http://fr.wikipedia.org/wiki/Salage_%28cryptographie%29 salage de mot de passe] est une méthode de rendre l'empreinte des mots de passe plus sûre en ajoutant aux mots de passe une chaîne de caractères aléatoires avant de calculer leur empreinte md5, ce qui rend beaucoup plus complexe l'opération de retrouver le mot de passe à partir de son empreinte. Plus la chaîne aléatoire est longue, et plus cette opération est rendue complexe.
+
Le [http://fr.wikipedia.org/wiki/Salage_%28cryptographie%29 salage de mot de passe] est une méthode pour rendre l'empreinte des mots de passe plus sûre en ajoutant aux mots de passe une chaîne de caractères aléatoires avant de calculer leur empreinte md5, ce qui rend beaucoup plus complexe l'opération de retrouver le mot de passe à partir de son empreinte. Plus la chaîne aléatoire est longue, et plus cette opération est rendue complexe.
 +
 
 +
Cette fonctionnalité existe dans toutes les versions de Moodle depuis Moodle 1.6.
  
 
==Activer le salage de mot de passe==
 
==Activer le salage de mot de passe==
  
To set a password salt, add the following line to your [[Configuration file|config.php file]]:
+
Pour définir un sel de mot de passe, il suffit d'ajouter la ligne ci-dessous à votre [[Fichier de configuration|fichier config.php]] :
 +
 
 +
$CFG->passwordsaltmain = 'une très longue chaîne de caractères aléatoires';
  
  $CFG->passwordsaltmain = 'some long random string here with lots of characters';
+
La chaîne de caractères aléatoires doit être composée d'un mélange de lettres, de chiffres et d'autres caractères. Le [http://dev.moodle.org/gensalt.php générateur de sel Moodle] peut être utilisé pour obtenir une telle chaîne suffisamment longue. Une longueur d'au moins 40 caractères est recommandée.
  
The random string of characters should be a mix of letters, numbers and other characters. The [http://dev.moodle.org/gensalt.php Moodle Salt Generator] may be used to obtain a suitable long random string. A string length of at least 40 characters is recommended.
+
''Remarque'' : pour des raisons de sécurité, la seule façon d'activer le salage de mot de passe est la modification du fichier config.php. Il n'y a intentionnellement aucun moyen de le faire à travers l'interface web de Moodle.
  
''Note'': For security reasons the only way to enable password salting is by editing config.php - there is no way to do so in the Moodle interface.
+
'''Astuce''' : Gardez noté votre sel de mot de passe ailleurs que dans le fichier config.php, pour éviter la situation de perte de votre sel de mot de passe, qui entrainerait l'obligation pour tous les utilisateurs du site d'avoir à passer par la récupération de mot de passe pour réinitialiser leur mot de passe.
  
==Changing the salt==
+
==Modifier le sel==
  
If for any reason you wish to change the salt, the old salt must be retained in config.php in addition to the new salt.
+
Si pour quelque raison vous devez modifier le sel de mot de passe, l'ancien sel doit être conservé dans le [[Fichier de configuration|fichier config.php]] en plus du nouveau sel.
  
<code>passwordsaltmain</code> should be changed to <code>passwordsaltalt1</code> (note that the exact expressions must be used) for the old salt as follows:
+
Dans le fichier config.php, la chaîne <code>passwordsaltmain</code> doit être pour cela modifiée en <code>passwordsaltalt1</code> (il doit s'agir exactement de ces textes, lettre pour lettre) pour l'ancien sel, comme indiqué ci-dessous.
  
  $CFG->passwordsaltalt1 = 'old long random string';
+
  $CFG->passwordsaltmain = 'nouvelle très longue chaîne de caractères aléatoires';
  $CFG->passwordsaltmain = 'new long random string';
+
  $CFG->passwordsaltalt1 = 'ancienne très longue chaîne de caractères aléatoires';
  
If you change your salt again in the future, you must retain all the previous salts for some time (until every user has logged in at least once, so they start using the new salt). You can use $CFG->passwordsaltalt2, $CFG->passwordsaltalt3, etc. to keep up to 20 previous salts.
+
Si plus tard vous modifiez encore le sel de mot de passe, il faudra conserver tous les sels précédents durant [http://www.dailymotion.com/video/x1app0_le-fut-du-canon_fun un certain temps] (jusqu'à ce que chaque utilisateur se soit connecté au moins une fois, et utilise donc le nouveau sel). On peut utiliser $CFG->passwordsaltalt2, $CFG->passwordsaltalt3, etc. pour conserver jusqu'à 20 sels précédents.
  
''Warning: If you change the salt and do not retain the old one in config.php you will no longer be able to login to your site!''
+
'''Attention :''' ''Si vous modifiez le sel et ne conservez pas l'ancien dans le [[Fichier de configuration|fichier config.php]], vous ne pourrez plus vous connecter à votre Moodle !''
  
==Disabling password salting==
+
==Désactiver le salage de mot de passe==
  
'''Note''': Not Recommended! Once enabled, you should leave password salt enabled.
+
'''Remarque''' : cette  opération n'est pas recommandée ! Une fois activé, le salage de mot de passe ne devrait pas être désactivé !
  
To disable password salting in Moodle, you can delete, comment out, or change the value of passwordsaltmain to "empty"
+
Pour désactiver le salage de mot de passe de Moodle, vous pouvez supprimer, commenter ou définir la chaîne passwordsaltmain comme une chaîne vide.
  
  // EXAMPLE: set to empty string
+
  // EXEMPLE : définir passwordsaltmain comme une chaîne vide
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
  
  
  // EXAMPLE: comment out
+
  // EXEMPLE : mise en commentaire
 
  /*
 
  /*
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
 
  */
 
  */
  
However, you are not done! You '''must also move the old salt to an "alt" value''', just like the "changing the salt" description, above:
+
Attention, ce n'est pas encore terminé ! Vous '''devez aussi conserver l'ancienne valeur''', comme indiqué ci-dessus pour la modification du sel de mot de passe :
  
$CFG->passwordsaltalt1 = 'old long random string';
 
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
 
  $CFG->passwordsaltmain = <nowiki>''</nowiki>;
 +
$CFG->passwordsaltalt1 = 'ancienne très longue chaîne de caractères aléatoires';
  
==Importing users from another site==
+
==Importer des utilisateurs d'un autre Moodle==
  
If you import users from another Moodle site which uses a password salt, you need to add the other site's salt to config.php too. Upto 20 alternate salts may be added
+
Si vous importez des utilisateurs d'un autre site Moodle qui utilise un sel de mot de passe, vous devez ajouter le sel défini dans l'autre Moodle à votre [[Fichier de configuration|fichier config.php]]. Jusqu'à 20 sels supplémentaires peuvent être ajoutés :
  
 
  $CFG->passwordsaltalt1, $CFG->passwordsaltalt2, ...  $CFG->passwordsaltalt20
 
  $CFG->passwordsaltalt1, $CFG->passwordsaltalt2, ...  $CFG->passwordsaltalt20
  
==How does password salting work?==
+
==Comment fonctionne le salage de mot de passe ?==
  
When a password is checked, the code looks for <code>CFG->passwordsaltmain</code>. If set, it appends the user's password to the salt before calculating the md5 hash.
+
Lorsqu'un mot de passe est vérifié par Moodle, le code recherche la variable <code>CFG->passwordsaltmain</code>. Si elle est définie, il concatène le sel et le mot de passe de l'utilisateur avant de calculer son empreinte md5.
  
If the unsalted md5 hash of a user's password validates, it is assumed that the salt was set for the first time since the last time the user logged in. The user's password is upgraded, using the salt.
+
Si une empreinte md5 du mot de passe d'un utilisateur sans sel est validée, le code suppose que le sel a été défini pour la première fois après la dernière connexion de cet utilisateur. L'empreinte du mot de passe est alors modifiée, en utilisant le sel. En effet, '''le salage a lieu lors de la première connexion après la mise en place du sel dans config.php.'''
  
If neither the unsalted md5 hash, or the salted md5 hash validates, the code looks for up to 20 alternate salts.
+
Si ni l'empreinte md5 sans sel, ni celle avec le sel ne sont valides, le code tente l'opération avec les 20 sels supplémentaires, les uns après les autres.
  
If you change salts, in order not to orphan existing user accounts, you must enter the old salt into one of the alternate slots.
+
Si vous modifiez les sels, pour éviter que des mots de passe de comptes existants ne soient plus validés, vous devez les définir dans les sels supplémentaires.
  
When a user who has an "old salt" password logs in, the first test of their authentication with the new salt will fail... then the code will test any alternate salts, looking for one that allows the password to be proven valid.
+
Quand un utilisateur se connecte avec un mot de passe salé avec un ancien sel, la première vérification effectuée avec le sel principal échouera, puis le code essaiera les différents sels supplémentaires jusqu'à ce que l'un d'entre eux permette la validation du mot de passe.
  
If a user is deemed valid, the system will upgrade the user's hashed password to the latest salt.
+
Dans ce cas, le système mettra à jour l'empreinte md5 du mot de passe avec le sel principal.
  
[[Category:Sécurité]]
+
[[Catégorie:Sécurité]]
  
 
[[en:Password salting]]
 
[[en:Password salting]]
 
[[es:report/security/report_security_check_passwordsaltmain]]
 
[[es:report/security/report_security_check_passwordsaltmain]]

Version actuelle en date du 30 mars 2011 à 08:45

Qu'est-ce que le salage de mot de passe ?

Dans la base de données de Moodle, les mots de passe sont stockés sous forme cryptée, que l'on appelle 'empreinte md5 du mot de passe'.

Le salage de mot de passe est une méthode pour rendre l'empreinte des mots de passe plus sûre en ajoutant aux mots de passe une chaîne de caractères aléatoires avant de calculer leur empreinte md5, ce qui rend beaucoup plus complexe l'opération de retrouver le mot de passe à partir de son empreinte. Plus la chaîne aléatoire est longue, et plus cette opération est rendue complexe.

Cette fonctionnalité existe dans toutes les versions de Moodle depuis Moodle 1.6.

Activer le salage de mot de passe

Pour définir un sel de mot de passe, il suffit d'ajouter la ligne ci-dessous à votre fichier config.php :

$CFG->passwordsaltmain = 'une très longue chaîne de caractères aléatoires';

La chaîne de caractères aléatoires doit être composée d'un mélange de lettres, de chiffres et d'autres caractères. Le générateur de sel Moodle peut être utilisé pour obtenir une telle chaîne suffisamment longue. Une longueur d'au moins 40 caractères est recommandée.

Remarque : pour des raisons de sécurité, la seule façon d'activer le salage de mot de passe est la modification du fichier config.php. Il n'y a intentionnellement aucun moyen de le faire à travers l'interface web de Moodle.

Astuce : Gardez noté votre sel de mot de passe ailleurs que dans le fichier config.php, pour éviter la situation de perte de votre sel de mot de passe, qui entrainerait l'obligation pour tous les utilisateurs du site d'avoir à passer par la récupération de mot de passe pour réinitialiser leur mot de passe.

Modifier le sel

Si pour quelque raison vous devez modifier le sel de mot de passe, l'ancien sel doit être conservé dans le fichier config.php en plus du nouveau sel.

Dans le fichier config.php, la chaîne
passwordsaltmain
doit être pour cela modifiée en
passwordsaltalt1
(il doit s'agir exactement de ces textes, lettre pour lettre) pour l'ancien sel, comme indiqué ci-dessous.
$CFG->passwordsaltmain = 'nouvelle très longue chaîne de caractères aléatoires';
$CFG->passwordsaltalt1 = 'ancienne très longue chaîne de caractères aléatoires';

Si plus tard vous modifiez encore le sel de mot de passe, il faudra conserver tous les sels précédents durant un certain temps (jusqu'à ce que chaque utilisateur se soit connecté au moins une fois, et utilise donc le nouveau sel). On peut utiliser $CFG->passwordsaltalt2, $CFG->passwordsaltalt3, etc. pour conserver jusqu'à 20 sels précédents.

Attention : Si vous modifiez le sel et ne conservez pas l'ancien dans le fichier config.php, vous ne pourrez plus vous connecter à votre Moodle !

Désactiver le salage de mot de passe

Remarque : cette opération n'est pas recommandée ! Une fois activé, le salage de mot de passe ne devrait pas être désactivé !

Pour désactiver le salage de mot de passe de Moodle, vous pouvez supprimer, commenter ou définir la chaîne passwordsaltmain comme une chaîne vide.

// EXEMPLE : définir passwordsaltmain comme une chaîne vide
$CFG->passwordsaltmain = '';


// EXEMPLE : mise en commentaire
/*
$CFG->passwordsaltmain = '';
*/

Attention, ce n'est pas encore terminé ! Vous devez aussi conserver l'ancienne valeur, comme indiqué ci-dessus pour la modification du sel de mot de passe :

$CFG->passwordsaltmain = '';
$CFG->passwordsaltalt1 = 'ancienne très longue chaîne de caractères aléatoires';

Importer des utilisateurs d'un autre Moodle

Si vous importez des utilisateurs d'un autre site Moodle qui utilise un sel de mot de passe, vous devez ajouter le sel défini dans l'autre Moodle à votre fichier config.php. Jusqu'à 20 sels supplémentaires peuvent être ajoutés :

$CFG->passwordsaltalt1, $CFG->passwordsaltalt2, ...  $CFG->passwordsaltalt20

Comment fonctionne le salage de mot de passe ?

Lorsqu'un mot de passe est vérifié par Moodle, le code recherche la variable
CFG->passwordsaltmain
. Si elle est définie, il concatène le sel et le mot de passe de l'utilisateur avant de calculer son empreinte md5.

Si une empreinte md5 du mot de passe d'un utilisateur sans sel est validée, le code suppose que le sel a été défini pour la première fois après la dernière connexion de cet utilisateur. L'empreinte du mot de passe est alors modifiée, en utilisant le sel. En effet, le salage a lieu lors de la première connexion après la mise en place du sel dans config.php.

Si ni l'empreinte md5 sans sel, ni celle avec le sel ne sont valides, le code tente l'opération avec les 20 sels supplémentaires, les uns après les autres.

Si vous modifiez les sels, pour éviter que des mots de passe de comptes existants ne soient plus validés, vous devez les définir dans les sels supplémentaires.

Quand un utilisateur se connecte avec un mot de passe salé avec un ancien sel, la première vérification effectuée avec le sel principal échouera, puis le code essaiera les différents sels supplémentaires jusqu'à ce que l'un d'entre eux permette la validation du mot de passe.

Dans ce cas, le système mettra à jour l'empreinte md5 du mot de passe avec le sel principal.