今天我們對OAuth2.0的整合方式做一下筆記,首先我從網上找了一些關於OAuth2.0的一些基礎知識點,幫助大家回顧一下知識點:
一、oauth中的角色
client:呼叫資源伺服器API的應用
Oauth 2.0 Provider:包括Authorization Server和Resource Server
(1)Authorization Server:認證伺服器,進行認證和授權
(2)Resource Server:資源伺服器,保護受保護的資源
user:資源的擁有者
二、下面詳細介紹一下Oauth 2.0 Provider
Authorization Server:
(1)AuthorizationEndpoint:進行授權的服務,Default URL:
/oauth/authorize
(2)TokenEndpoint:獲取token的服務,Default URL: /oauth/token
Resource Server:
OAuth2AuthenticationProcessingFilter:給帶有訪問令牌的請求載入認證
三、下面再來詳細介紹一下Authorization Server:
一般情況下,建立兩個配置類,一個繼承AuthorizationServerConfigurerAdapter,一個繼承WebSecurityConfigurerAdapter,再去複寫裡面的方法。
主要出現的兩種註解:
1、@EnableAuthorizationServer:宣告一個認證伺服器,當用此註解後,應用啟動後將自動生成幾個Endpoint:(注:其實實現一個認證伺服器就是這麼簡單,加一個註解就搞定,當然真正用到生產環境還是要進行一些配置和複寫工作的。)
/oauth/authorize:驗證
/oauth/token:獲取token
/oauth/confirm_access:使用者授權
/oauth/error:認證失敗
/oauth/check_token:資源伺服器用來校驗token
/oauth/token_key:如果jwt模式則可以用此來從認證伺服器獲取公鑰
以上這些endpoint都在原始碼裡的endpoint包裡面。
2、@Beans:需要實現AuthorizationServerConfigurer
AuthorizationServerConfigurer包含三種配置:
ClientDetailsServiceConfigurer:client客戶端的資訊配置,client資訊包括:clientId、secret、scope、authorizedGrantTypes、authorities
(1)scope:表示許可權範圍,可選項,使用者授權頁面時進行選擇
(2)authorizedGrantTypes:有四種授權方式
- Authorization Code:用驗證獲取code,再用code去獲取token(用的最多的方式,也是最安全的方式)
- Implicit: 隱式授權模式
- Client Credentials (用來取得 App Access Token)
- Resource Owner Password Credentials
(3)authorities:授予client的許可權
這裡的具體實現有多種,in-memory、JdbcClientDetailsService、jwt等。
AuthorizationServerSecurityConfigurer:宣告安全約束,哪些允許訪問,哪些不允許訪問
AuthorizationServerEndpointsConfigurer:宣告授權和token的端點以及token的服務的一些配置資訊,比如採用什麼儲存方式、token的有效期等
client的資訊的讀取:在ClientDetailsServiceConfigurer類裡面進行配置,可以有in-memory、jdbc等多種讀取方式。
jdbc需要呼叫JdbcClientDetailsService類,此類需要傳入相應的DataSource.
下面再介紹一下如何管理token:
AuthorizationServerTokenServices介面:宣告必要的關於token的操作
(1)當token建立後,儲存起來,以便之後的接受訪問令牌的資源可以引用它。
(2)訪問令牌用來載入認證
介面的實現也有多種,DefaultTokenServices是其預設實現,他使用了預設的InMemoryTokenStore,不會持久化token;
token儲存方式共有三種分別是:
(1)InMemoryTokenStore:存放記憶體中,不會持久化
(2)JdbcTokenStore:存放資料庫中
(3)Jwt: json web token
授權型別:
可以通過AuthorizationServerEndpointsConfigurer來進行配置,預設情況下,支援除了密碼外的所有授權型別。相關授權型別的一些類:
(1)authenticationManager:直接注入一個AuthenticationManager,自動開啟密碼授權型別
(2)userDetailsService:如果注入UserDetailsService,那麼將會啟動重新整理token授權型別,會判斷使用者是否還是存活的
(3)authorizationCodeServices:AuthorizationCodeServices的例項,auth code 授權型別的服務
(4)implicitGrantService:imlpicit grant
(5)tokenGranter:
endpoint的URL的配置:
(1)AuthorizationServerEndpointsConfigurer的pathMapping()方法,有兩個引數,第一個是預設的URL路徑,第二個是自定義的路徑
(2)WebSecurityConfigurer的例項,可以配置哪些路徑不需要保護,哪些需要保護。預設全都保護。
自定義UI:
(1)有時候,我們可能需要自定義的登入頁面和認證頁面。登陸頁面的話,只需要建立一個login為字首名的網頁即可,在程式碼裡,設定為允許訪問,這樣,系統會自動執行你的登陸頁。此登陸頁的action要注意一下,必須是跳轉到認證的地址。
(2)另外一個是授權頁,讓你勾選選項的頁面。此頁面可以參考原始碼裡的實現,自己生成一個controller的類,再建立一個對應的web頁面即可實現自定義的功能。
下面梳理一下授權獲取token流程:
(1)埠號換成你自己的認證伺服器的埠號,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=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值來呼叫資源伺服器內容(如果資源伺服器和認證伺服器在同一個應用中,那麼資源伺服器會自己解析token值,如果不在,那麼你要自己去做處理)
curl -H "Authorization: Bearer b251b453-cc08-4520-9dd0-9aedf58e6ca3" "localhost:8081/service2(此處換上你自己的url)"
四、Resource Server:保護資源,需要令牌才能訪問
在配置類上加上註解@EnableResourceServer即啟動。使用ResourceServerConfigurer進行配置:
(1)tokenServices:ResourceServerTokenServices的例項,宣告瞭token的服務
(2)resourceId:資源Id,由auth Server驗證。
(3)其它一些擴充套件點,比如可以從請求中提取token的tokenExtractor
(4)一些自定義的資源保護配置,通過HttpSecurity來設定
使用token的方式也有兩種:
(1)Bearer Token(https傳輸方式保證傳輸過程的安全):主流
(2)Mac(http+sign)
如何訪問資源伺服器中的API?
如果資源伺服器和授權伺服器在同一個應用程式中,並且您使用DefaultTokenServices,那麼您不必太考慮這一點,因為它實現所有必要的介面,因此它是自動一致的。如果您的資源伺服器是一個單獨的應用程式,那麼您必須確保您匹配授權伺服器的功能,並提供知道如何正確解碼令牌的ResourceServerTokenServices。與授權伺服器一樣,您可以經常使用DefaultTokenServices,並且選項大多通過TokenStore(後端儲存或本地編碼)表示。
(1)在校驗request中的token時,使用RemoteTokenServices去呼叫AuthServer中的/auth/check_token。
(2)共享資料庫,使用Jdbc儲存和校驗token,避免再去訪問AuthServer。
(3)使用JWT簽名的方式,資源伺服器自己直接進行校驗,不借助任何中間媒介。
五、oauth client
在客戶端獲取到token之後,想去呼叫下游服務API時,為了能將token進行傳遞,可以使用RestTemplate.然後使用restTemplate進行呼叫Api。
注:
scopes和authorities的區別:
scopes是client許可權,至少授予一個scope的許可權,否則報錯。
authorities是使用者許可權。
以上是我從網上找到的一篇寫的不錯的部落格,希望可以幫助大家快速瞭解OAuth2.0,下一篇文章我們正式介紹OAuth2.0在當前框架中的使用。
從現在開始,我這邊會將近期研發的spring cloud微服務雲架構的搭建過程和精髓記錄下來,幫助更多有興趣研發spring cloud框架的朋友,大家來一起探討spring cloud架構的搭建過程及如何運用於企業專案。
完整專案的原始碼來源 技術支援1791743380