注意:本文翻译自django1.8.2的官方文档中的:Using the Django authentication system
这份文档介绍了在默认配置下使用django的认证系统.默认配置已经能够满足大部分普遍的项目需求,能处理相当广泛的任务,对于密码和验证有一个相对安全的实现.如果项目需要的认证与默认配置不同,django提供了对于默认配置的认证的扩展和定制
django认证提供了身份验证(authentication)和权限管理(authorization),通常这2个并称为认证系统(authentication systom),因为它们的功能有重合(耦合)
User objects
User对象是认证系统的核心.它通常表示访问网站的人,用于限制连接,注册使用者资料,将内容与内容产生者关联等.django的认证框架里只有一个user类,也就是说,superusers 或 admin ,staff 只是拥有特殊属性的user对象集合,与user对象是用一个类(class).
默认的user的基本属性有:
- username
- password
- first_name
- last_name
要查看完整内容请查看full API documentation,下面的文档是more task oriented
Creating users
创建user最直接的方式是使用内置的create_user()方法:
>>> from django.contrib.auth.models import User
>>> user = User.objects.create_user('john', 'lennon@thebeatles.com', 'johnpassword')
# 这个时候,user是一个User对象,已经保存到数据库了.
# 如果想改变其他字段的值,可以继续改变它的属性
>>> user.last_name = 'Lennon'
>>> user.save()
如果已经安装了django admin,可以使用网页交互,创建user
Creating superusers
使用createsuperuser命令创建superusers
$ python manage.py createsuperuser --username=joe --email=joe@example.com
会提示输入密码.输入之后,会立即创建user,如果你没有用–username或–email选项,系统会提示你输入
Changing passwords
django不会存储明文密码,而是存储一个哈希值.所以,不要直接操作user的密码属性.这也是为什么创建user时使用helper function的原因(使用了create_user,而不是通用的create).
改变user的密码,有几种方式:
manage.py changepassword “username”提供了在命令行改变user密码的方法.他会提示你输入2次.如果2次都输入相同,新密码会马上改变.如果你没有提供username,这个命令会尝试改变最近的系统user的密码
你也可以用编码的方式更改密码,使用set_password():
>>> from django.contrib.auth.models import User
>>> u = User.objects.get(username='john')
>>> u.set_password('new password')
>>> u.save()
如果安装了django admin,你也可以在认证系统的admin网页里更改user的密码
django同样提供了views和froms可以用于用户更改他们的密码
django1.7新增
如果SessionAuthenticationMiddleware可用,改变密码会注销session.
Authenticating Users
- authenticate(**credentials)
要验证给定的username和password,使用authenticate(). 它
使用form中已经验证格式的参数作为关键字参数,默认配置下,这是username和password,如果密码正确,它返回一个User对象.如果密码不正确,authenticate()返回None.例如
from django.contrib.auth import authenticate
user = authenticate(username='john', password='secret')
if user is not None:
# 验证密码
if user.is_active:
print("User is valid,active and authenticated")
else:
print("密码正确,但是账户不可用")
else:
# username和password没有通过验证
print('用户名或密码不正确.')
Note:
这是比较低级的方法;例如,使用RemoteUserMiddleware.除非你自己写认证系统,要不然你很可能用不到它.而如果你正在寻找一种方式来限制登录用户的访问,请参阅login_required()装饰器