之前寫了很多關(guān)于spring cloud的文章唇牧,今天我們對OAuth2.0的整合方式做一下筆記刊头,首先我從網(wǎng)上找了一些關(guān)于OAuth2.0的一些基礎(chǔ)知識點憎夷,幫助大家回顧一下知識點:
client:調(diào)用資源服務(wù)器API的應(yīng)用
Oauth 2.0 Provider:包括Authorization Server和Resource Server
(1)Authorization Server:認(rèn)證服務(wù)器,進(jìn)行認(rèn)證和授權(quán)
(2)Resource Server:資源服務(wù)器查乒,保護(hù)受保護(hù)的資源
user:資源的擁有者
二弥喉、下面詳細(xì)介紹一下Oauth 2.0 Provider
(1)AuthorizationEndpoint:進(jìn)行授權(quán)的服務(wù),Default
URL:/oauth/authorize
(2)TokenEndpoint:獲取token的服務(wù)玛迄,Default URL:/oauth/token
OAuth2AuthenticationProcessingFilter:給帶有訪問令牌的請求加載認(rèn)證
三由境、下面再來詳細(xì)介紹一下Authorization Server:
一般情況下,創(chuàng)建兩個配置類蓖议,一個繼承AuthorizationServerConfigurerAdapter虏杰,一個繼承WebSecurityConfigurerAdapter,再去復(fù)寫里面的方法勒虾。
1纺阔、@EnableAuthorizationServer:聲明一個認(rèn)證服務(wù)器,當(dāng)用此注解后修然,應(yīng)用啟動后將自動生成幾個Endpoint:(注:其實實現(xiàn)一個認(rèn)證服務(wù)器就是這么簡單笛钝,加一個注解就搞定,當(dāng)然真正用到生產(chǎn)環(huán)境還是要進(jìn)行一些配置和復(fù)寫工作的愕宋。)
/oauth/authorize:驗證
/oauth/token:獲取token
/oauth/confirm_access:用戶授權(quán)
/oauth/error:認(rèn)證失敗
/oauth/check_token:資源服務(wù)器用來校驗token
/oauth/token_key:如果jwt模式則可以用此來從認(rèn)證服務(wù)器獲取公鑰
以上這些endpoint都在源碼里的endpoint包里面玻靡。
2、@Beans:需要實現(xiàn)AuthorizationServerConfigurer
AuthorizationServerConfigurer包含三種配置:
ClientDetailsServiceConfigurer:client客戶端的信息配置中贝,client信息包括:clientId囤捻、secret、scope雄妥、authorizedGrantTypes最蕾、authorities
(1)scope:表示權(quán)限范圍,可選項老厌,用戶授權(quán)頁面時進(jìn)行選擇
(2)authorizedGrantTypes:有四種授權(quán)方式
Authorization Code:用驗證獲取code瘟则,再用code去獲取token(用的最多的方式,也是最安全的方式)
Implicit: 隱式授權(quán)模式
Client Credentials (用來取得 App Access Token)
Resource Owner Password Credentials
(3)authorities:授予client的權(quán)限
這里的具體實現(xiàn)有多種枝秤,in-memory醋拧、JdbcClientDetailsService、jwt等。
AuthorizationServerSecurityConfigurer:聲明安全約束丹壕,哪些允許訪問庆械,哪些不允許訪問
AuthorizationServerEndpointsConfigurer:聲明授權(quán)和token的端點以及token的服務(wù)的一些配置信息,比如采用什么存儲方式菌赖、token的有效期等
client的信息的讀如猿恕:在ClientDetailsServiceConfigurer類里面進(jìn)行配置,可以有in-memory琉用、jdbc等多種讀取方式堕绩。
jdbc需要調(diào)用JdbcClientDetailsService類,此類需要傳入相應(yīng)的DataSource.
AuthorizationServerTokenServices接口:聲明必要的關(guān)于token的操作
(1)當(dāng)token創(chuàng)建后邑时,保存起來奴紧,以便之后的接受訪問令牌的資源可以引用它。
(2)訪問令牌用來加載認(rèn)證
接口的實現(xiàn)也有多種晶丘,DefaultTokenServices是其默認(rèn)實現(xiàn)黍氮,他使用了默認(rèn)的InMemoryTokenStore财松,不會持久化token抡驼;
(1)InMemoryTokenStore:存放內(nèi)存中独榴,不會持久化
(2)JdbcTokenStore:存放數(shù)據(jù)庫中
(3)Jwt: json web token
可以通過AuthorizationServerEndpointsConfigurer來進(jìn)行配置摔竿,默認(rèn)情況下主慰,支持除了密碼外的所有授權(quán)類型摇展。相關(guān)授權(quán)類型的一些類:
(1)authenticationManager:直接注入一個AuthenticationManager房蝉,自動開啟密碼授權(quán)類型
(2)userDetailsService:如果注入UserDetailsService颊郎,那么將會啟動刷新token授權(quán)類型叔遂,會判斷用戶是否還是存活的
(3)authorizationCodeServices:AuthorizationCodeServices的實例他炊,auth code 授權(quán)類型的服務(wù)
(4)implicitGrantService:imlpicit grant
(5)tokenGranter:
(1)AuthorizationServerEndpointsConfigurer的pathMapping()方法,有兩個參數(shù)已艰,第一個是默認(rèn)的URL路徑痊末,第二個是自定義的路徑
(2)WebSecurityConfigurer的實例,可以配置哪些路徑不需要保護(hù)哩掺,哪些需要保護(hù)凿叠。默認(rèn)全都保護(hù)。
(1)有時候嚼吞,我們可能需要自定義的登錄頁面和認(rèn)證頁面盒件。登陸頁面的話,只需要創(chuàng)建一個login為前綴名的網(wǎng)頁即可舱禽,在代碼里炒刁,設(shè)置為允許訪問,這樣誊稚,系統(tǒng)會自動執(zhí)行你的登陸頁翔始。此登陸頁的action要注意一下罗心,必須是跳轉(zhuǎn)到認(rèn)證的地址。
(2)另外一個是授權(quán)頁城瞎,讓你勾選選項的頁面渤闷。此頁面可以參考源碼里的實現(xiàn),自己生成一個controller的類脖镀,再創(chuàng)建一個對應(yīng)的web頁面即可實現(xiàn)自定義的功能飒箭。
(1)端口號換成你自己的認(rèn)證服務(wù)器的端口號,client_id也換成你自己的蜒灰,response_type類型為code补憾。
localhost:8080/uaa/oauth/authorize?client_id=client&response_type=code&redirect_uri=http://www.baidu.com
(2)這時候你將獲得一個code值:http://www.baidu.com/?code=G0C20Z
(3)使用此code值來獲取最終的token:
curl -X POST -H "Cant-Type: application/x-www-form-urlencoded" -d 'grant_type=authorization_code&code=G0C20Z&redirect_uri=http://www.baidu.com' "http://client:secret@localhost:8080/uaa/oauth/token"
返回值:
{"access_token":"b251b453-cc08-4520-9dd0-9aedf58e6ca3","token_type":"bearer","expires_in":2591324,"scope":"app"}
(4)用此token值來調(diào)用資源服務(wù)器內(nèi)容(如果資源服務(wù)器和認(rèn)證服務(wù)器在同一個應(yīng)用中,那么資源服務(wù)器會自己解析token值卷员,如果不在,那么你要自己去做處理)
curl -H "Authorization: Bearer b251b453-cc08-4520-9dd0-9aedf58e6ca3" "localhost:8081/service2(此處換上你自己的url)"
四腾务、Resource Server:保護(hù)資源毕骡,需要令牌才能訪問
在配置類上加上注解@EnableResourceServer即啟動。使用ResourceServerConfigurer進(jìn)行配置:
(1)tokenServices:ResourceServerTokenServices的實例岩瘦,聲明了token的服務(wù)
(2)resourceId:資源Id未巫,由auth Server驗證。
(3)其它一些擴(kuò)展點启昧,比如可以從請求中提取token的tokenExtractor
(4)一些自定義的資源保護(hù)配置叙凡,通過HttpSecurity來設(shè)置
使用token的方式也有兩種:
(1)Bearer Token(https傳輸方式保證傳輸過程的安全):主流
(2)Mac(http+sign)
如何訪問資源服務(wù)器中的API?
如果資源服務(wù)器和授權(quán)服務(wù)器在同一個應(yīng)用程序中密末,并且您使用DefaultTokenServices握爷,那么您不必太考慮這一點,因為它實現(xiàn)所有必要的接口严里,因此它是自動一致的新啼。如果您的資源服務(wù)器是一個單獨的應(yīng)用程序,那么您必須確保您匹配授權(quán)服務(wù)器的功能刹碾,并提供知道如何正確解碼令牌的ResourceServerTokenServices燥撞。與授權(quán)服務(wù)器一樣,您可以經(jīng)常使用DefaultTokenServices迷帜,并且選項大多通過TokenStore(后端存儲或本地編碼)表示物舒。
(1)在校驗request中的token時,使用RemoteTokenServices去調(diào)用AuthServer中的/auth/check_token戏锹。
(2)共享數(shù)據(jù)庫冠胯,使用Jdbc存儲和校驗token,避免再去訪問AuthServer景用。
(3)使用JWT簽名的方式涵叮,資源服務(wù)器自己直接進(jìn)行校驗惭蹂,不借助任何中間媒介。
在客戶端獲取到token之后盾碗,想去調(diào)用下游服務(wù)API時,為了能將token進(jìn)行傳遞舀瓢,可以使用RestTemplate.然后使用restTemplate進(jìn)行調(diào)用Api廷雅。
注:
scopes和authorities的區(qū)別:
scopes是client權(quán)限,至少授予一個scope的權(quán)限京髓,否則報錯航缀。
authorities是用戶權(quán)限。
以上是我從網(wǎng)上找到的一篇寫的不錯的博客堰怨,希望可以幫助大家快速了解OAuth2.0,下一篇文章我們正式介紹OAuth2.0在當(dāng)前框架中的使用芥玉。
從現(xiàn)在開始,我這邊會將近期研發(fā)的spring cloud微服務(wù)云架構(gòu)的搭建過程和精髓記錄下來备图,幫助更多有興趣研發(fā)spring cloud框架的朋友灿巧,大家來一起探討spring cloud架構(gòu)的搭建過程及如何運(yùn)用于企業(yè)項目。源碼來源