概述說明
CAS Server默認搭建出來,客戶端程序只能按照CAS自身的協議接入。CAS的強大在於,有官方的插件,可以支持其他的協議。本章節就讓CAS Server怎么增加OAuth2.0的登錄協議。
安裝步驟
`1. 首先,您需要有個CAS Server端
如果您沒有,可以按照我之前寫的文章《輕松搭建CAS 5.x系列文章》系列的前3篇文章搭建好CAS Server。
·2. 在pom.xml增加依賴包
1 <!-- OAuth/OpenID Authentication Begin -->
2 <dependency>
3 <groupId>org.apereo.cas</groupId>
4 <artifactId>cas-server-support-oauth-webflow</artifactId>
5 <version>${cas.version}</version>
6 </dependency>
7 <!-- OAuth/OpenID Authentication End -->
·3. application.properties增加配置文件
(該文件路徑:D:\casoverlay\cas-overlay-template\src\main\resources)
1 cas.authn.oauth.refreshToken.timeToKillInSeconds=2592000
2 cas.authn.oauth.code.timeToKillInSeconds=30
3 cas.authn.oauth.code.numberOfUses=1
4 cas.authn.oauth.accessToken.releaseProtocolAttributes=true
5 cas.authn.oauth.accessToken.timeToKillInSeconds=7200
6 cas.authn.oauth.accessToken.maxTimeToLiveInSeconds=28800
7 cas.authn.oauth.grants.resourceOwner.requireServiceHeader=true
8 cas.authn.oauth.userProfileViewType=NESTED
·4. 增加接入servcie的注冊文件:OAuth2-100001. json,內容如下
(路徑:D:\casoverlay\cas-overlay-template\src\main\resources\services)
1 { 2 "@class" : "org.apereo.cas.support.oauth.services.OAuthRegisteredService", 3 "clientId": "100001", 4 "clientSecret": "100001abcdeft", 5 "serviceId" : "^(https|http|imaps)://.*", 6 "name" : "OAuthService", 7 "id" : 100
8 }
-5. OK,可以打包了
mvn package
-6. 打包后打target\cas.war部署到tomcat
搭建OK了,我們來驗證下功能
功能驗證
·1. 訪問如下地址:
https://cas.example.org:8443/cas/oauth2.0/authorize?response_type=code&client_id=100001&redirect_uri=http://www.baidu.com
參數說明:
response_type=code,這個是按照code的方式接入,有多種接入方式
client_id=100001,這個參數的值是servcie注冊的定義的,每個接入系統都分配一個值
redirect_uri=http://www.baidu.com:這個是認證通過后跳轉的地址。我這個是示例,認證成功后,就跳轉到百度。您需要修改成您的接入系統;
·2. 輸入登錄帳號名密碼,跳轉到OAuth2.0的授信畫面
-3. 點擊允許后,跳轉到baidu.com,后面帶有參數code
-4. 通過code獲取accessToken,
接入程序需要調用如下地址,
目前我們是瀏覽器直接訪問這個地址做模擬吧
https://cas.example.org:8443/cas/oauth2.0/accessToken?grant_type=authorization_code&client_id=100001 &client_secret=100001abcdeft&code=OC-2-3M6BedCz7TLIz0rpJUm-uLzPoFBbPOO0&redirect_uri=http://www.baidu.com
頁面會返回如下文字信息
access_token=AT-1-53AfGdKA2mL5IbI1iP29n6HlXcWL3Q5b&expires_in=28800
這個就是access_token
-5. 通過accessToken獲取當前登錄用戶信息
https://cas.example.org:8443/cas/oauth2.0/profile?access_token=AT-1-53AfGdKA2mL5IbI1iP29n6HlXcWL3Q5b
返回
1 { 2 "service" : "http://www.baidu.com", 3 "attributes" : { 4 "credentialType" : "UsernamePasswordCredential"
5 }, 6 "id" : "admin", 7 "client_id" : "100001"
8 }
大功告成
這個就是模擬了接入系統按照OAuth2.0協議獲取的用戶登錄信息
當然本章只是使用code方式接入,
還有其他的接入方式,
比如接入程序自己編寫登錄畫面,獲取到用戶名和密碼后給到Cas Server,這樣對用戶體驗更好。
參考文章
最后,大家想更多CAS了解的話,可以來CAS中文文檔站點(http://www.cassso-china.cn)來瞅瞅