在常用的后臺(tái)管理系統(tǒng)中,通常都會(huì)有權(quán)限系統(tǒng)設(shè)計(jì),以用于給對(duì)應(yīng)人員分配不同權(quán)限,控制其對(duì)后管系統(tǒng)中的某些菜單、按鈕以及列表數(shù)據(jù)的可見(jiàn)性。
本文將用 waynboot-mall 項(xiàng)目舉例,給大家介紹常見(jiàn)后管系統(tǒng)的權(quán)限控制該如何設(shè)計(jì)。大綱如下,
要理解權(quán)限控制,我們需要先了解什么是權(quán)限模型。
權(quán)限模型是指用于描述用戶(hù)、角色和權(quán)限之間關(guān)系的一種抽象模型。不同的權(quán)限模型有不同的優(yōu)缺點(diǎn),適用于不同的場(chǎng)景和需求。在本項(xiàng)目中,我們采用了 RBAC(Role-Based Access Control)模型,即基于角色的訪(fǎng)問(wèn)控制模型。
RBAC 模型的基本思想是將用戶(hù)和權(quán)限分離,通過(guò)角色作為中間層來(lái)連接用戶(hù)和權(quán)限。一個(gè)角色可以關(guān)聯(lián)多個(gè)權(quán)限,一個(gè)用戶(hù)可以擁有多個(gè)角色。這樣可以實(shí)現(xiàn)靈活的權(quán)限配置和管理,避免直接給用戶(hù)分配權(quán)限帶來(lái)的復(fù)雜性和冗余性。
RBAC 模型有多個(gè)擴(kuò)展版本,如 RBAC0、RBAC1、RBAC2 等。在本項(xiàng)目中,我們使用了 RBAC0 模型,即最基本的 RBAC 模型。RBAC0 模型包含三個(gè)要素:用戶(hù)(User)、角色(Role)和權(quán)限(Permission)。用戶(hù)是指使用系統(tǒng)的主體,角色是指一組相關(guān)的權(quán)限的集合,權(quán)限是指對(duì)系統(tǒng)資源的訪(fǎng)問(wèn)或操作能力。
在 waynboto-mall 項(xiàng)目中,RBAC0 中的權(quán)限對(duì)應(yīng)的就是菜單。菜單權(quán)限包含菜單頁(yè)面對(duì)用戶(hù)是否可見(jiàn)、頁(yè)面按鈕對(duì)用戶(hù)是否可見(jiàn)、頁(yè)面列表數(shù)據(jù)根據(jù)用戶(hù)進(jìn)行過(guò)濾等。
在 RBAC0 模型中,我們需要對(duì)用戶(hù)、角色和權(quán)限進(jìn)行定義和梳理。具體來(lái)說(shuō),我們需要確定以下幾個(gè)方面:
在 waynboto-mall 項(xiàng)目中,我做了以下的定義和梳理:
用戶(hù)來(lái)源于系統(tǒng)內(nèi)部注冊(cè)或外部導(dǎo)入,用戶(hù)有用戶(hù)名、密碼、姓名、手機(jī)號(hào)、郵箱等屬性。表結(jié)構(gòu)如下,
CREATE TABLE `sys_user` ( `user_id` bigint NOT NULL AUTO_INCREMENT COMMENT '用戶(hù)ID', `dept_id` bigint DEFAULT NULL COMMENT '部門(mén)ID', `user_name` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '用戶(hù)賬號(hào)', `nick_name` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '用戶(hù)昵稱(chēng)', `email` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '用戶(hù)郵箱', `phone` varchar(11) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '手機(jī)號(hào)碼', `sex` tinyint DEFAULT '0' COMMENT '用戶(hù)性別(0男 1女 2未知)', `avatar` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '頭像地址', `password` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '密碼', `user_status` tinyint DEFAULT '0' COMMENT '帳號(hào)狀態(tài)(0正常 1停用)', `create_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '創(chuàng)建者', `create_time` datetime DEFAULT NULL COMMENT '創(chuàng)建時(shí)間', `update_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '更新者', `update_time` datetime DEFAULT NULL COMMENT '更新時(shí)間', `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '備注', `del_flag` tinyint(1) DEFAULT '0' COMMENT '刪除標(biāo)志(0代表存在 1代表刪除)', PRIMARY KEY (`user_id`) USING BTREE, UNIQUE KEY `user_name_uqi` (`user_name`) USING BTREE) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='用戶(hù)信息表';
角色按照功能模塊進(jìn)行命名,如商品管理、訂單管理、營(yíng)銷(xiāo)管理等。角色可以分為普通角色和超級(jí)管理員角色,普通角色可以擁有部分或全部功能模塊的權(quán)限,超級(jí)管理員角色可以擁有所有功能模塊的權(quán)限,并且可以管理其他用戶(hù)和角色。表結(jié)構(gòu)如下
CREATE TABLE `sys_role` ( `role_id` bigint NOT NULL AUTO_INCREMENT COMMENT '角色I(xiàn)D', `role_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '角色名稱(chēng)', `role_key` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '角色權(quán)限字符串', `sort` int NOT NULL COMMENT '顯示順序', `role_status` tinyint NOT NULL COMMENT '角色狀態(tài)(0正常 1停用)', `create_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '創(chuàng)建者', `create_time` datetime DEFAULT NULL COMMENT '創(chuàng)建時(shí)間', `update_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '更新者', `update_time` datetime DEFAULT NULL COMMENT '更新時(shí)間', `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '備注', `del_flag` tinyint(1) DEFAULT '0' COMMENT '刪除標(biāo)志(0代表存在 1代表刪除)', PRIMARY KEY (`role_id`) USING BTREE) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='角色信息表';
超級(jí)管理員也就是 rule_key 為 admin 角色,賦予了 admin 角色用戶(hù)擁有系統(tǒng)的絕對(duì)控制能力。
權(quán)限分為頁(yè)面權(quán)限、操作權(quán)限和數(shù)據(jù)權(quán)限。頁(yè)面權(quán)限控制用戶(hù)可以看到哪些頁(yè)面或菜單,操作權(quán)限控制用戶(hù)可以在頁(yè)面上執(zhí)行哪些操作或按鈕,數(shù)據(jù)權(quán)限控制用戶(hù)可以查看或修改哪些數(shù)據(jù)或范圍。表結(jié)構(gòu)如下,
CREATE TABLE `sys_menu` ( `menu_id` bigint NOT NULL AUTO_INCREMENT COMMENT '菜單ID', `menu_name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '菜單名稱(chēng)', `parent_id` bigint DEFAULT '0' COMMENT '父菜單ID', `sort` int DEFAULT '0' COMMENT '顯示順序', `path` varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '路由地址', `component` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '組件路徑', `is_frame` tinyint DEFAULT '1' COMMENT '是否為外鏈(0是 1否)', `menu_type` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '菜單類(lèi)型(M目錄 C菜單 F按鈕)', `menu_status` tinyint DEFAULT NULL COMMENT '菜單狀態(tài)(0啟用 1禁用)', `visible` tinyint DEFAULT '0' COMMENT '顯示狀態(tài)(0顯示 1隱藏)', `perms` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '權(quán)限標(biāo)識(shí)', `icon` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '#' COMMENT '菜單圖標(biāo)', `create_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '創(chuàng)建者', `create_time` datetime DEFAULT NULL COMMENT '創(chuàng)建時(shí)間', `update_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '更新者', `update_time` datetime DEFAULT NULL COMMENT '更新時(shí)間', `remark` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT '' COMMENT '備注', PRIMARY KEY (`menu_id`) USING BTREE) ENGINE=InnoDB AUTO_INCREMENT=2055 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='菜單權(quán)限表';
用戶(hù)與角色之間是多對(duì)多的關(guān)聯(lián)方式,即一個(gè)用戶(hù)可以擁有多個(gè)角色,一個(gè)角色可以分配給多個(gè)用戶(hù)。角色與權(quán)限之間也是多對(duì)多的關(guān)聯(lián)方式,即一個(gè)角色可以擁有多個(gè)權(quán)限,一個(gè)權(quán)限可以分配給多個(gè)角色。用戶(hù)角色關(guān)聯(lián)表、角色菜單關(guān)聯(lián)表結(jié)構(gòu)如下,
CREATE TABLE `sys_user_role` ( `user_id` bigint NOT NULL COMMENT '用戶(hù)ID', `role_id` bigint NOT NULL COMMENT '角色I(xiàn)D', PRIMARY KEY (`user_id`,`role_id`) USING BTREE) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='用戶(hù)和角色關(guān)聯(lián)表';CREATE TABLE `sys_role_menu` ( `role_id` bigint NOT NULL COMMENT '角色I(xiàn)D', `menu_id` bigint NOT NULL COMMENT '菜單ID', PRIMARY KEY (`role_id`,`menu_id`) USING BTREE) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci ROW_FORMAT=DYNAMIC COMMENT='角色和菜單關(guān)聯(lián)表';
waynboot-mall 項(xiàng)目的后臺(tái)權(quán)限系統(tǒng)設(shè)計(jì)相關(guān) er 圖如下,
當(dāng)我們理解清楚后權(quán)限模型后,就該進(jìn)行具體的權(quán)限分配了。在進(jìn)行權(quán)限分配時(shí),我們需要遵循以下幾個(gè)原則:
在 waynboto-mall 項(xiàng)目中,我們采用了以下幾種方式來(lái)進(jìn)行權(quán)限分配:
通過(guò)給用戶(hù)分配角色來(lái)實(shí)現(xiàn)權(quán)限分配:這是最常見(jiàn)和最基本的方式,通過(guò)勾選用戶(hù)擁有的角色來(lái)控制用戶(hù)擁有的權(quán)限。
通過(guò)給角色分配權(quán)限來(lái)實(shí)現(xiàn)權(quán)限分配:這是最靈活和最細(xì)粒度的方式,通過(guò)勾選角色擁有的權(quán)限來(lái)控制角色擁有的權(quán)限。
通過(guò)設(shè)置超級(jí)管理員角色(role_key 為 admin)來(lái)實(shí)現(xiàn)全局權(quán)限管理:這是最簡(jiǎn)單和最高效的方式,通過(guò)設(shè)置一個(gè)超級(jí)管理員來(lái)控制所有功能模塊和數(shù)據(jù)范圍的訪(fǎng)問(wèn)和操作。
waynboot-mall 項(xiàng)目的訪(fǎng)問(wèn)控制框架是采用的 Spring Security 3.0版本。我在這里給大家先介紹 Spring Security 的相關(guān)知識(shí)以及 3.0 版本中的配置類(lèi)代碼編寫(xiě)。
Spring Security 是一個(gè)基于 Spring 框架的開(kāi)源項(xiàng)目,旨在為 Java 應(yīng)用程序提供強(qiáng)大和靈活的安全性解決方案。Spring Security 提供了以下特性:
在 waynboot-mall 項(xiàng)目中直接引入 spring-boot-starter-security 依賴(lài),
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId> <version>3.1.0</version> </dependency></dependencies>
在 Spring Security 3.0 中要配置 Spring Security 跟以往是有些不同的,比如不在繼承 WebSecurityConfigurerAdapter。在 waynboot-mall 項(xiàng)目中,具體配置如下,
@Configuration@EnableWebSecurity@AllArgsConstructor@EnableMethodSecurity(securedEnabled = true, jsr250Enabled = true)public class SecurityConfig { private UserDetailsServiceImpl userDetailsService; private AuthenticationEntryPointImpl unauthorizedHandler; private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; private LogoutSuccessHandlerImpl logoutSuccessHandler; @Bean public SecurityFilterChain filterChain(HttpSecurity httpSecurity) throws Exception { httpSecurity // cors啟用 .cors(httpSecurityCorsConfigurer -> {}) .csrf(AbstractHttpConfigurer::disable) .sessionManagement(httpSecuritySessionManagementConfigurer -> { httpSecuritySessionManagementConfigurer.sessionCreationPolicy(SessionCreationPolicy.STATELESS); }) .exceptionHandling(httpSecurityExceptionHandlingConfigurer -> { httpSecurityExceptionHandlingConfigurer.authenticationEntryPoint(unauthorizedHandler); }) // 過(guò)濾請(qǐng)求 .authorizeHttpRequests(authorizationManagerRequestMatcherRegistry -> { authorizationManagerRequestMatcherRegistry .requestMatchers("/favicon.ico", "/login", "/favicon.ico", "/actuator/**").anonymous() .requestMatchers("/slider/**").anonymous() .requestMatchers("/captcha/**").anonymous() .requestMatchers("/upload/**").anonymous() .requestMatchers("/common/download**").anonymous() .requestMatchers("/doc.html").anonymous() .requestMatchers("/swagger-ui/**").anonymous() .requestMatchers("/swagger-resources/**").anonymous() .requestMatchers("/webjars/**").anonymous() .requestMatchers("/*/api-docs").anonymous() .requestMatchers("/druid/**").anonymous() .requestMatchers("/elastic/**").anonymous() .requestMatchers("/message/**").anonymous() .requestMatchers("/ws/**").anonymous() // 除上面外的所有請(qǐng)求全部需要鑒權(quán)認(rèn)證 .anyRequest().authenticated(); }) .headers(httpSecurityHeadersConfigurer -> { httpSecurityHeadersConfigurer.frameOptions(HeadersConfigurer.FrameOptionsConfig::disable); }); // 處理跨域請(qǐng)求中的Preflight請(qǐng)求(cors),設(shè)置corsConfigurationSource后無(wú)需使用 // .requestMatchers(CorsUtils::isPreFlightRequest).permitAll() // 對(duì)于登錄login 驗(yàn)證碼captchaImage 允許匿名訪(fǎng)問(wèn) httpSecurity.logout(httpSecurityLogoutConfigurer -> { httpSecurityLogoutConfigurer.logoutUrl("/logout"); httpSecurityLogoutConfigurer.logoutSuccessHandler(logoutSuccessHandler); }); // 添加JWT filter httpSecurity.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); // 認(rèn)證用戶(hù)時(shí)用戶(hù)信息加載配置,注入springAuthUserService httpSecurity.userDetailsService(userDetailsService); return httpSecurity.build(); } @Bean public AuthenticationManager authenticationManager(AuthenticationConfiguration authenticationConfiguration) throws Exception { return authenticationConfiguration.getAuthenticationManager(); } /** * 強(qiáng)散列哈希加密實(shí)現(xiàn) */ @Bean public BCryptPasswordEncoder bCryptPasswordEncoder() { return new BCryptPasswordEncoder(); }}
這里詳細(xì)介紹下 SecurityConfig 配置類(lèi),
要使用 Spring Security,只需要在需要控制訪(fǎng)問(wèn)權(quán)限的方法或類(lèi)上添加相應(yīng)的 @PreAuthorize 注解即可,如下,
@Slf4j@RestController@AllArgsConstructor@RequestMapping("system/role")public class RoleController extends BaseController { private IRoleService iRoleService; @PreAuthorize("@ss.hasPermi('system:role:list')") @GetMapping("/list") public R list(Role role) { Page<Role> page = getPage(); return R.success().add("page", iRoleService.listPage(page, role)); }}
我們?cè)?list 方法上加了 @PreAuthorize("@ss.hasPermi('system:role:list')") 注解表示當(dāng)前登錄用戶(hù)擁有 system:role:list 權(quán)限才能訪(fǎng)問(wèn) list 方法,否則返回權(quán)限錯(cuò)誤。
在 SecurityConfig 配置類(lèi)中我們定義了 UserDetailsServiceImpl 作為我們的用戶(hù)信息加載的實(shí)現(xiàn)類(lèi),從而通過(guò)讀取數(shù)據(jù)庫(kù)中用戶(hù)的賬號(hào)、密碼與前端傳入的賬號(hào)、密碼進(jìn)行比對(duì)。代碼如下,
@Slf4j@Service@AllArgsConstructorpublic class UserDetailsServiceImpl implements UserDetailsService { private IUserService iUserService; private IDeptService iDeptService; private PermissionService permissionService; public static void main(String[] args) { BCryptPasswordEncoder bCryptPasswordEncoder = new BCryptPasswordEncoder(); System.out.println(bCryptPasswordEncoder.encode("123456")); } @Override public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { // 1. 讀取數(shù)據(jù)庫(kù)中當(dāng)前用戶(hù)信息 User user = iUserService.getOne(new QueryWrapper<User>().eq("user_name", username)); // 2. 判斷該用戶(hù)是否存在 if (user == null) { log.info("登錄用戶(hù):{} 不存在.", username); throw new UsernameNotFoundException("登錄用戶(hù):" + username + " 不存在"); } // 3. 判斷是否禁用 if (Objects.equals(UserStatusEnum.DISABLE.getCode(), user.getUserStatus())) { log.info("登錄用戶(hù):{} 已經(jīng)被停用.", username); throw new DisabledException("登錄用戶(hù):" + username + " 不存在"); } user.setDept(iDeptService.getById(user.getDeptId())); // 4. 獲取當(dāng)前用戶(hù)的角色信息 Set<String> rolePermission = permissionService.getRolePermission(user); // 5. 根據(jù)角色獲取權(quán)限信息 Set<String> menuPermission = permissionService.getMenuPermission(rolePermission); return new LoginUserDetail(user, menuPermission); }}
針對(duì) UserDetailsServiceImpl 的代碼邏輯進(jìn)行一個(gè)講解。
本文給大家講解了常見(jiàn)后管系統(tǒng)的權(quán)限控制系統(tǒng)該如何設(shè)計(jì)以及 Spring Security 實(shí)戰(zhàn),在常用的 RBAC0 權(quán)限模型下,權(quán)限要素包含用戶(hù)、角色、權(quán)限(菜單)三要素,只要大家能理解用戶(hù)、角色、權(quán)限(菜單)三要素的設(shè)計(jì)理念以及表結(jié)構(gòu)后,相信就能輕松掌握后管權(quán)限控制系統(tǒng)的設(shè)計(jì)精髓。
想要獲取 waynboot-mall 項(xiàng)目源碼的同學(xué),可以關(guān)注我公眾號(hào)【程序員wayn】,回復(fù) waynboot-mall 即可獲得。
本文鏈接:http://www.www897cc.com/showinfo-26-75341-0.html終于有篇文章把后管權(quán)限系統(tǒng)設(shè)計(jì)講清楚了
聲明:本網(wǎng)頁(yè)內(nèi)容旨在傳播知識(shí),若有侵權(quán)等問(wèn)題請(qǐng)及時(shí)與本網(wǎng)聯(lián)系,我們將在第一時(shí)間刪除處理。郵件:2376512515@qq.com
上一篇: PyTimeTK:一個(gè)簡(jiǎn)單有效的時(shí)間序列分析庫(kù)
下一篇: FFmpeg前端視頻合成實(shí)踐