源码示例下载：rbac组件应用之主机管理系统【auto_luffy.zip】
RBAC组件的使用文档
1.将rbac组件拷贝到项目
2.将rbac/migrations目录下的数据库的迁移记录删除（除了__init__.py）
3.业务系统中用户表结构的设计
业务表结构中的用户表需要和rbac中的用户表有继承关系。如：
- rbac中的models.py
class Userinfo(models.Model):
name = models.CharField(verbose_name='用户名',max_length=32)
password = models.CharField(verbose_name='密码',max_length=64)
email = models.CharField(verbose_name='邮箱',max_length=32)
roles = models.ManyToManyField(verbose_name='拥有的所有角色',to='Role',blank=True)
def __str__(self):
return self.name
class Meta:
#加上abstract=True，django以后再做数据库迁移就不会为UserInfo类创建相关的表以及表结构了
#注意:此类可以当做父类，可以被继承(可以把字段加到继承他的类中)
abstract=True
- 业务中的models.py
class UserInfo(RbacUserInfo): #继承了RbacUserInfo中的字段
user = models.OneToOneField(to=RbacUserInfo,verbose_name='用户',on_delete=models.CASCADE)
phone = models.CharField(verbose_name='联系方式',max_length=32)
level_choices=(
(1,'T1'),
(2,'T2'),
(3,'T3'),
)
level = models.IntegerField(verbose_name='级别',choices=level_choices)
depart= models.ForeignKey(verbose_name='部门',to='Department',on_delete=models.CASCADE)
def __str__(self):
return self.user.name
4.将业务系统中的用户表的路径写到配置文件中
--settings.py中
RBAC_USER_MODEL_CLASS = 'app01.models.UserInfo' #业务中的用户表
用于在rbac分配权限时，读取业务表中的用户信息
5.业务逻辑开发
- 将所有的路由都设置一个name，如：
urlpatterns = [
re_path('^admin/$', admin.site.urls),
re_path(r'^login/$', account.login,name='login'),
re_path(r'^logout/$', account.logout,name='logout'),
re_path(r'^index/$', account.index,name='index'),
#用户相关功能
re_path(r'^user/list/$', user.user_list,name='user_list'),
re_path(r'^user/add/$', user.user_add, name='user_add'),
re_path(r'^user/edit/(?P<edit_id>\d+)/$', user.user_edit, name='user_edit'),
re_path(r'^user/del/(?P<del_id>\d+)/$', user.user_del, name='user_del'),
re_path(r'^user/reset_pwd/(?P<reset_id>\d+)/$', user.user_reset_pwd, name='user_reset_pwd'),
#主机功能
re_path(r'^host/list/$', host.host_list, name='host_list'),
re_path(r'^host/add/$', host.host_add, name='host_add'),
re_path(r'^host/edit/(?P<edit_id>\d+)/$', host.host_edit, name='host_edit'),
re_path(r'^host/del/(?P<del_id>\d+)/$', host.host_del, name='host_del'),
re_path(r'^rbac/', include(('rbac.urls', 'rbac'), namespace='rbac')),
]
用于反向生成url，以及粒度控制到按钮
6.权限信息的录入
-url 中添加rbac的路由分发,注意必须写namespace
urlpatterns = [
re_path(r'^rbac/', include(('rbac.urls', 'rbac'), namespace='rbac')),
]
- rbac提供的地址进行操作配置
- http://127.0.0.1:8000/rbac/menu/list/ 菜单列表
- http://127.0.0.1:8000/rbac/role/list/ 角色列表
- http://127.0.0.1:8000/rbac/distribute/permissions/ 权限分配
相关配置:
#批量操作中,自动发现url，应该排除的url
AUTO_DISCOVER_EXCLUDE = [
'/admin/.*',
'/login/',
'/logout/',
'/index/',
]
7.编写用户登录的逻辑 （权限的初始化==>>init_permission(request,user_obj)）
def login(request):
if request.method == 'GET':
return render(request,'login.html')
user = request.POST.get('user')
pwd = request.POST.get('pwd')
print(user,pwd)
user_obj = models.UserInfo.objects.filter(name=user,password=pwd).first()
if not user_obj:
return render(request,'login.html',{'error':'用户名或密码错误'})
init_permission(request,user_obj)
return redirect('/index/')
相关的配置:权限和菜单的seeion key:
- settings.py
PERMISSION_SESSION_KEY = 'luffy_permissions_url_list'
MENU_SESSION_KEY = 'luffy_menu_list'
8.编写一个首页的逻辑
def index(request):
return render(request,'index.html')
相关的配置:
#无需校验，但需登录成功后的
NO_PERMISSIONS_LIST=[
'/logout/',
'/index/',
]
9.权限的校验（中间件）
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
'rbac.middleware.rbac.RbacMiddleware',
]
#白名单
WHITE_LIST = [
'/login/',
'/admin/.*',
]
10.粒度到按钮级别的控制
{% load rbac %}
{% if request|has_permission:'host_add' %}
...
{% endif %}
***总结***:目的时希望在任意系统中应用权限系统。
- 用户登录+用户首页+用户注销+业务逻辑
- 项目业务逻辑开发
注意:开发时要灵活运用laout.html中的两个inclusion.tag
<div class="pg-body">
<div class="left-menu">
<div class="menu-body">
{% multi_menu request %} #开发时去掉，上线时取回
</div>
</div>
<div class="right-body">
{% nav_menu request %} #开发时去掉，上线时取回
{% block content %} {% endblock %}
</div>
</div>
- 权限信息的录入
- 配置文件
#注册app
INSTALLED_APPS = [
...
'app01.apps.App01Config',
'rbac.apps.RbacConfig',
]
#应用中间件
MIDDLEWARE = [
...
'rbac.middleware.rbac.RbacMiddleware',
]
RBAC_USER_MODEL_CLASS = 'app01.models.UserInfo' #业务中的用户表
#白名单
WHITE_LIST = [
'/login/',
'/admin/.*',
]
#无需校验，但需登录成功后的
NO_PERMISSIONS_LIST=[
'/logout/',
'/index/',
]
#登录成功后，权限初始化SESSION_KEY
PERMISSION_SESSION_KEY = 'luffy_permissions_url_list'
MENU_SESSION_KEY = 'luffy_menu_list'
####################自动找到所有url功能(白名单)####################
#自动发现url，应该排除的url
AUTO_DISCOVER_EXCLUDE = [
'/admin/.*',
'/login/',
'/logout/',
'/index/',
]
#粒度到按钮的控制