NCC2005單點登錄

第三方系統單點登陸NC Cloud

1 第三方單點登錄NC Cloud概覽

第三方單點登錄的流程：

1. 客戶端向服務端發起登陸NC Cloud請求。
2. 向NC Cloud服務器注冊校驗用戶登陸和上下文信息。
3. 如果校驗成功NC Cloud服務器響應給客戶服務器token信息
4. 客戶服務器將token響應給客戶端
5. 客戶端收到token后拼接請求NC Cloud節點的url信息。
6. NC Cloud收到請求並驗證token是否合法，如果合法，則重定向到客戶端請求的節點頁面

詳細流程圖見下圖：

　　　　

 

2 第三方系統單點登錄NC Cloud詳細流程

2.1 在NC Cloud的系統注冊表sm_oauth_security注冊第三方系統

表中各字段含義如下：

1. CLIENT_ID ：第三方系統編碼,必需項
2. CLIENT_NAME： 第三方系統名稱，非必需
3. CLIENT_SECURITY： 第三方系統和NC Cloud共同維護的秘鑰對
4. PK_OAUTH_SECURITY： 主鍵，
5. CLIENT_URL： 第三方系統的url (供NC Cloud集成訪問第三方系統使用，本環節不需要)
6. CLIENT_AUTHCLASS： 登錄第三方系統授權類 (供NC Cloud集成訪問第三方系統使用，本環節不需要)
7. PK_GROUP：非本環節使用，設置為空

2.2 獲取登錄token

通過秘鑰對獲取登錄token，第三方服務訪問http://ip:port/service/genThirdPartyAccessToken 同時訪問參數為：

1. ype 獲取方式，此方式為固定為 type_security且必需項
2. dsname 數據源名稱,必需項
3. usercode NC Cloud用戶編碼,必需項
4. langcode 多語語種,非必需項，為空默認中文語種
5. busicentercode 賬套編碼,非必需項，為空登錄時會循環在數據源中查找用戶
6. ts ,第三方系統加簽的時間，用來生成校驗秘鑰對,必需項
7. client_id第三方系統id,即第一步在sm_oauth_security注冊的系統編碼，必需項
8. security第三方由共同維護的秘鑰對根據給定的算法自己生成的秘鑰值，必需項。 security是通過SHA256加簽，其中是根據usercode，ts，client_security和當前系統時間動態拼接的字符串生成

 　　注：8中的client_security為第三方密鑰，當第三方不需要該密鑰時，與1.1.1第三方系統注冊中CLIENT_SECURITY參數保持一致。

代碼如下：

String CLIENTID = "NCCceshi";
    
String CLIENTSECURITY = "123qwe";

//系統編碼
String appCode = "CA_SYS";
        
//當前待辦需要打開的環境Url(即用友NC服務器)http://ip:port/
String signUrl = http://127.0.0.1:8009/;
        
//當前系統使用的賬套
String accCode = "NCC";
        
//當前系統帳套編碼關聯的數據源
String ds = "desgin";

//用戶編碼
String userCode = "test"

//獲取用戶單點憑證
String nccToken = HttpRequestUtil.getNCCToken(signUrl, ds, userCode, CLIENTID, CLIENTSECURITY, accCode);

String redirectUrl = signUrl + "/nccloud/resources/uap/rbac/thirdpartylogin/main/index.html?accesstoken=" + nccToken + "&redirect_uri=" + signUrl + "/nccloud/resources/workbench/public/common/main/index.html#/";

// 跳轉到主頁桌面
resp.sendRedirect(redirectUrl);

token獲取

public class HttpRequestUtil {
    
    public static String getNCCToken(String url, String dsname, String usercode, String nccClient_id, String nccClient_secret, String accCode) throws Exception {
        OutputStream os = null;
        DataOutputStream dos = null;
        InputStream is = null;
        
        String returnFlag = "";
        
        try {
            URL preUrl = new URL(url + "/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", usercode);
            
            HttpURLConnection hc = (HttpURLConnection) uc;
            
            hc.setRequestMethod("POST");
            
            StringBuffer sb = new StringBuffer();
            
            String security = genKey(usercode,usercode + nccClient_secret + (System.currentTimeMillis() + "").substring(0, 6));
            
            sb.append("type=type_security&dsname="+dsname+"&usercode="+usercode+"&client_id="+nccClient_id+"&security="+security+"&busicentercode="+accCode);
            
            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);
            }
            
            if(returnFlag == null || returnFlag.trim().length() == 0){
                throw new BusinessException("獲取NCC Token失敗，請檢查");
            }
            
        } catch (Exception e) {
            e.printStackTrace();
            throw 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) {
            }
        }
        return returnFlag;
    }
    
    private static String genKey(String userid,String key) throws Exception{
        return new Base64().encodeToString(SignatureTookKit.digestSign(userid.getBytes(), key.getBytes()));
    }
}

3 信任IP添加

在home\ierp\sf\nccssoConfig.xml中添加

<?xml version="1.0" encoding="UTF-8"?>
<NCCSSOConfigVO>
    <authenticator id="default" classname="ncc.sso.bs.DefaultNCCSSOAuthenticator">
        <regTimeOut>200</regTimeOut>
        <listParam key="IPAddress">
            <string>127.0.0.1</string>
        </listParam>
    </authenticator>
    <authenticator id="type" classname="nc.sso.bs.AAA">
        <regTimeOut>200</regTimeOut>
        <listParam key="IPAddress">
            <string>127.0.0.1</string>
        </listParam>
    </authenticator>
</NCCSSOConfigVO>

 

 

NCC2005產品本身單點登錄有點問題，需要對應補丁包，否則可能會出現token獲取成功，重定向后頁面白板

有問題可以互相學習討論