自公號:Felordcn
1. 前言
上一文我們使用 Spring Security 實現了各種登錄聚合的場面。其中我們是通過在 UsernamePasswordAuthenticationFilter 之前一個自定義的過濾器實現的。我怎么知道自定義過濾器要加在 UsernamePasswordAuthenticationFilter 之前。我在這個系列開篇說了 Spring Security 權限控制的一個核心關鍵就是 過濾器鏈 ,這些過濾器如下圖進行過濾傳遞,甚至比這個更復雜!這只是一個最小單元。
Spring Security 內置了一些過濾器,他們各有各的本事。如果你掌握了這些過濾器,很多實際開發中的需求和問題都很容易解決。今天我們來見識一下這些內置的過濾器。
2. 內置過濾器初始化
在 Spring Security 初始化核心過濾器時 HttpSecurity 會通過將 Spring Security 內置的一些過濾器以 FilterComparator 提供的規則進行比較按照比較結果進行排序注冊。
2.1 排序規則
FilterComparator 維護了一個順序的注冊表 filterToOrder 。
FilterComparator() { Step order=new Step(INITIAL_ORDER, ORDER_STEP); put(ChannelProcessingFilter.class, order.next()); put(ConcurrentSessionFilter.class, order.next()); put(WebAsyncManagerIntegrationFilter.class, order.next()); put(SecurityContextPersistenceFilter.class, order.next()); put(HeaderWriterFilter.class, order.next()); put(CorsFilter.class, order.next()); put(CsrfFilter.class, order.next()); put(LogoutFilter.class, order.next()); filterToOrder.put( "org.springframework.security.oauth2.client.web.OAuth2AuthorizationRequestRedirectFilter", order.next()); filterToOrder.put( "org.springframework.security.saml2.provider.service.servlet.filter.Saml2WebSsoAuthenticationRequestFilter", order.next()); put(X509AuthenticationFilter.class, order.next()); put(AbstractPreAuthenticatedProcessingFilter.class, order.next()); filterToOrder.put("org.springframework.security.cas.web.CasAuthenticationFilter", order.next()); filterToOrder.put( "org.springframework.security.oauth2.client.web.OAuth2LoginAuthenticationFilter", order.next()); filterToOrder.put( "org.springframework.security.saml2.provider.service.servlet.filter.Saml2WebSsoAuthenticationFilter", order.next()); put(UsernamePasswordAuthenticationFilter.class, order.next()); put(ConcurrentSessionFilter.class, order.next()); filterToOrder.put( "org.springframework.security.openid.OpenIDAuthenticationFilter", order.next()); put(DefaultLoginPageGeneratingFilter.class, order.next()); put(DefaultLogoutPageGeneratingFilter.class, order.next()); put(ConcurrentSessionFilter.class, order.next()); put(DigestAuthenticationFilter.class, order.next()); filterToOrder.put( "org.springframework.security.oauth2.server.resource.web.BearerTokenAuthenticationFilter", order.next()); put(BasicAuthenticationFilter.class, order.next()); put(RequestCacheAwareFilter.class, order.next()); put(SecurityContextHolderAwareRequestFilter.class, order.next()); put(JaasApiIntegrationFilter.class, order.next()); put(RememberMeAuthenticationFilter.class, order.next()); put(AnonymousAuthenticationFilter.class, order.next()); filterToOrder.put( "org.springframework.security.oauth2.client.web.OAuth2AuthorizationCodeGrantFilter", order.next()); put(SessionManagementFilter.class, order.next()); put(ExceptionTranslationFilter.class, order.next()); put(FilterSecurityInterceptor.class, order.next()); put(SwitchUserFilter.class, order.next()); }
這些就是所有內置的過濾器。 他們是通過下面的方法獲取自己的序號:
private Integer getOrder(Class<?> clazz) { while (clazz !=null) { Integer result=filterToOrder.get(clazz.getName()); if (result !=null) { return result; } clazz=clazz.getSuperclass(); } return null; }
通過過濾器的類全限定名從注冊表 filterToOrder 中獲取自己的序號,如果沒有直接獲取到序號通過遞歸獲取父類在注冊表中的序號作為自己的序號,序號越小優先級越高。上面的過濾器并非全部會被初始化。有的需要額外引入一些功能包,有的看 HttpSecurity 的配置情況。 在上一篇https://www.felord.cn/spring-security-login.html中。我們禁用了 CSRF 功能,就意味著 CsrfFilter 不會被注冊。
3. 內置過濾器講解
接下來我們就對這些內置過濾器進行一個系統的認識。我們將按照默認順序進行講解。
3.1 ChannelProcessingFilter
ChannelProcessingFilter 通常是用來過濾哪些請求必須用 https 協議, 哪些請求必須用 http 協議, 哪些請求隨便用哪個協議都行。它主要有兩個屬性:
ChannelProcessingFilter 通過 HttpScurity#requiresChannel() 等相關方法引入其配置對象 ChannelSecurityConfigurer 來進行配置。
3.2 ConcurrentSessionFilter
ConcurrentSessionFilter 主要用來判斷session是否過期以及更新最新的訪問時間。其流程為:
ConcurrentSessionFilter 通過SessionManagementConfigurer 來進行配置。
3.3 WebAsyncManagerIntegrationFilter
WebAsyncManagerIntegrationFilter用于集成SecurityContext到Spring異步執行機制中的WebAsyncManager。用來處理異步請求的安全上下文。具體邏輯為:
這里簡單說一下 SecurityContextCallableProcessingInterceptor 。它實現了接口 CallableProcessingInterceptor,當它被應用于一次異步執行時,beforeConcurrentHandling() 方法會在調用者線程執行,該方法會相應地從當前線程獲取SecurityContext,然后被調用者線程中執行邏輯時,會使用這個 SecurityContext,從而實現安全上下文從調用者線程到被調用者線程的傳輸。
WebAsyncManagerIntegrationFilter 通過 WebSecurityConfigurerAdapter#getHttp()方法添加到 HttpSecurity 中成為 DefaultSecurityFilterChain 的一個鏈節。
3.4 SecurityContextPersistenceFilter
SecurityContextPersistenceFilter 主要控制 SecurityContext 的在一次請求中的生命周期 。 請求來臨時,創建SecurityContext 安全上下文信息,請求結束時清空 SecurityContextHolder。
SecurityContextPersistenceFilter 通過 HttpScurity#securityContext() 及相關方法引入其配置對象 SecurityContextConfigurer 來進行配置。
3.5 HeaderWriterFilter
HeaderWriterFilter 用來給 http 響應添加一些 Header,比如 X-Frame-Options, X-XSS-Protection ,X-Content-Type-Options。
你可以通過 HttpScurity#headers() 來定制請求Header 。
3.6 CorsFilter
跨域相關的過濾器。這是Spring MVC Java配置和XML 命名空間 CORS 配置的替代方法, 僅對依賴于spring-web的應用程序有用(不適用于spring-webmvc)或 要求在javax.servlet.Filter 級別進行CORS檢查的安全約束鏈接。這個是目前官方的一些解讀,但是我還是不太清楚實際機制。
你可以通過 HttpSecurity#cors() 來定制。
3.7 CsrfFilter
CsrfFilter 用于防止csrf攻擊,前后端使用json交互需要注意的一個問題。
你可以通過 HttpSecurity.csrf() 來開啟或者關閉它。在你使用 jwt 等 token 技術時,是不需要這個的。
3.8 LogoutFilter
LogoutFilter 很明顯這是處理注銷的過濾器。
你可以通過 HttpSecurity.logout() 來定制注銷邏輯,非常有用。
3.9 OAuth2AuthorizationRequestRedirectFilter
和上面的有所不同,這個需要依賴 spring-scurity-oauth2 相關的模塊。該過濾器是處理 OAuth2 請求首選重定向相關邏輯的。以后會我會帶你們認識它,請多多關注公眾號:Felordcn 。
3.10 Saml2WebSsoAuthenticationRequestFilter
這個需要用到 Spring Security SAML 模塊,這是一個基于 SMAL 的 SSO 單點登錄請求認證過濾器。
關于SAML
SAML 即安全斷言標記語言,英文全稱是 Security Assertion Markup Language。它是一個基于 XML 的標準,用于在不同的安全域(security domain)之間交換認證和授權數據。在 SAML 標準定義了身份提供者 (identity provider) 和服務提供者 (service provider),這兩者構成了前面所說的不同的安全域。 SAML 是 OASIS 組織安全服務技術委員會(Security Services Technical Committee) 的產品。
SAML(Security Assertion Markup Language)是一個 XML 框架,也就是一組協議,可以用來傳輸安全聲明。比如,兩臺遠程機器之間要通訊,為了保證安全,我們可以采用加密等措施,也可以采用 SAML 來傳輸,傳輸的數據以 XML 形式,符合 SAML 規范,這樣我們就可以不要求兩臺機器采用什么樣的系統,只要求能理解 SAML 規范即可,顯然比傳統的方式更好。SAML 規范是一組 Schema 定義。
可以這么說,在 Web Service 領域,schema 就是規范,在 Java 領域,API 就是規范
3.11 X509AuthenticationFilter
X509 認證過濾器。你可以通過 HttpSecurity#X509() 來啟用和配置相關功能。
3.12 AbstractPreAuthenticatedProcessingFilter
AbstractPreAuthenticatedProcessingFilter 處理處理經過預先認證的身份驗證請求的過濾器的基類,其中認證主體已經由外部系統進行了身份驗證。 目的只是從傳入請求中提取主體上的必要信息,而不是對它們進行身份驗證。
你可以繼承該類進行具體實現并通過 HttpSecurity#addFilter 方法來添加個性化的AbstractPreAuthenticatedProcessingFilter 。
3.13 CasAuthenticationFilter
CAS 單點登錄認證過濾器 。依賴 Spring Security CAS 模塊
3.14 OAuth2LoginAuthenticationFilter
這個需要依賴 spring-scurity-oauth2 相關的模塊。OAuth2 登錄認證過濾器。處理通過 OAuth2 進行認證登錄的邏輯。
3.15 Saml2WebSsoAuthenticationFilter
這個需要用到 Spring Security SAML 模塊,這是一個基于 SMAL 的 SSO 單點登錄認證過濾器。 #關于SAML
3.16 UsernamePasswordAuthenticationFilter
這個看過我相關文章的應該不陌生了。處理用戶以及密碼認證的核心過濾器。認證請求提交的username和 password,被封裝成token進行一系列的認證,便是主要通過這個過濾器完成的,在表單認證的方法中,這是最最關鍵的過濾器。
你可以通過 HttpSecurity#formLogin() 及相關方法引入其配置對象 FormLoginConfigurer 來進行配置。 我們在 https://www.felord.cn/spring-security-login.html 已經對其進行過個性化的配置和魔改。
3.17 ConcurrentSessionFilter
參見 #3.2 。 該過濾器可能會被多次執行。
3.18 OpenIDAuthenticationFilter
基于OpenID 認證協議的認證過濾器。 你需要在依賴中依賴額外的相關模塊才能啟用它。
3.19 DefaultLoginPageGeneratingFilter
生成默認的登錄頁。默認 /login 。
3.20 DefaultLogoutPageGeneratingFilter
生成默認的退出頁。 默認 /logout 。
3.21 ConcurrentSessionFilter
參見 #3.2 。 該過濾器可能會被多次執行。
3.23 DigestAuthenticationFilter
Digest身份驗證是 Web 應用程序中流行的可選的身份驗證機制 。DigestAuthenticationFilter 能夠處理 HTTP 頭中顯示的摘要式身份驗證憑據。你可以通過 HttpSecurity#addFilter() 來啟用和配置相關功能。
3.24 BasicAuthenticationFilter
和Digest身份驗證一樣都是Web 應用程序中流行的可選的身份驗證機制 。 BasicAuthenticationFilter 負責處理 HTTP 頭中顯示的基本身份驗證憑據。這個 Spring Security 的 Spring Boot 自動配置默認是啟用的 。
BasicAuthenticationFilter 通過 HttpSecurity#httpBasic() 及相關方法引入其配置對象 HttpBasicConfigurer 來進行配置。
3.25 RequestCacheAwareFilter
用于用戶認證成功后,重新恢復因為登錄被打斷的請求。當匿名訪問一個需要授權的資源時。會跳轉到認證處理邏輯,此時請求被緩存。在認證邏輯處理完畢后,從緩存中獲取最開始的資源請求進行再次請求。
RequestCacheAwareFilter 通過 HttpScurity#requestCache() 及相關方法引入其配置對象 RequestCacheConfigurer 來進行配置。
3.26 SecurityContextHolderAwareRequestFilter
用來 實現j2ee中 Servlet Api 一些接口方法, 比如 getRemoteUser 方法、isUserInRole 方法,在使用 Spring Security 時其實就是通過這個過濾器來實現的。
SecurityContextHolderAwareRequestFilter 通過 HttpSecurity.servletApi() 及相關方法引入其配置對象 ServletApiConfigurer 來進行配置。
3.27 JaasApiIntegrationFilter
適用于JAAS (Java 認證授權服務)。 如果 SecurityContextHolder 中擁有的 Authentication 是一個 JaasAuthenticationToken,那么該 JaasApiIntegrationFilter 將使用包含在 JaasAuthenticationToken 中的 Subject 繼續執行 FilterChain。
3.28 RememberMeAuthenticationFilter
處理 記住我 功能的過濾器。
RememberMeAuthenticationFilter 通過 HttpSecurity.rememberMe() 及相關方法引入其配置對象 RememberMeConfigurer 來進行配置。
3.29 AnonymousAuthenticationFilter
匿名認證過濾器。對于 Spring Security 來說,所有對資源的訪問都是有 Authentication 的。對于無需登錄(UsernamePasswordAuthenticationFilter )直接可以訪問的資源,會授予其匿名用戶身份。
AnonymousAuthenticationFilter 通過 HttpSecurity.anonymous() 及相關方法引入其配置對象 AnonymousConfigurer 來進行配置。
3.30 SessionManagementFilter
Session 管理器過濾器,內部維護了一個 SessionAuthenticationStrategy 用于管理 Session 。
SessionManagementFilter 通過 HttpScurity#sessionManagement() 及相關方法引入其配置對象 SessionManagementConfigurer 來進行配置。
3.31 ExceptionTranslationFilter
主要來傳輸異常事件,還記得之前我們見過的 DefaultAuthenticationEventPublisher 嗎?
3.32 FilterSecurityInterceptor
這個過濾器決定了訪問特定路徑應該具備的權限,訪問的用戶的角色,權限是什么?訪問的路徑需要什么樣的角色和權限?這些判斷和處理都是由該類進行的。如果你要實現動態權限控制就必須研究該類 。
文通俗易懂地剖析用戶授權的設計原理和四種授權模式,重點介紹授權碼登錄模式,適合閱讀的人群:開放平臺/第三方合作的產品經理,初入職場的產品經理。
我們每個人都遇到過授權登錄的環節,授權登錄的應用無孔不入,可能你是在授權應用權限,或是授權賬戶登錄,或是授權個人信息。
我們常見的應用場景一般有以下:
因而授權登錄是應用間交互的重要且廣泛的步驟,深入了解過其中的原理很有必要。
以美團外賣授權獲取你的頭像和地理位置為例:
字面意思就是如下圖流程:
值得關注的是第3步和第4步:當你在授權的過程中,實則是你和微信的直接交互,與美團外賣小程序無關。
亦即是:你是跟微信同意授權,也是微信接收到你的“同意”的指令,即使在網站用微信登錄也是如此,如豆瓣登錄,需要微信掃描二維碼,確保授權動作保留和發生在微信自己的環境內。
那么從形式來說,授權登錄可以分為靜默授權和手動授權兩種模式:
以上第2點是授權的基本簡化,本節是更重點介紹OAuth2的系統鏈路流程(無論是靜默或是手動,系統鏈路一致,只是形式的區分)。目前市面上涉及授權,權限申請的業務均通過OAuth2的方法進行設計。
OAuth2具體可以分為以下四種:
其中最重要的就是第一種授權碼模式,接下來我以企業微信授權碼方法做解析,其流程圖非常清晰。
例子講解:
場景:該身份授權是用戶在企業微信使用第三方應用時拉起授權頁面的流程。類似于你在微信打開餓了么小程序。
系統交互的步驟:
請記住第一個模式中的第(1)步和第(2)步都需要A應用處理,簡化模式就是簡化了第(2)步。
以下在微信的場景僅用于舉例:
此處你有沒有發現,前面授權的過程并不需要應用本身參與,這個就是比授權碼模式簡化的地方。但這種模式不支持用戶令牌的更新,也就是用戶第一次授權過期了之后,下一次又需要重新手動授權。
這種模式很直接,相當于你把你微信的賬戶密碼告訴餓了么,餓了么利用你的賬戶密碼去獲取信息。這種方式極其不安全,用戶的賬戶信息隨時會被外泄。
這種其實不屬于授權,實則就是兩個應用間直接進行信息傳輸,與用戶無關。
API接口入門(一):讀懂API接口文檔
API接口入門(一):讀懂API接口文檔
作者:就是愛睡覺,電商和金融業行業的產品,以TO B業務為主,文章是用于記錄自己在產品工作的思考和想法,希望有想法的小伙伴共同交流。
本文由 @就是愛睡覺 原創發布于人人都是產品經理。未經許可,禁止轉載
題圖來自Unsplash,基于CC0協議
些項目或者系統的開發,避免不了有些非業務性代碼(也叫功能性代碼)。這類代碼一般是具有通用性特點,比如日志,權限,授權等等。作為高級工程師或者架構師,就要考慮把這些代碼進行封裝,方便別人使用。
常用的封裝方法,一般分為三種 1:基類的方法抽象 2:工具類 3:自定義注解。今天我們說一下第三種自定義注解的方式。先簡單說一下spring注解的分類,主要兩種,一種是初始化類注解。例如 @Component,@Controller.....
第二種就是AOP類注解,例如@Transcation,@Cache....。
現在有個微信公眾號的授權使用場景,通過code獲取訪問用戶的openId,如果緩存存在,從緩存中獲取,不存在就從微信服務器獲取,之后得到用戶的相應信息,頭像,名稱等等。因為每個頁面都需要進行授權獲取用戶的openID,所以這個功能可以封裝起來,供所有模塊使用。
第一步:定義注解,參數type用來區分是靜默授權還是非靜默授權。
@Retention(RetentionPolicy.RUNTIME) // 注解會在class字節碼文件中存在,在運行時可以通過反射獲取到 @Target({ElementType.FIELD, ElementType.METHOD})//定義注解的作用目標**作用范圍字段、枚舉的常量/方法 @Documented //說明該注解將被包含在javadoc中 public @interface AuthAnnotation { String type(); }
第二步:定義切面類AuthAspect
@Aspect @Component public class AuthAspect { @Resource private ObjectCacheRedisDao objectCacheRedisDao; private BeLogger logger=new BeLogger(AuthAspect.class); @Around("@annotation(aa)") public Object doAround(ProceedingJoinPoint joinPoint,AuthAnnotation aa) throws Throwable { Object object=null; String type=aa.type();//后去注解的參數 Object [] parm=joinPoint.getArgs();//獲得切面方法當中的參數 String code=String.valueOf(parm[0]); JSONObject jsonObject=null; JSONObject userInfo=new JSONObject(); if (StringUtils.isEmptyString(code)) { return userInfo; } String openId=""; // 獲取授權信息 if (!code.equals("authdeny") && objectCacheRedisDao.get(code)==null) { logger.debug("objectCache沒有數據。code:" + code); try { jsonObject=WechatClient.getUserTokenByAuthCode(code); if (jsonObject==null || !jsonObject.containsKey("openid")) { return userInfo; } else { openId=jsonObject.getString("openid"); userInfo.put("openid",openId); objectCacheRedisDao.set(code, userInfo); } //非靜默授權的場合 if("user_info".equals(type)) { String accessToken=jsonObject.getString("access_token"); userInfo=WechatClient.getUserInfoByTokenAndOpenId(accessToken, openId); if (!userInfo.containsKey("errcode")) { objectCacheRedisDao.set(code, userInfo); } } } catch (Exception e) { logger.warn("YXKJ----------------->確認課次獲取用戶信息異常:" + Tools.getStackStr(e)); } } else { logger.debug("objectCacheRedisDao有數據。code:" + code); userInfo=(JSONObject) objectCacheRedisDao.get(code); } if (userInfo !=null) { parm[1]=userInfo.toString(); } else { parm[1]=""; } object=joinPoint.proceed(parm); return object; } }
第三步:自動為spring容器中那些配置@aspectJ切面的bean創建代理,織入切面
<aop:aspectj-autoproxy proxy-target-class="true" />
第四布:調用注解
*請認真填寫需求信息,我們會在24小時內與您取得聯系。