Spring Secutity和Apache Shiro是Java領(lǐng)域的兩大主流開(kāi)源安全框架，也是權(quán)限系統(tǒng)設(shè)計(jì)的主要技術(shù)選型。本文主要介紹Spring Secutity的實(shí)現(xiàn)原理，并基于Spring Secutity設(shè)計(jì)基于RBAC的權(quán)限系統(tǒng)。

[[284792]]

一、技術(shù)選型

1. 為何把Spring Secutity作為權(quán)限系統(tǒng)的技術(shù)選型，主要考慮了以下幾個(gè)方面：
2. 數(shù)據(jù)鑒權(quán)的能力：Spring Secutity支持?jǐn)?shù)據(jù)鑒權(quán)，即細(xì)粒度權(quán)限控制。
3. Spring生態(tài)基礎(chǔ)：Spring Secutity可以和Spring生態(tài)無(wú)縫集成。

多樣認(rèn)證能力：Spring Secutity支持多樣認(rèn)證方式，如預(yù)認(rèn)證方式可以與第三方認(rèn)證系統(tǒng)集成。

二、核心架構(gòu)

權(quán)限系統(tǒng)一般包含兩大核心模塊：認(rèn)證(Authentication)和鑒權(quán)(Authorization)。

• 認(rèn)證：認(rèn)證模塊負(fù)責(zé)驗(yàn)證用戶身份的合法性，生成認(rèn)證令牌，并保存到服務(wù)端會(huì)話中(如TLS)。
• 鑒權(quán)：鑒權(quán)模塊負(fù)責(zé)從服務(wù)端會(huì)話內(nèi)獲取用戶身份信息，與訪問(wèn)的資源進(jìn)行權(quán)限比對(duì)。

官方給出的Spring Security的核心架構(gòu)圖如下：

核心架構(gòu)解讀：

• AuthenticationManager：負(fù)責(zé)認(rèn)證管理，解析用戶登錄信息(封裝在Authentication)，讀取用戶、角色、權(quán)限信息進(jìn)行認(rèn)證，認(rèn)證結(jié)果被回填到Authentication，保存在SecurityContext。
• AccessDecisionManager：負(fù)責(zé)鑒權(quán)投票表決，匯總投票器的結(jié)果，實(shí)現(xiàn)一票通過(guò)(默認(rèn))、多票通過(guò)、一票否決策略。
• SecurityInterceptor：負(fù)責(zé)權(quán)限攔截，包括Web URL攔截和方法調(diào)用攔截。通過(guò)ConfigAttributes獲取資源的描述信息，借助于AccessDecisionManager進(jìn)行鑒權(quán)攔截。
• SecurityContext：安全上下文，保存認(rèn)證結(jié)果。提供了全局上下文、線程繼承上下文、線程獨(dú)立上下文(默認(rèn))三種策略。
• Authentication：認(rèn)證信息，保存用戶的身份標(biāo)示、權(quán)限列表、證書(shū)、認(rèn)證通過(guò)標(biāo)記等信息。
• SecuredResource：被安全管控的資源，如Web URL、用戶、角色、自定義領(lǐng)域?qū)ο蟮取?/li>
• ConfigAttributes：資源屬性配置，描述安全管控資源的信息，為SecurityInterceptor提供攔截邏輯的輸入。

三、設(shè)計(jì)原理

通過(guò)對(duì)源碼的分析，我把Spring Security的核心領(lǐng)域模型設(shè)計(jì)整理如下：

全局抽象模型解讀：

