1.1 第三方單點登錄NC Cloud概覽
第三方單點登錄的流程:
- 客戶端向服務端發起登陸NC Cloud請求。
- 向NC Cloud服務器注冊校驗用戶登陸和上下文信息。
- 如果校驗成功NC Cloud服務器響應給客戶服務器token信息
- 客戶服務器將token響應給客戶端
- 客戶端收到token后拼接請求NC Cloud節點的url信息。
- NC Cloud收到請求並驗證token是否合法,如果合法,則重定向到客戶端請求的節點頁面。

1.2 第三方系統單點登錄NC Cloud詳細流程
1.1.1 在NC Cloud的系統注冊表sm_oauth_security注冊第三方系統
表中各字段含義如下:
- CLIENT_ID :第三方系統編碼,必需項
- CLIENT_NAME: 第三方系統名稱,非必需
- CLIENT_SECURITY: 第三方系統和NC Cloud共同維護的秘鑰對
- PK_OAUTH_SECURITY: 主鍵,
- CLIENT_URL: 第三方系統的url (供NC Cloud集成訪問第三方系統使用,本環節不需要)
- CLIENT_AUTHCLASS: 登錄第三方系統授權類 (供NC Cloud集成訪問第三方系統使用,本環節不需要)
- PK_GROUP:非本環節使用,設置為空
1.1.2 獲取登錄token
通過秘鑰對獲取登錄token,第三方服務訪問http://ip:port/service/genThirdPartyAccessToken 同時訪問參數為:
- ype 獲取方式,此方式為固定為 type_security且必需項
- dsname 數據源名稱,必需項
- usercode NC Cloud用戶編碼,必需項
- langcode 多語語種,非必需項,為空默認中文語種
- busicentercode 賬套編碼,非必需項,為空登錄時會循環在數據源中查找用戶
- ts ,第三方系統加簽的時間,用來生成校驗秘鑰對,必需項
- client_id第三方系統id,即第一步在sm_oauth_security注冊的系統編碼,必需項
- security第三方由共同維護的秘鑰對根據給定的算法自己生成的秘鑰值,必需項。 security是通過SHA256加簽,其中是根據usercode,ts,client_security和當前系統時間動態拼接的字符串生成
package com.yomyou.nccloud.oauth2;
import java.io.DataOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;
import nccloud.security.impl.SignatureTookKit;
import org.apache.commons.codec.binary.Base64;
public class PostThirdPartyAccessTokenTest {
public static void main(String[] args) throws Exception {
String dsname = "devlop";
String usercode = "admin";//nccy用戶編碼
String client_id = "portal";//第三方系統id
String client_security = "123qwe";//第三方秘鑰
String langcode = "";//多語語種
String busicentercode = "";//業務中心
String groupcode = "";//集團編碼
URL preUrl = new URL("http://127.0.0.1:6500/service/genThirdPartyAccessToken");
URLConnection uc = preUrl.openConnection();
uc.setDoOutput(true);
uc.setUseCaches(false);
uc.setRequestProperty("Content-Type",
"application/x-www-form-urlencoded");
uc.setRequestProperty("Content-Length", "10000" );
uc.setRequestProperty("userid", "admin");
HttpURLConnection hc = (HttpURLConnection) uc;
hc.setRequestMethod("POST");
OutputStream os = null;
DataOutputStream dos = null;
String returnFlag = "";
InputStream is = null;
try {
StringBuffer sb = new StringBuffer();
String security = genKey(usercode,usercode + client_security + (System.currentTimeMillis() + "").substring(0, 6));
sb.append("type=type_security&dsname="+dsname+"&usercode="+usercode+"&client_id="+client_id+"&security="+security);
os = hc.getOutputStream();
dos = new DataOutputStream(os);
dos.writeBytes(sb.toString());
dos.flush();
is = hc.getInputStream();
int ch;
while ((ch = is.read()) != -1) {
returnFlag += String.valueOf((char) ch);
}
System.out.print(returnFlag);
} catch (Exception e) {
} finally {
if (dos != null) {
try {
dos.close();
} catch (Exception e2) {
}
}
if (os != null) {
try {
os.close();
} catch (Exception e2) {
}
}
if (is != null)
try {
is.close();
} catch (Exception e2) {
}
}
}
private static String genKey(String userid,String key) throws Exception{
return new Base64().encodeToString(SignatureTookKit.digestSign(userid.getBytes(), key.getBytes()));
}
}
訪問NCC資源
提供登錄NC Cloud系統URL,token是從第二步成功返回結果,該值默認保留1分鍾,超時或使用過一次則失效。 URL信息如下: http://ip:port/uap/rbac/thirdpartylogin/main/index.html?accesstoken=xxx &redirect_uri=http://ip:port/nccloud。 ip和port是NC Cloud的服務地址的ip和端口號。 http://ip:port/uap/rbac/thirdpartylogin/main/index.html為固定地址。 accesstoken=xxx為(4)中獲取的臨時token 。 redirect_uri=http://ip:port/nccloud為成功登錄后要重定向的地址,如后面為空,默認跳到工作桌面。如果是列表或卡片節點,需改為節點的url的地址。如果是審批詳情頁面,需要客開,因為審批詳情頁面的url不同其他頁面,需要向NC Cloud服務器請求獲取。拼接完成訪問url時,NC Cloud服務器收到該請求,會驗證token和用戶登錄NC Cloud權限,驗證通過則重定向到redirect_uri。
