Django1.5内置的用户认证系统介绍（之二）使用User对象--by hillfree

说明：网上有关Django用户系统的内容不少，但是好像没有针对Django1.5的。可能是因为Django1.5目前用的人还不多吧。（python3.x貌似也是这种情况）。因为自己要用，所以顺手在学习官方文档的过程中，边看边译。基本忠于原文（>95%），小部分太啰嗦的内容就适当意译、简化了。后续还会加入部分自己的体会（会注出），供参考。如有错讹、不准确之处，还请大家指教。

Source：https://docs.djangoproject.com/en/1.5/topics/auth/default/

 

使用Django认证系统（authentication system）

本文介绍Django UAS在缺省配置下的基本功能用法。它几乎能够满足大部分的项目相关需求。对那些基本功能无法满足的项目，Django还支持认证与授权功能的扩展和定制化（extension and customization）

Again，Django UAS包括了认证和授权，因为这两部分的功能相互关联，所以只用UAS/认证系统（authentication system）来指示这两部分。

用户对象 User objects¶

用户对象是认证系统的核心。用户对象通常用来代表网站的用户，并支持例如访问控制、注册用户、关联创建者和内容等。在Django认证框架中只有一个用户类，例如超级用户（ ‘superusers’）或职员（‘staff’）用户只不过是相同用户对象设置了不同属性而已。

缺省用户的基本属性包括：

• 用户名username
• 密码password
• email
• 名字first name
• 姓氏last name

参见完整的API文档（full API documentation），本文档的下列部分是面向任务方式编排的。

创建用户 Creating users

创建用户最直接的方法是使用内置的 create_user() 方法：

>>> from django.contrib.auth.models import User
>>> user = User.objects.create_user('john', 'lennon@thebeatles.com', 'johnpassword')
 
# At this point, user is a User object that has already been saved
# to the database. You can continue to change its attributes
# if you want to change other fields.
>>> user.last_name = 'Lennon'
>>> user.save()

如果你设置好了Django admin后台，你还可以使用Web后台来创建用户（create users interactively）。

创建超级用户 Creating superusers

如果你已经在配置文件的 INSTALLED_APPS里配置了'django.contrib.auth' ，那么在你第一次运行manage.py syncdb 时，会提示你创建一个超级用户。如果你在之后还想创建超级用户，你可以使用如下的命令行：

manage.py createsuperuser --username=joe --email=joe@example.com

程序会提醒你设置一个密码，如果输入了密码，用户就会被立即创建。如果你没有使用 --username 或 --email 选项，那么还会提示你输入这些内容。

更改密码 Changing passwords

Django不在用户模型（数据库表）中保存密码文本 (clear text)，而只保存哈希值 （具体参见documentation of how passwords are managed）。因此，不要去直接操作用户的password属性。这也是为什么要提供helper函数来创建用户的原因。

可以由多个方法来更改用户密码：

manage.py changepassword *username* 提供了一个更改密码的命令行方式。它会提示输入新密码并确认输入，如果两次输入一致，新密码会立即生效。如果你未指定用户，程序会尝试指定修改当前系统用户的密码。

你也可以用程序来更改密码，方法是 set_password()：

>>> from django.contrib.auth.models import User
>>> u = User.objects.get(username__exact='john')
>>> u.set_password('new password')
>>> u.save()

如果你配置好了Django admin后台，你也可以使用Web后台来修改用户密码（authentication system’s admin pages）

Django提供了相关的 views 和 forms 可供用户使用修改密码。

用户认证Authenticating Users

authenticate(**credentials)

需要验证username 和password时，使用 authenticate()方法。它接受表单参数提供的安全凭证（credentials）做参数，在缺省配置下，是 username 和password，如果验证通过就返回一个User对象，如果密码无效，则返回None：

from django.contrib.auth import authenticate
user = authenticate(username='john', password='secret')
if user is not None:
    # the password verified for the user
    if user.is_active:
        print("User is valid, active and authenticated")
    else:
        print("The password is valid, but the account has been disabled!")
else:
    # the authentication system was unable to verify the username and password
    print("The username and password were incorrect.")