• 配置：AuthenticationConfiguration負(fù)責(zé)認(rèn)證系統(tǒng)的全局配置，GlobalMethodSecurityConfiguration負(fù)責(zé)方法調(diào)用攔截的全局配置。
• 構(gòu)建：AuthenticationConfiguration通過(guò)AuthenticationManagerBuilder構(gòu)建認(rèn)證管理器AuthenticationManager，GlobalMethodSecurityConfiguration會(huì)自動(dòng)初始化AbstractSecurityInterceptor進(jìn)行方法調(diào)用攔截。
• Web攔截：HttpSecurity對(duì)Web進(jìn)行安全配置，內(nèi)置了大量GenericFilterBean過(guò)濾器對(duì)URL進(jìn)行攔截。負(fù)責(zé)認(rèn)證的過(guò)濾器會(huì)通過(guò)AuthenticationManager進(jìn)行認(rèn)證，并將認(rèn)證結(jié)果保存到SecurityContext。
• 方法攔截：Spring通過(guò)AOP技術(shù)(cglib/aspectj)對(duì)標(biāo)記為@PreAuthorize、@PreFilter、@PostAuthorize、@PostFilter等注解的方法進(jìn)行攔截，通過(guò)AbstractSecurityInterceptor調(diào)用AuthenticationManager進(jìn)行身份認(rèn)證(如果必要的話)。
• 認(rèn)證：認(rèn)證管理器AuthenticationManager內(nèi)置了多種認(rèn)證器AuthenticationProvider，只要其中一個(gè)認(rèn)證通過(guò)，認(rèn)證便成功。不同的AuthenticationProvider獲取各自需要的信息(HTTP請(qǐng)求、數(shù)據(jù)庫(kù)查詢、遠(yuǎn)程服務(wù)等)進(jìn)行認(rèn)證，認(rèn)證結(jié)果全部封裝在Authentication。需要加載用戶、角色、權(quán)限信息的認(rèn)證器(如密碼認(rèn)證、預(yù)認(rèn)證等)需要對(duì)接UserDetailsManager接口實(shí)現(xiàn)用戶CRUD功能。
• 鑒權(quán)：權(quán)限攔截器AbstractSecurityInterceptor通過(guò)讀取不同的SecurityMetadataSource加載需要被鑒權(quán)資源的描述信息ConfigAttribute，然后把認(rèn)證信息Authentication、資源描述ConfigAttribute、資源對(duì)象本身傳遞給AccessDecisionManager進(jìn)行表決。AccessDecisionManager內(nèi)置了多個(gè)投票器AccessDecisionVoter，投票器會(huì)將鑒權(quán)信息中的ConfigAttribute轉(zhuǎn)換為SpringEL的格式，通過(guò)表達(dá)式處理器SecurityExpressionHandler執(zhí)行基于表達(dá)式的鑒權(quán)邏輯，鑒權(quán)邏輯會(huì)通過(guò)反射的方式轉(zhuǎn)發(fā)到SecurityExpressionRoot的各個(gè)操作上去。
• 定制：通過(guò)WebSecurityConfigureAdapter可以定制HTTP安全配置HttpSecurity和認(rèn)證管理器生成器AuthenticationManagerBuilder;通過(guò)AbstractPreAuthenticatedProcessingFilter可以定制預(yù)認(rèn)證過(guò)濾器;通過(guò)UserDetailsManager和UserDetails接口可以對(duì)接自定義數(shù)據(jù)源;通過(guò)GrantedAuthority定制權(quán)限信息;通過(guò)PermissionEvaluator可以定制自定義領(lǐng)域模型的訪問(wèn)控制邏輯。

四、應(yīng)用集成

理清Spring Security的定制點(diǎn)后，就可以在系統(tǒng)內(nèi)部集成Spring Security了。

這里使用預(yù)認(rèn)證的方式，以適配第三方認(rèn)證系統(tǒng)。AbstractPreAuthenticatedProcessingFilter提供了預(yù)認(rèn)證的擴(kuò)展點(diǎn)，基于該抽象類實(shí)現(xiàn)一個(gè)自定義認(rèn)證過(guò)濾器。

public class MyPreAuthFilter extends AbstractPreAuthenticatedProcessingFilter { 
 @Override 
 protected Object getPreAuthenticatedPrincipal(HttpServletRequest request) { 
 // 從第三方系統(tǒng)獲取用戶ID 
 return userId; 
 } 
 @Override 
 protected Object getPreAuthenticatedCredentials(HttpServletRequest request) { 
 return ""; 
 } 
} 

Spring Security會(huì)根據(jù)預(yù)認(rèn)證過(guò)濾器getPreAuthenticatedPrincipal返回的用戶ID信息，加載用戶角色等初始信息。這里需要實(shí)現(xiàn)UserDetailsManager接口，提供用戶信息管理器。

@Service 
public class MyUserManager implements UserDetailsManager { 
 @Override 
 public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { 
 // 從數(shù)據(jù)庫(kù)加載用戶信息 
 return user; 
 } 
  
 // 其他管理接口 
} 

