Django的用户认证组件
一、使用用户认证组件的前提
功能:用session记录登录验证状态。
用户表:使用Django自带的auth_user表,即用户认证组件表。
创建超级用户:python3 manage.py createsuperuser
创建普通用户:python3 manage.py createuser
1、重点API
from django.contrib import auth: 1、if 验证成功返回user对象,否则返回None user = auth.authenticate(username=user, password = pwd) 2、auth.login(request, user) # request.user当前登录对象 3、auth.logout(request) from django.contrib。auth.models import User # User == auth_user 4、request.user.is_authenticated() 5、user = User.objects.create_user(username='', password='',email='')
2、匿名用户对象
""" 匿名用户 class models.AnonymousUser django.contrib.auth.models.AnonymousUser 类实现了django.contrib.auth.models.User 接口,但具有下面几个不同点: id 永远为None。 username 永远为空字符串。 get_username() 永远返回空字符串。 is_staff 和 is_superuser 永远为False。 is_active 永远为 False。 groups 和 user_permissions 永远为空。 is_anonymous() 返回True 而不是False。 is_authenticated() 返回False 而不是True。 set_password()、check_password()、save() 和delete() 引发 NotImplementedError。 New in Django 1.8: 新增 AnonymousUser.get_username() 以更好地模拟 django.contrib.auth.models.User。 """
二、auth模块
# 在视图中引入auth模块 from django.contrib import auth
1、authenticate()
authenticate()方法提供了用户认证,即验证用户名以及密码是否正确,一般需要username password两个关键字参数。
如果认证信息有效,会返回一个 User 对象;如果认证失败,则返回None。authenticate()会在User 对象上设置一个属性标识那种认证后端认证了该用户,且该信息在后面的登录过程中是需要的。当我们试图登陆一个从数据库中直接取出来不经过authenticate()的User对象会报错的!!
from django.shortcuts import render # Create your views here. from django.contrib import auth def login(request): if request.method == "POST": user = request.POST.get("user") pwd = request.POST.get("pwd") # 如果验证成功返回user对象,否则返回None user = auth.authenticate(username=user,password=pwd) return render(request, "login.html")
2、login(HttpRequest, user)
login函数的参数:该函数接受一个HttpRequest对象,以及一个认证了的User对象
此函数使用django的session框架给某个已认证的用户附加上session id等信息。
from django.shortcuts import render, HttpResponse, redirect # Create your views here. from django.contrib import auth def login(request): if request.method == "POST": user = request.POST.get("user") pwd = request.POST.get("pwd") # 如果验证成功返回user对象,否则返回None user = auth.authenticate(username=user, password=pwd) if user: auth.login(request, user) # request.user:当前登录对象 return redirect("/index/") return render(request, "login.html")
request.user是全局变量,在任何视图和模板中可以直接使用(这也是这套用户认证最大的优点)。
在没有通过登录验证的情况下为匿名用户。因此可以根据匿名用户特点判断是否登录验证通过,同时也可以直接通过{{request.user.username}}在模板中显示用户名。
但在经过auth.login(request, user) 后为登录对象。
def index(request): print("request.user", request.user) # AnonymousUser 匿名用户 # 没有登录验证过即匿名用户 print("request.user", request.user.username) # 返回空字符串 print("request.user", request.user.id) # 返回None print("request.user", request.user.is_anonymous) # 返回 True # request.user是全局变量 if request.user.is_anonymous: return redirect("/login/") # 给模板中传入username # username = request.user.username # return render(request, "index.html", {"username": username}) # 模板中通过{{ username }}取到用户名 # 改写为: return render(request, "index.html") # 模板中通过{{ request.user.username }}就可以取到用户名
3、logout(request)注销用户
def logout(request): auth.logout(request) # 主要就是做了一个request.session.flush() return redirect("/login/")
该函数接受一个HttpRequest对象,无返回值。当调用该函数时,当前请求的session信息会全部清除。该用户即使没有登录,使用该函数也不会报错。
三、User对象
User 对象属性:username, password(必填项)password用哈希算法保存到数据库 。
1、user对象的 is_authenticated()
user.is_authenticated:
如果是真正的 User 对象,返回值恒为 True 。 用于检查用户是否已经通过了认证。
通过认证并不意味着用户拥有任何权限,甚至也不检查该用户是否处于激活状态,这只是表明用户成功的通过了认证。 这个方法很重要, 在后台用request.user.is_authenticated判断用户是否已经登录,如果true则可以向前台展示request.user.name。
要求:
1 用户登陆后才能访问某些页面,
2 如果用户没有登录就访问该页面的话直接跳到登录页面
3 用户在跳转的登陆界面中完成登陆后,自动访问跳转到之前访问的地址
方法1:
def index(request): # if request.user.is_anonymous: # 改写为: if not request.user.is_authenticated: return redirect("/login/") return render(request, "index.html") # 模板中通过{{ request.user.username }}就可以取到用户名
方法2:
django设计的一个专门用于这种情况的装饰器:login_required()
from django.contrib.auth.decorators import login_required @login_required def index(request): return render(request, "index.html") @login_required def order(request): return render(request, "order.html")
若用户没有登录,则会跳转到django默认的登录URL '/accounts/login/ ' (这个值可以在settings文件中通过LOGIN_URL进行修改)。
STATIC_URL = '/static/' LOGIN_URL = "/login/" # 不配这个访问index会跳转到,http://127.0.0.1:8000/accounts/login/?next=/index/
修改后,用户访问.../order/和.../index/页面时,会跳转到login页面,同时会传递当前访问url的绝对路径(登录成功后,会重定向到该路径)。
代码示例整体如下:
from django.shortcuts import render, HttpResponse, redirect # Create your views here. from django.contrib import auth from django.contrib.auth.models import User from django.contrib.auth.decorators import login_required def login(request): if request.method == "POST": user = request.POST.get("user") pwd = request.POST.get("pwd") # 如果验证成功返回user对象,否则返回None user = auth.authenticate(username=user, password=pwd) if user: auth.login(request, user) # request.user:当前登录对象 next_url = request.GET.get("next", "/index/") # 登录成功跳转的url,如果取不到跳转首页 return redirect(next_url) return render(request, "login.html") @login_required def index(request): return render(request, "index.html") # 模板中通过{{ request.user.username }}就可以取到用户名 def logout(request): auth.logout(request) # 主要就是做了一个request.session.flush() return redirect("/login/") def reg(request): if request.method == "POST": user = request.POST.get("user") pwd = request.POST.get("pwd") # 使用create_user辅助函数创建用户 user = User.objects.create_user(username=user, password=pwd) # 注册成功跳转到登录页面 return redirect("/login/") return render(request, "reg.html") @login_required def order(request): return render(request, "order.html")
2、创建用户
使用 create_user 辅助函数创建用户:
from django.contrib.auth.models import User def reg(request): if request.method == "POST": user = request.POST.get("user") pwd = request.POST.get("pwd") # 不能用下面这个方法插入: # User.objects.create(username=user, password=pwd) # 使用create_user辅助函数创建用户 user = User.objects.create_user(username=user, password=pwd) # 注册成功跳转到登录页面 return redirect("/login") return render(request, "reg.html")
3、check_password(passwd)
用户需要修改密码的时候 首先要让他输入原来的密码 ,如果给定的字符串通过了密码检查,返回
True.
4、修改密码
使用 set_password() 来修改密码:
user = User.objects.get(username='') user.set_password(password='') user.save
5、简单示例
(1)注册:
def sign_up(request): state = None if request.method == 'POST': password = request.POST.get('password', '') repeat_password = request.POST.get('repeat_password', '') email=request.POST.get('email', '') username = request.POST.get('username', '') if User.objects.filter(username=username): state = 'user_exist' else: new_user = User.objects.create_user(username=username, password=password,email=email) new_user.save() return redirect('/book/') content = { 'state': state, 'user': None, } return render(request, 'sign_up.html', content)
(2)修改密码:
@login_required def set_password(request): user = request.user state = None if request.method == 'POST': old_password = request.POST.get('old_password', '') new_password = request.POST.get('new_password', '') repeat_password = request.POST.get('repeat_password', '') if user.check_password(old_password): if not new_password: state = 'empty' elif new_password != repeat_password: state = 'repeat_error' else: user.set_password(new_password) user.save() return redirect("/log_in/") else: state = 'password_error' content = { 'user': user, 'state': state, } return render(request, 'set_password.html', content)