云简标准SSO

文档说明

本文旨在提供标准的云简系统的单点登录方式，由云简提供认证服务。

术语

• 加密模式。云简标准SSO支持AES/ECB/PKCS5Padding和AES/CBC/PKCS5Padding两种加密模式，默认AES/ECB/PKCS5Padding。用于加密用户信息。
• 公司编码和密钥。客户在云简系统拥有唯一编码和密钥，用于获取用户标识加密code。
• 用户标识。云简和客户双方需要约定用户的唯一标识（员工号/用户名/邮箱等），默认员工号。

步骤

1. 选择加密方式和用户标识。
2. 根据云简提供的公司编码(company_code)和密钥(company_key)，获取/生成用户标识加密code。
3. 拼接SSO跳转链接。

要点

1. SSO链接有效期默认十分钟，可配置，需在选用加密模式和用户标识阶段确定。
2. 获取用户信息的加密code分两种方式：接口调用/代码实现，详见附录1。
3. 拼接SSO跳转链接详见附录2，生产环境与测试环境的链接不同。

附录1

接口调用

• 接口说明：获取用户信息的加密code

• 接口地址：common/oauth2/unAuth/authorize

• Method：POST

• 请求参数：

• 请求示例：

{
  "bizId": "634899ef-d591-4829-ac18-0bcc135251ff",
  "timestamp": 1605010305740,
  "data": {
    "user_id": "xxxx@xxx.com",
    "company_code": "xxx",
    "company_key": "xxx",
    "timestamp": "1605010305740"
  }
}

• 返回参数：

• 返回示例：

成功：
{
  "resCode": 200000,
  "resMsg": "生成code成功",
  "bizId" : "634899ef-d591-4829-ac18-0bcc135251ff",
  "data": {
    "code":"jdsPBlZkOFjQKYokgaSTILKC47Ey9q5Rw6gaS8YePvDaRkO8sWWnUMxqTYYIxDU0"
  }
}
失败：
{
  "resCode": 500000,
  "resMsg": "company key 验证失败",
  "bizId": "634899ef-d591-4829-ac18-0bcc135251ff "
}

MD5 DEMO

public static String byteArrayToHex(byte[] byteArray) {
  char[] hexDigits = {'0','1','2','3','4','5','6','7','8','9', 'a','b','c','d','e','f' };
  char[] resultCharArray =new char[byteArray.length * 2];
  int index = 0;
  for (byte b : byteArray) {
    resultCharArray[index++] = hexDigits[b>>> 4 & 0xf];
    resultCharArray[index++] = hexDigits[b& 0xf];
  }
  return new String(resultCharArray);

}

public static String MD5(String str){
  MessageDigest md = null;
  try {
    md = MessageDigest.getInstance("MD5");
  } catch (Exception e){
    throw new RuntimeException("MD5 Exception");
  }
  md.update((str).getBytes(StandardCharsets.UTF_8));
  return MD5toString.byteArrayToHex(md.digest());
}

代码实现

public static String Encrypt(String sSrc, String sKey, String entryMode) {
  entryMode = !Strings.isNullOrEmpty(entryMode) ? entryMode : "AES/ECB/PKCS5Padding";
  try {
    if (sKey == null) {
      log.info("Key为空null");
      return null;
    }
    // 判断Key是否为16位
    if (sKey.length() != 16) {
      log.info("Key长度不是16位");
      return null;
    }
    byte[] raw = sKey.getBytes("utf-8");
    SecretKeySpec skeySpec = new SecretKeySpec(raw, "AES");
    Cipher cipher = Cipher.getInstance(entryMode);//"算法/模式/补码方式"
    cipher.init(Cipher.ENCRYPT_MODE, skeySpec);
    byte[] encrypted = cipher.doFinal(sSrc.getBytes("utf-8"));
    //此处使用BASE64做转码功能，同时能起到2次加密的作用。
    return URLEncoder.encode(new Base64().encodeToString(encrypted), "utf-8");
  } catch (Exception e) {
    log.error("加密出错", e);
  }
  return null;
}

附录2

跳转地址：https://qa.cloudpense.com/tmp/sso.html?source=new&companyCode=COMPANYCODE&position=POSITION&pathId=PATHID&documentId=DOCUMENTID&headerTypeId=HEADERTYPEID&embedded=EMBEDDED&code=CODE

参数说明如下：

示例：https://qa.cloudpense.com/tmp/sso.html?source=new&companyCode=xxx&position=approve&pathId=25&code=CODE

跳转成功后的首页，如下所示：