實(shí)戰(zhàn)!Spring Cloud Gateway集成 Rbac 權(quán)限模型實(shí)現(xiàn)動(dòng)態(tài)權(quán)限控制!
這篇文章介紹下網(wǎng)關(guān)層如何集成RBAC權(quán)限模型進(jìn)行認(rèn)證鑒權(quán),文章目錄如下:
什么是RBAC權(quán)限模型?
RBAC(Role-Based Access Control)基于角色訪問控制,目前使用最為廣泛的權(quán)限模型。
相信大家對(duì)這種權(quán)限模型已經(jīng)比較了解了。此模型有三個(gè)用戶、角色和權(quán)限,在傳統(tǒng)的權(quán)限模型用戶直接關(guān)聯(lián)加了角色層,解耦了用戶和權(quán)限,使得權(quán)限系統(tǒng)有了更清晰的職責(zé)劃分和更高的靈活度。
以上五張表的SQL就不再詳細(xì)貼出來了,都會(huì)放在案例源碼的doc目錄下,如下圖:
設(shè)計(jì)思路
RBAC權(quán)限模型是基于角色的,因此在Spring Security中的權(quán)限就是角色,具體的認(rèn)證授權(quán)流程如下:
- 用戶登錄申請(qǐng)令牌
- 通過UserDetailService查詢、加載用戶信息、比如密碼、權(quán)限(角色)....封裝到UserDetails中
- 令牌申請(qǐng)成功,攜帶令牌訪問資源
- 網(wǎng)關(guān)層面比較訪問的URL所需要的權(quán)限(Redis中)是否與當(dāng)前令牌具備的權(quán)限有交集。有交集則表示具備訪問該URL的權(quán)限。
- 具備權(quán)限則訪問,否則拒絕
上述只是大致的流程,其中還有一些細(xì)節(jié)有待商榷,如下:
1、URL對(duì)應(yīng)的權(quán)限如何維護(hù)?
這個(gè)就比較容易實(shí)現(xiàn)了,涉及到RBAC權(quán)限模式的三張表,分別為權(quán)限表、角色表、權(quán)限角色對(duì)應(yīng)關(guān)系表。具體實(shí)現(xiàn)流程如下:
項(xiàng)目啟動(dòng)時(shí)將權(quán)限(URL)和角色的對(duì)應(yīng)關(guān)系加載到Redis中。
對(duì)于管理界面涉及到URL相應(yīng)關(guān)系的變動(dòng)要實(shí)時(shí)的變更到Redis。
比如權(quán)限中有這么一條數(shù)據(jù),如下:
其中的 /order/info 這個(gè)URL就是一個(gè)權(quán)限,管理員可以對(duì)其分配給指定的角色。
2、如何實(shí)現(xiàn)Restful風(fēng)格的權(quán)限控制?
restful風(fēng)格的接口URL是相同的,不同的只是請(qǐng)求方式,因此要想做到權(quán)限的精細(xì)控制還需要保留請(qǐng)求方式,比如POST,GET,PUT,DELETE....
可以在權(quán)限表中的url字段放置一個(gè)method標(biāo)識(shí),比如POST,此時(shí)的完整URL為:POST:/order/info
當(dāng)然*:/order/info中的星號(hào)表示一切請(qǐng)求方式都滿足。
3、這樣能實(shí)現(xiàn)動(dòng)態(tài)權(quán)限控制嗎?
權(quán)限的控制方式有很多種,比如Security自身的注解、方法攔截,其實(shí)擴(kuò)展Spring Security也是可以實(shí)現(xiàn)動(dòng)態(tài)權(quán)限控制的,這個(gè)在后面的文章中會(huì)單獨(dú)介紹!
陳某此篇文章是將權(quán)限、角色對(duì)應(yīng)關(guān)系存入Redis中,因此想要實(shí)現(xiàn)動(dòng)態(tài)權(quán)限控制只需要在Redis中維護(hù)這種關(guān)系即可。Redis中的數(shù)據(jù)如下:
案例實(shí)現(xiàn)
此篇文章還是基于以下三個(gè)模塊進(jìn)行改動(dòng),有不清楚的可以查看陳某往期文章。
名稱 | 功能 |
---|---|
oauth2-cloud-auth-server | OAuth2.0認(rèn)證授權(quán)服 |
oauth2-cloud-gateway | 網(wǎng)關(guān)服務(wù) |
oauth2-cloud-auth-common | 公共模塊 |
涉及到的更改目錄如下圖:
1、從數(shù)據(jù)庫(kù)加載URL<->角色對(duì)應(yīng)關(guān)系到Redis
在項(xiàng)目啟動(dòng)之初直接讀取數(shù)據(jù)庫(kù)中的權(quán)限加載到Redis中,當(dāng)然方法有很多種,自己根據(jù)情況選擇。代碼如下:
此處代碼在oauth2-cloud-auth-server模塊下。
案例源碼已經(jīng)上傳GitHub,關(guān)注公眾號(hào):碼猿技術(shù)專欄,回復(fù)關(guān)鍵詞:9529 獲取!
2、實(shí)現(xiàn)UserDetailsService加載權(quán)限
UserDetailsService相信大家都已經(jīng)很熟悉了,主要作用就是根據(jù)用戶名從數(shù)據(jù)庫(kù)中加載用戶的詳細(xì)信息。
代碼如下:
①處的代碼是將通過JPA從數(shù)據(jù)庫(kù)中查詢用戶信息并且組裝角色,必須是以 ROLE_ 開頭。
②處的代碼是將獲取的角色封裝進(jìn)入authorities向下傳遞。
此處代碼在oauth2-cloud-auth-server模塊下。
案例源碼已經(jīng)上傳GitHub,關(guān)注公眾號(hào):碼猿技術(shù)專欄,回復(fù)關(guān)鍵詞:9529 獲取!
3、鑒權(quán)管理器中校驗(yàn)權(quán)限
在上篇文章中實(shí)戰(zhàn)干貨!Spring Cloud Gateway 整合 OAuth2.0 實(shí)現(xiàn)分布式統(tǒng)一認(rèn)證授權(quán)!詳細(xì)介紹了鑒權(quán)管理器的作用,這里就不再細(xì)說了。代碼如下:
①處的代碼是將請(qǐng)求URL組裝成restful風(fēng)格的,比如POST:/order/info
②處的代碼是從Redis中取出URL和角色對(duì)應(yīng)關(guān)系遍歷,通過AntPathMatcher進(jìn)行比對(duì),獲取當(dāng)前請(qǐng)求URL的所需的角色。
③處的代碼就是比較當(dāng)前URL所需的角色和當(dāng)前用戶的角色,分為兩步:
如果是超級(jí)管理員,則直接放行,不必比較權(quán)限
不是超級(jí)管理員就需要比較角色,有交集才能放行
此處的代碼在oauth2-cloud-gateway模塊中。
案例源碼已經(jīng)上傳GitHub,關(guān)注公眾號(hào):碼猿技術(shù)專欄,回復(fù)關(guān)鍵詞:9529 獲取!
4、總結(jié)
關(guān)鍵代碼就是上述三處,另外關(guān)于一些DAO層的相關(guān)代碼就不再貼出來了,自己下載源碼看看!
案例源碼已經(jīng)上傳GitHub,關(guān)注公眾號(hào):碼猿技術(shù)專欄,回復(fù)關(guān)鍵詞:9529 獲取!
附加的更改
這篇文章中順帶將客戶端信息也放在了數(shù)據(jù)庫(kù)中,前面的文章都是放在內(nèi)存中。
數(shù)據(jù)庫(kù)中新建一張表,SQL如下:
- CREATE TABLE `oauth_client_details` (
- `client_id` varchar(48) NOT NULL COMMENT '客戶端id',
- `resource_ids` varchar(256) DEFAULT NULL COMMENT '資源的id,多個(gè)用逗號(hào)分隔',
- `client_secret` varchar(256) DEFAULT NULL COMMENT '客戶端的秘鑰',
- `scope` varchar(256) DEFAULT NULL COMMENT '客戶端的權(quán)限,多個(gè)用逗號(hào)分隔',
- `authorized_grant_types` varchar(256) DEFAULT NULL COMMENT '授權(quán)類型,五種,多個(gè)用逗號(hào)分隔',
- `web_server_redirect_uri` varchar(256) DEFAULT NULL COMMENT '授權(quán)碼模式的跳轉(zhuǎn)uri',
- `authorities` varchar(256) DEFAULT NULL COMMENT '權(quán)限,多個(gè)用逗號(hào)分隔',
- `access_token_validity` int(11) DEFAULT NULL COMMENT 'access_token的過期時(shí)間,單位毫秒,覆蓋掉硬編碼',
- `refresh_token_validity` int(11) DEFAULT NULL COMMENT 'refresh_token的過期時(shí)間,單位毫秒,覆蓋掉硬編碼',
- `additional_information` varchar(4096) DEFAULT NULL COMMENT '擴(kuò)展字段,JSON',
- `autoapprove` varchar(256) DEFAULT NULL COMMENT '默認(rèn)false,是否自動(dòng)授權(quán)',
- PRIMARY KEY (`client_id`)
- ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
認(rèn)證服務(wù)中的OAuth2.0的配置文件中將客戶端的信息從數(shù)據(jù)庫(kù)中加載,該實(shí)現(xiàn)類為JdbcClientDetailsService,關(guān)鍵代碼如下:
- @Override
- public void configure(ClientDetailsServiceConfigurer clients) throws Exception {
- //使用JdbcClientDetailsService,從數(shù)據(jù)庫(kù)中加載客戶端的信息
- clients.withClientDetails(new JdbcClientDetailsService(dataSource));
- }
總結(jié)
本篇文章介紹了網(wǎng)關(guān)集成RBAC權(quán)限模型進(jìn)行認(rèn)證鑒權(quán),核心思想就是將權(quán)限信息加載Redis緩存中,在網(wǎng)關(guān)層面的鑒權(quán)管理器中進(jìn)行權(quán)限的校驗(yàn),其中還整合了Restful風(fēng)格的URL。