auth组件
一、auth模块简介
auth模块是django自带的用户认证模块,包含了身份验证和权限管理两部分。
身份验证用于核实某个用户是否合法,权限管理用于决定一个合法用户有哪些权限
默认情况下,使用django-admin startproject
命令后,认证模块已经添加到settings文件中,如果没有请手动添加
INSTALLED_APPS中添加
`django.contrib.auth` 包含认证框架的核心以及默认模型
`django.contrib.contenttypes` 内容类型系统,用于给模型关联许可
-------------------------------------------------------------------
MIDDLEWARE中添加
`SessionMiddleware` 通过请求管理会话
`AuthenticationMiddleware` 将会话和用户关联
二、用户对象
在django中用户对象是用户认证系统的核心,只有一个用户模型就是User模型,它位于django.contrib.auth.models
,使用auth_user表来存储用户数据
1.创建用户
create_user(username、password)-------普通用户
from django.contrib.auth.models import User
user = User.objects.create_user(username='用户名',password='密码',email='邮箱',...)
user是一个User类的实例,已经保存在了数据库内,你可以随时修改它的属性,例如:
user.last_name='fj'
user.save()
create_superuser(username、password)-----------超级用户
from django.contrib.auth.models import User
user = User.objects.create_superuser(username='用户名',password='密码',email='邮箱',...)
2.修改密码
注:Django默认会对密码进行加密,因此,不要对密码进行直接操作
set_password(password)------设置密码
user.set_password(password='')
user.save()
check_password(password)-----检查密码是否正确
ok=user.check_password('密码')
需要提供当前请求用户的密码,正确返回True,错误返回False
3.用户验证
authenticate()
验证用户名以及密码是否正确,一般需要username 、password两个关键字参数。
如果认证成功(用户名和密码正确有效),便会返回一个 User 对象。
from django.contrib import auth
user = authenticate(username='usernamer',password='password')
if user:
#认证成功
else:
#认证失败
is_authenticated()用来判断是否通过了认证
def my_view(request):
if not request.user.is_authenticated():
return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))
4.User对象的属性
- is_staff:用户是否拥有网站的管理权限
- is_active:是否允许用户登录,设置为False可以在不删除用户的前提下禁止用户登录
三、在视图中认证用户
django使用session和中间件关联请求对象中和认证系统,每一次请求都包含一个request.user
属性,表示当前用户,如果用户未登录,该值为AnonymousUser
实例(匿名用户),如果登录它就是一个User模型的实例。
1.登录用户
login(HttpRequest,user)---会将用户的ID保存在django的session中
from django.contrib.auth import authenticate,login
def my_view(request):
username = request.POST['username']
password = request.POST['password']
user = authenticate(username=username, password=password)
if user:
login(request,user)
return HttpResponse('登录成功')
else:
return HttpResponse('用户名或密码错误')
2.注销用户
logout(request)----无返回值
from django.contrib.auth import logout
def logout_view(request):
logout(request)
- 当前请求的session信息会被全部删除,如果用户没有登录也不会报错
3.登录认证装饰器
login_requierd(redirect_field_name='next',login_url='/login/')
用于给视图添加登录校验
from django.contrib.auth.decorators import login_required
@login_required
def other_view(request):
...
redirect_field_name
:修改的是浏览器 ? 后面的key值login_url='/login/'
如果没有登录跳转到的页面 (局部设置)- 在
settings.LOGIN_URL
设置没有登录跳转的页面,传递当前路径为url字符串的参数(全局设置) - 如果已经登录,执行正常的视图
四、扩展默认的auth_user表
默认的auth_user表字段是固定的几个,需要扩展的话可以通过下面的方法
1.定义一个表模型,和User一对一管理
class UserDetail(models.Model):
phone=models.CharField(max_length=32)
# 一对一跟auth_user表做关联
# 如果是从外部引入的表模型,是不能加引号的
# 如果加引号,只是在当前model找
user=models.OneToOneField(to=User)
2.定义一个表模型,继承(AbstractUser类)
from django.contrib.auth.models import AbstractUser
class UserInfo(AbstractUser):
"""
用户信息表
"""
nid = models.AutoField(primary_key=True)
phone = models.CharField(max_length=11, null=True, unique=True)
def __str__(self):
return self.username
建好模型后需要在settings中配置,
AUTH_USER_MODEL='app名.UserInfo'
注:一旦指定了新的表模型,之前的表模型就不能用了。