Django的认证系统(auth)

Django自带的用户认证 :

在开发一个网站时, 无可避免的需要设计实现网站的用户系统. 此时我们需要实现包括用户注册, 用户登录, 用户认证, 注销, 修改密码等功能. 

Django作为一个完美主义的终极框架, 当然也内置了强大的用户认证系统(auth), 它默认使用auth_user表来存储用户数据. 

---

auth模块 :

导入auth :

from django.contrib import auth

auth中提供了许多使用方法 :

authenticate :

提供用户认证功能, 即验证用户名以及密码是否正确, 一般需要username, password两个关键字参数. 如果认证成功(用户名和密码正确有效), 便会返回一个User对象.

authenticate() 会在该User对象上设置一个属性来标识后端已经认证了该用户, 且该信息在后续的登录过程中是需要的. 

user = auth.authenticate(request, username="xxx", password="xxx")

login(HttpRequest, user) :

该函数接受一个HttpRequest对象, 以及一个经过认证的User对象.

该函数实现一个用户登录的功能. 它本质上会在后端为该用户生成相关session数据.

from django.contrib.auth import authenticate, login
   
def my_view(request):
  username = request.POST['username']
  password = request.POST['password']
  user = authenticate(request, username=username, password=password)
  if user is not None:
    login(request, user)
    # Redirect to a success page.
    ...
  else:
    # Return an 'invalid login' error message.
    ...

logout(request) :

该函数接受一个HttpRequest对象, 无返回值.

当调用该函数时, 当前请求的session信息会全部清除. 该用户即使没有登录, 使用该函数也不会报错.

from django.contrib.auth import logout
   
def logout_view(request):
  logout(request)
  # Redirect to a success page.

is_authenticated() :

用来判断当前请求是否通过了认证.

def my_view(request):
  if not request.user.is_authenticated():
    return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))

login_requierd() :

auth给我们提供一个装饰器工具, 用来快捷的给某个视图添加登录校验.

from django.contrib.auth.decorators import login_required
      
@login_required
def my_view(request):
  ...

若用户没有登录, 则会跳转到dajngo默认的登录 URL"/accounts/login/" 并传递当前访问url的绝对路径(登录成功后, 会重定向到该路径).

如果需要自定义登录的URL, 需要自settings,py文件中通过LOGIN_URL进行修改:

LOGIN_URL = "/login/"   # 配置自己项目想要跳转的路由

create_user() :

auth 提供的一个创建新用户的方法, 需要提供必要参数(username, password)等.

from django.contrib.auth.models import User
user = User.objects.create_user（username='用户名',password='密码',email='邮箱',...）

create_superuser() :

auth提供的一个而创建新的超级用户的方法, 需要提供必要参数(username, password)等.

from django.contrib.auth.models import User
user = User.objects.create_superuser（username='用户名',password='密码',email='邮箱',...）

check_password(password) :

auth提供的一个检查密码是否正确的方法, 需要提供当前请求用户的密码.

密码正确返回True, 否则返回False.

ok = user.check_password('原密码')

set_password(password) :

auth提供的一个修改密码的方法, 接收要设置的新密码作为参数.

注意 : 设置完要对调用用户对象的save()方法!!

user.set_password("新密码")
user.save()

User对象的属性 :

User对象属性: username, password

is_staff: 用户是否拥有网站的管理权限

is_active: 是否允许用户登录, 设置为False, 可以在不删除用户的前提下禁止用户登录.

---

扩展默认的auth_user表 :

可以通过继承内置的AbstractUser类, 来定义自己的Model类.

这样既能根据项目需求灵活设计用户表, 又能使用Django强大的认证系统.

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

注意 : 按照上面的方式扩展了内置的auth_user表之后, 一定要在settings.py中告诉Django, 现在使用新定义的UserInfo来做用户认证. 写法如下 :

# 引用Django自带的User表，继承使用时需要设置
AUTH_USER_MODEL = "app名.UserInfo"

注意+1 : 一旦指定了新的认证系统所使用的表, 我们就需要重新再数据库中创建新表, 而不能继续使用原来默认的auth_user表了.