UserDetails內(nèi)包含了GrantedAuthority接口類型的權(quán)限信息抽象，一般可以基于它自定義角色和權(quán)限。Spring Security使用一種接口形式表達(dá)角色和權(quán)限，角色和權(quán)限的差別是角色的ID是以"ROLE_"為前綴。

public class MyRole implements GrantedAuthority { 
 private final String role; 
 @Override 
 public String getAuthority() { 
 return "ROLE_" + role; 
 } 
} 
public class MyAuthority implements GrantedAuthority { 
 private final String authority; 
 @Override 
 public String getAuthority() { 
 return authority; 
 } 
} 

接下來(lái)注冊(cè)自定義認(rèn)證過(guò)濾器和用戶管理器，這里需要實(shí)現(xiàn)WebSecurityConfigurerAdapter進(jìn)行Web安全配置。

@EnableWebSecurity 
@EnableGlobalMethodSecurity(prePostEnabled = true, mode = AdviceMode.PROXY) 
public class MySecurityConfig extends WebSecurityConfigurerAdapter { 
 @Autowired 
 UserDetailsManager userDetailsManager; 
 @Bean 
 protected AuthenticationProvider createPreAuthProvider() { 
 // 注冊(cè)用戶管理器 
 PreAuthenticatedAuthenticationProvider provider = new PreAuthenticatedAuthenticationProvider(); 
 provider.setPreAuthenticatedUserDetailsService(new UserDetailsByNameServiceWrapper<>(userDetailsManager)); 
 return provider; 
 } 
 @Override 
 protected void configure(HttpSecurity http) throws Exception { 
 // 注冊(cè)預(yù)認(rèn)證過(guò)濾器 
 http.addFilter(new MyPreAuthFilter(authenticationManager())); 
 } 
} 

這樣，最簡(jiǎn)單的Spring Security框架集成內(nèi)系統(tǒng)內(nèi)部已經(jīng)完成了。在系統(tǒng)的任意服務(wù)接口上可以使用如下方式進(jìn)行鑒權(quán)。

public interface MyService { 
 @PreAuthorize("hasAuthority('QUERY')") 
 Object getById(String id); 
  
 @PreAuthorize("hasRole('ADMIN')") 
 void deleteById(String id); 
} 

PreAuthorize注解表示調(diào)用前鑒權(quán)，Spring使用默認(rèn)使用動(dòng)態(tài)代理技術(shù)生成鑒權(quán)邏輯。注解內(nèi)配置了SpringEL表達(dá)式來(lái)定制鑒權(quán)方式。上述代碼中，hasAuthority會(huì)檢查用戶是否有QUERY權(quán)限，hasRole會(huì)檢查用戶是否有ADMIN角色。

使用動(dòng)態(tài)代理的方式進(jìn)行AOP，只允許在接口層面進(jìn)行權(quán)限攔截，如果想在任意的方法上進(jìn)行權(quán)限攔截，那么就需要借助于AspectJ的方式進(jìn)行AOP。首先將注解EnableGlobalMethodSecurity的mode設(shè)置為AdviceMode.ASPECTJ，然后添加JVM啟動(dòng)參數(shù)，這樣就可以在任意方法上使用Spring Security的注解了。

javaagent:/path/to/org/aspectj/aspectjweaver/1.9.4/aspectjweaver-1.9.4.jar 

以上還是只是以用戶的身份信息(角色/權(quán)限)進(jìn)行權(quán)限，靈活度有限，也發(fā)揮不了Spring Security的數(shù)據(jù)鑒權(quán)的能力。要使用數(shù)據(jù)鑒權(quán)，需要實(shí)現(xiàn)一個(gè)Spring Bean。

@Component 
public class MyPermissionEvaluator implements PermissionEvaluator { 
 @Override 
 public boolean hasPermission(Authentication authentication, Object targetDomainObject, Object permission) { 
 // 自定義數(shù)據(jù)鑒權(quán) 
 return false; 
 } 
 @Override 
 public boolean hasPermission(Authentication authentication, Serializable targetId, String targetType, Object permission) { 
 // 自定義數(shù)據(jù)鑒權(quán) 
 return false; 
 } 
} 

PermissionEvaluator會(huì)被自動(dòng)注冊(cè)到Spring Security框架，并允許在注解內(nèi)使用如下方式進(jìn)行鑒權(quán)。

