YMP-OAuth-Connector基于 YMP 框架的第三方 OAuth 授權(quán)登錄模塊

OAuth Connector

基于YMP框架實現(xiàn)的第三方OAuth授權(quán)登錄模塊, 目前已實現(xiàn):

Maven包依賴

<dependency>
    <groupId>net.ymate.module</groupId>
    <artifactId>ymate-module-oauth-connector</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

搭建模塊工程

• 首先，你需要創(chuàng)建一個基于YMPv2框架的JavaWeb工程項目；（如何快速搭建工程?）

• YMP框架掃描包路徑要包含net.ymate.module.oauth.connector, 調(diào)整配置如下:

    # 框架自動掃描的包路徑集合，多個包名之間用'|'分隔，默認(rèn)已包含net.ymate.platform包，其子包也將被掃描
    ymp.autoscan_packages=net.ymate

• 調(diào)整WebMvc模塊中配置如下：

    # 控制器請求映射路徑分析器，，可選值為已知分析器名稱或自定義分析器類名稱，默認(rèn)為default，目前支持已知分析器[default|restful|...]
    ymp.configs.webmvc.request_mapping_parser_class=restful

注: 推薦將YMP框架更新至最新(Maven中央庫發(fā)布的版本較緩), 請前往下載最新代碼

模塊配置參數(shù)說明

#-------------------------------------
# module.oauth.connector 模塊初始化參數(shù)
#-------------------------------------

# 緩存名稱前綴, 默認(rèn)值: ""
ymp.configs.module.oauth.connector.cache_name_prefix=

# 連接授權(quán)回調(diào)處理器, 默認(rèn)值為net.ymate.cms.oauth.connector.impl.DefaultConnectCallbackHandler
ymp.configs.module.oauth.connector.callback_handler_class=

# 密碼類參數(shù)是否已加密, 默認(rèn)值: false
ymp.configs.module.oauth.connector.password_encrypted=

# 密碼處理器, 可選參數(shù), 用于對已加密OAuth客戶端密鑰進(jìn)行解密，默認(rèn)值: 空
ymp.configs.module.oauth.connector.password_class=

#--------------------------
# 以下為各連接器的初始化配置, xxx表示連接器名稱, 目前支持[github|wechat|qq|weibo|oschina|baidu|google|linkedin|windowslive]
#--------------------------

# OAuth客戶端ID, 必選項
ymp.configs.module.oauth.connector.xxx.client_id=

# OAuth客戶端密鑰, 必選項
ymp.configs.module.oauth.connector.xxx.client_secret=

# 重定向URL地址, 可選參數(shù), 默認(rèn)值: 空
ymp.configs.module.oauth.connector.xxx.redirect_uri=

啟動并測試

• 申請并配置好OAuth客戶端ID和密鑰(訪問https://github.com/settings/developers進(jìn)行申請);

• 在申請過程中需要填寫redirect_uri地址, 請?zhí)顚? http://<你的域名>/oauth/connect/github/redirect;

• 打包工程并部署到目標(biāo)服務(wù)器;

• 打開瀏覽器并輸入網(wǎng)址, 如: http://<你的域名>/oauth/connect/github 進(jìn)行授權(quán)測試;

• 如果OAuth請求授權(quán)成功，則默認(rèn)callback_handler_class處理器將為你顯示回應(yīng)的JSON數(shù)據(jù), 接下來請自行編寫IOAuthConnectCallbackHandler接口實現(xiàn)來存儲授權(quán)信息吧:)

One More Thing

YMP不僅提供便捷的Web及其它Java項目的快速開發(fā)體驗，也將不斷提供更多豐富的項目實踐經(jīng)驗。

了解更多有關(guān)YMP框架的內(nèi)容，請訪問官網(wǎng)：http://www.ymate.net/