YMP-OAuth-Connector基于 YMP 框架的第三方 OAuth 授權登錄模塊

OAuth Connector

基于YMP框架實現的第三方OAuth授權登錄模塊, 目前已實現:

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, 調整配置如下:

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

• 調整WebMvc模塊中配置如下：

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

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

模塊配置參數說明

#-------------------------------------
# module.oauth.connector 模塊初始化參數
#-------------------------------------

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

# 連接授權回調處理器, 默認值為net.ymate.cms.oauth.connector.impl.DefaultConnectCallbackHandler
ymp.configs.module.oauth.connector.callback_handler_class=

# 密碼類參數是否已加密, 默認值: false
ymp.configs.module.oauth.connector.password_encrypted=

# 密碼處理器, 可選參數, 用于對已加密OAuth客戶端密鑰進行解密，默認值: 空
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地址, 可選參數, 默認值: 空
ymp.configs.module.oauth.connector.xxx.redirect_uri=

啟動并測試

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

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

• 打包工程并部署到目標服務器;

• 打開瀏覽器并輸入網址, 如: http://<你的域名>/oauth/connect/github 進行授權測試;

• 如果OAuth請求授權成功，則默認callback_handler_class處理器將為你顯示回應的JSON數據, 接下來請自行編寫IOAuthConnectCallbackHandler接口實現來存儲授權信息吧:)

One More Thing

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

了解更多有關YMP框架的內容，請訪問官網：http://www.ymate.net/