Browse files

Fixed #273 -- BACKWARDS-INCOMPATIBLE CHANGE -- Changed auth.User.pass…

…word field to add support for other password encryption algorithms. Renamed password_md5 to password and changed field length from 32 to 128. See for upgrade information

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
adrianholovaty committed Nov 21, 2005
1 parent f1a8869 commit a49fa746cdc056f0b660f47fbc55aa43fcd54bcc
Showing with 56 additions and 13 deletions.
  1. +31 −10 django/models/
  2. +25 −3 docs/authentication.txt
@@ -34,7 +34,7 @@ class User(meta.Model):
first_name = meta.CharField(_('first name'), maxlength=30, blank=True)
last_name = meta.CharField(_('last name'), maxlength=30, blank=True)
email = meta.EmailField(_('e-mail address'), blank=True)
password_md5 = meta.CharField(_('password'), maxlength=32, help_text=_("Use an MD5 hash -- not the raw password."))
password = meta.CharField(_('password'), maxlength=128, help_text=_("Use '[algo]$[salt]$[hexdigest]"))
is_staff = meta.BooleanField(_('staff status'), help_text=_("Designates whether the user can log into this admin site."))
is_active = meta.BooleanField(_('active'), default=True)
is_superuser = meta.BooleanField(_('superuser status'))
@@ -53,7 +53,7 @@ class META:
exceptions = ('SiteProfileNotAvailable',)
admin = meta.Admin(
fields = (
(None, {'fields': ('username', 'password_md5')}),
(None, {'fields': ('username', 'password')}),
(_('Personal info'), {'fields': ('first_name', 'last_name', 'email')}),
(_('Permissions'), {'fields': ('is_staff', 'is_active', 'is_superuser', 'user_permissions')}),
(_('Important dates'), {'fields': ('last_login', 'date_joined')}),
@@ -78,13 +78,35 @@ def get_full_name(self):
return full_name.strip()
def set_password(self, raw_password):
import md5
self.password_md5 =
import sha, random
algo = 'sha1'
salt =[:5]
hsh =
self.password = '%s$%s$%s' % (algo, salt, hsh)
def check_password(self, raw_password):
"Returns a boolean of whether the raw_password was correct."
import md5
return self.password_md5 ==
Returns a boolean of whether the raw_password was correct. Handles
encryption formats behind the scenes.
# Backwards-compatibility check. Older passwords won't include the
# algorithm or salt.
if '$' not in self.password:
import md5
is_correct = (self.password ==
if is_correct:
# Convert the password to the new, more secure format.
return is_correct
algo, salt, hsh = self.password.split('$')
if algo == 'md5':
import md5
return hsh ==
elif algo == 'sha1':
import sha
return hsh ==
raise ValueError, "Got unknown password algorithm type in password."
def get_group_permissions(self):
"Returns a list of permission strings that this user has through his/her groups."
@@ -176,10 +198,9 @@ def get_profile(self):
def _module_create_user(username, email, password):
"Creates and saves a User with the given username, e-mail and password."
import md5
password_md5 =
now =
user = User(None, username, '', '', email.strip().lower(), password_md5, False, True, False, now, now)
user = User(None, username, '', '', email.strip().lower(), 'placeholder', False, True, False, now, now)
return user
@@ -44,9 +44,9 @@ Fields
* ``first_name`` -- Optional. 30 characters or fewer.
* ``last_name`` -- Optional. 30 characters or fewer.
* ``email`` -- Optional. E-mail address.
* ``password_md5`` -- Required. An MD5 hash of the password. (Django
doesn't store the raw password.) Raw passwords can be arbitrarily long
and can contain any character.
* ``password`` -- Required. A hash of, and metadata about, the password.
(Django doesn't store the raw password.) Raw passwords can be arbitrarily
long and can contain any character. See the "Passwords" section below.
* ``is_staff`` -- Boolean. Designates whether this user can access the
admin site.
* ``is_active`` -- Boolean. Designates whether this user can log into the
@@ -167,6 +167,28 @@ Change a password with ``set_password()``::
>>> u.set_password('new password')
**This only applies to the Django development version.** Previous versions,
such as Django 0.90, used simple MD5 hashes without password salts.
The ``password`` field of a ``User`` object is a string in this format::
That's hashtype, salt and hash, separated by the dollar-sign character.
Hashtype is either ``sha1`` (default) or ``md5``. Salt is a random string
used to salt the raw password to create the hash.
For example::
The ``User.set_password()`` and ``User.check_password()`` functions handle
the setting and checking of these values behind the scenes.
Anonymous users

0 comments on commit a49fa74

Please sign in to comment.