权限校验
权限校验和认证校验必须同时使用,并且权限校验是排在认证校验之后的,这在源码中可以查找到其执行顺序。
权限校验也很重要,认证校验可以确保一个用户登录之后才能对接口做操作,而权限校验可以依据这个登录用户的类型来限定能对接口做那些操作。
准备工作
模型表
下面是模型表,对于不同等级的用户,访问同一@H_502_11@url,能够获取到的电影内容也不一样。
@H_502_11@from django.db import models # Create your models here. class User(models.Model): user_id = models.AutoField(primary_key=True) user_name = models.CharField(max_length=32) user_password = models.CharField(max_length=32) user_type = models.IntegerField(choices=( [0,"普通用户"],[1,"黄金VIP"],[2,"钻石VIP"],)) user_token = models.CharField(max_length=64,null=True,unique=True) class Film(models.Model): film_id = models.AutoField(primary_key=True) film_name = models.CharField(max_length=32) film_grade = models.IntegerField( choices=( [0,"免费电影"],"黄金VIP专享"],"钻石VIP专享"] ) )
用户表数据如下:
电影表数据如下:
序列类
采用模型类序列器,并且只对电影做序列化:
@H_502_11@from rest_framework import serializers from app01 import models class FilmModelSerializers(serializers.ModelSerializer): class Meta: model = models.Film fields = "__all__"
认证校验
下面是认证权限,只有登录后的用户才可以看到电影信息。如果没有登录将不允许查看所有电影的页面,或者你也可以不设置认证校验,但是在权限设置中可以设置匿名用户直接返回一个False也行。
@H_502_11@from rest_framework.authentication import BaseAuthentication from rest_framework.exceptions import APIException from app01 import models class LoginAuth(BaseAuthentication): def authenticate(self,request): token = request.Meta.get("HTTP_TOKEN") if not token: # 未登录 raise APIException("未登录,无法查看本电影网站,请先登录") user_obj = models.User.objects.filter(user_token=token).first() if not user_obj: raise APIException("token无效,登录失败") else: return user_obj,user_obj.user_type # 将用户对象本身以及用户的类型存储到request.user以及request.auth中
视图
下面是视图的代码:
@H_502_11@from uuid import uuid4 from rest_framework.generics import ListAPIView from rest_framework.generics import GenericAPIView from rest_framework.views import APIView from rest_framework.views import Response from app01 import models from app01 import serializationClass from app01 import app01_auth class FilmAPI(ListAPIView,GenericAPIView): authentication_classes = [app01_auth.LoginAuth] # 必须登录 queryset = models.Film.objects.all() # 默认查看所有,任何用户都是 serializer_class = serializationClass.FilmModelSerializers def get(self,request): return self.list(request) class Login(APIView): def post(self,request): user_dict = { "user_name":request.data.get("user_name"),"user_password":request.data.get("user_password"),} user_obj = models.User.objects.filter(**user_dict).first() if not user_obj: return Response(data="用户名或密码错误") else: token = uuid4() # 创建token user_obj.user_token = token user_obj.save() return Response(data="登录成功",headers={"token":token}) # 返回token到请求头中
url
下面是路由。
@H_502_11@from django.contrib import admin from django.urls import path from app01 import views urlpatterns = [ path('admin/',admin.site.urls),path('login/',views.Login.as_view()),path('api/film/',views.FilmAPI.as_view()),]
简单尝试
现在我们启动@H_502_11@django项目试试。可以发现,当我们在请求头中设置好@H_502_11@token并朝@H_502_11@api发送@H_502_11@GET请求时,它会返回所有的数据。
我们登录的是@H_502_11@jack这个用户,他应该只能看到免费电影,而类似泰坦尼克号这种电影是不应该让他看见的。
自定制权限
写一个类,继承@H_502_11@BasePermission,重写@H_502_11@has_permission()方法,如果权限通过,就返回@H_502_11@True,不通过就返回@H_502_11@False。
权限校验
接下来我们来写权限校验,@H_502_11@has_permission()方法接受两个参数,分别是@H_502_11@request和@H_502_11@view,也就是视图类的实例化本身。
@H_502_11@from rest_framework.permissions import BasePermission from app01 import models from django.db.models import Q class UserPermission(BasePermission): def has_permission(self,request,view): if request.auth == 1: # 如果是普通用户,修改当前获取的资源为免费电影 view.queryset = models.Film.objects.filter(film_grade=1) elif request.auth == 2: # 如果是黄金VIP,则只能获取黄金VIP电影和免费电影 view.queryset = models.Film.objects.filter(Q(film_grade=2) | Q(film_grade=1)) else: pass # 默认就是获取所有,所以不用修改 return True # 权限校验完成,设置好了。普通用户只能看免费电影
局部使用
下面是局部使用,只需要用一个变量名为@H_502_11@permission_classes的列表,将权限校验的类放入即可:
@H_502_11@class FilmAPI(ListAPIView,GenericAPIView): authentication_classes = [app01_auth.LoginAuth] # 必须登录 permission_classes = [app01_permissions.UserPermission] # 做权限设置 queryset = models.Film.objects.all() # 默认查看所有,任何用户都是 serializer_class = serializationClass.FilmModelSerializers def get(self,request): return self.list(request)
全局使用
如果是全局使用,则需要到项目全局文件夹下的@H_502_11@settings.py中进行设置:
@H_502_11@# 全局使用 REST_FRAMEWORK={ 'DEFAULT_PERMISSION_CLASSES': [ 'app01.app01_permissions.UserPermission',],}
如果想取消某个接口的权限认证设置,则在其中设置类属性@H_502_11@permission_classes是一个空列表。
@H_502_11@class Login(APIView): permission_classes = [] # 取消权限验证设置 def post(self,headers={"token":token}) # 返回token到请求头中
结果演示
再次使用@H_502_11@jack的@H_502_11@token进行登录,可以发现他只会看到免费电影了。
而使用@H_502_11@ken的@H_502_11@token进行登录,他将看不到钻石VIP的电影,如泰坦尼克号:
倘若使用@H_502_11@yunya的@H_502_11@token进行登录,则可以查看到所有的电影。
内置权限
如果你是使用@H_502_11@auth组件来做的一系列登录等,则可以使用内置权限。
它会判断该用户的@H_502_11@is_staff字段是否为@H_502_11@True。
内置权限的类使用有很多,如下所示:
基本演示
@H_502_11@# 演示一下内置权限的使用:IsAdminUser,控制是否对网站后台有权限的人 # 1 创建超级管理员 # 2 写一个测试视图类 from rest_framework.permissions import IsAdminUser from rest_framework.authentication import SessionAuthentication class TestView3(APIView): authentication_classes=[SessionAuthentication,] # 必须有认证 permission_classes = [IsAdminUser] # 权限设置 def get(self,*args,**kwargs): return Response('这是22222222测试数据,超级管理员可以看') # 3 超级用户登录到admin,再访问test3就有权限 # 4 正常的话,普通管理员,没有权限看(判断的是is_staff字段)
源码分析
权限校验排在认证校验之后,这在源码中可以查看到。
它的源码相比于认证的源码来说简单的多,认证的执行是在@H_502_11@request.user中进行的,而它直接是在当前视图类中进行,所以很简单。
@H_502_11@# APIView---->dispatch---->initial--->self.check_permissions(request)(APIView的对象方法) def check_permissions(self,request): # 遍历权限对象列表得到一个个权限对象(权限器),进行权限认证 遍历 for (权限认证的实例化对象) for permission in self.get_permissions(): # 权限类一定有一个has_permission权限方法,用来做权限认证的 # 参数:权限对象self、请求对象request、视图类对象 # 返回值:有权限返回True,无权限返回False if not permission.has_permission(request,self): self.permission_denied( request,message=getattr(permission,'message',None) )