@PreAuthorize("hasPermission(#id, 'QUERY')") 
Object func1(String id) { 
} 
@PreAuthorize("hasPermission(#id, 'TABLE', 'QUERY')") 
Object func2(String id) { 
} 

其中，func1的注解表示校驗(yàn)用戶是否對(duì)id有QUERY權(quán)限，代碼邏輯路由到MyPermissionEvaluator的第一個(gè)接口。func2的注解表示校驗(yàn)用戶是否對(duì)TABLE類型的id有QUERY權(quán)限，代碼邏輯路由到MyPermissionEvaluator的第二個(gè)接口。PermissionEvaluator提供了權(quán)限系統(tǒng)中數(shù)據(jù)鑒權(quán)的擴(kuò)展點(diǎn)，稍后會(huì)描述如何利用該擴(kuò)展點(diǎn)定制基于RBAC的權(quán)限系統(tǒng)。

五、權(quán)限系統(tǒng)

構(gòu)建基于RBAC(Role Based Access Control)的權(quán)限系統(tǒng)，需要明確用戶、角色、權(quán)限、資源這幾個(gè)核心的概念類的含義和它們之間的關(guān)系。

資源：權(quán)限系統(tǒng)內(nèi)需要安全控制的客體，一般是系統(tǒng)內(nèi)的數(shù)據(jù)或功能。

權(quán)限：描述了資源上的操作抽象，一般是一種動(dòng)作。

授權(quán)：是權(quán)限和資源的組合，表示對(duì)資源的某一個(gè)操作。

角色：描述了一組授權(quán)的集合，表示一類特殊概念的功能集。

用戶：權(quán)限系統(tǒng)的主體，一般是當(dāng)前系統(tǒng)的訪問(wèn)用戶，用戶可以擁有多種角色。

以下是我們?cè)O(shè)計(jì)的基于RABC的權(quán)限核心領(lǐng)域模型：

一般情況下，系統(tǒng)內(nèi)需要權(quán)限管控的資源是無(wú)法用戶自定義的，因?yàn)橘Y源會(huì)耦合大量的業(yè)務(wù)邏輯，所以我們提供了自 資源工廠，通過(guò)配置化的方式構(gòu)建業(yè)務(wù)模塊所需的資源。而用戶、角色、權(quán)限，以及授權(quán)記錄都是可以通過(guò)相應(yīng)的管理器進(jìn)行查詢更新。

另外，資源抽象允許表達(dá)資源的繼承和組合關(guān)系，繼而表達(dá)更復(fù)雜的資源模型，資源統(tǒng)一鑒權(quán)的流程為：

• 執(zhí)行鑒權(quán)時(shí)，首先看資源是原子資源還是組合資源。
• 對(duì)于原子資源，先查詢是否有授權(quán)記錄，再查看角色預(yù)授權(quán)是否包含當(dāng)前授權(quán)，存在一種便成功。
• 沒(méi)有授權(quán)記錄和角色預(yù)授權(quán)的原子資源，嘗試用父資源(如果有的話)代替鑒權(quán)，否則鑒權(quán)失敗。
• 對(duì)于組合資源，先進(jìn)行資源展開(kāi)，獲取子資源列表。
• 遍歷子資源列表，并依次對(duì)子資源進(jìn)行鑒權(quán)，子資源鑒權(quán)結(jié)果匯總后，即組合資源鑒權(quán)結(jié)果。
• 綜上，基于統(tǒng)一資源抽象和資源配置化構(gòu)建，可以實(shí)現(xiàn)資源的統(tǒng)一構(gòu)建，繼而實(shí)現(xiàn)統(tǒng)一鑒權(quán)。

六、總結(jié)回顧

本文從Spring Security的架構(gòu)和原理出發(fā)，描述了開(kāi)源安全框架對(duì)于認(rèn)證和鑒權(quán)模塊的設(shè)計(jì)思路和細(xì)節(jié)。并提供了系統(tǒng)內(nèi)集成Spring Security的方法，結(jié)合RBAC通用權(quán)限系統(tǒng)模型，討論了統(tǒng)一資源構(gòu)建和統(tǒng)一鑒權(quán)的設(shè)計(jì)和實(shí)現(xiàn)。如果你也需要設(shè)計(jì)一個(gè)新的權(quán)限系統(tǒng)，希望本文對(duì)你有所幫助。