云之家集成第三方应用

云之家集成

2.3.1准备

进入云之家后台建立轻应用

准备好APP ID 、APPSecret 和团队EID。

2.3.2集成要点

类似于微信，云之家对外开放的接口都需要通过信鸿OAuth2.0授权协议获取到accessToken进行授权后才能访问。

云之家access_token有效期为7200秒，不同于微信，通过云之家URL在7200秒之内获取到的access_token不变，在第三方应用后台将access_token缓存到redis时注意逻辑的处理，必要时需要调用云之家刷新access_token的刷新接口。

获取云之家用户信息流程

集成过程

2.3.3开发步骤

2.3.3.1登录云之家后台，配置应用入口URL和可见范围

2.3.3.2 配置的入口URL跳转到应用的中间页面并追加带入ticket，调用后台登录接口并传入ticket。

URL举例：

http://192.168.0.1/?redirectPage=ApprovalPage&pageName=XinHong&ticket=APPURLWITHTICKETc0ac6a233e97e73467a1fc10898b185e&client_id=500000183&expire_time=1577781405153&msgShowStyle=31#/approval/nav/n5/approval-list

2.3.3.3 后台通过ticket等获取云之家用户信息，验证并做登录

1）根据应用appId+应用Secret 获取access_token，并缓存到redis

2）根据access_token+ticket获取云之家用户基本信息（userName、userId、jobNo）

3）根据userid和jobNo匹配后台用户信息映射表并做应用的登录

核心代码

/**
* 获取并验证云之家映射用户信息
* @param map
* @return
*/
public ModuleReturn<?> preLoginForXH(LoginUser loginUser) {
ModuleReturn<?> moduleReturn = ModuleReturn.ok();
String ticket = loginUser.getTicket();
if(ticket==null||"".equals(ticket))
{  String xhNoTicket = messageHandler.getMessage("xhNoTicket");   moduleReturn.setCode(ConstUtils.COM_FAIL_500);  moduleReturn.setReturnMessage(xhNoTicket);  return moduleReturn ;
}  SystemService sService = SpringBeanUtil.getBean(SystemService.class);
String accessToken = this.getAccessToken();
AdSysParamDto aspd = sService.getAdSysParamDtoByTypeAndCode("XH_PARAM","USER_INFO_URL");
AdSysParamDto aspd2 = sService.getAdSysParamDtoByTypeAndCode("XH_PARAM","APP_ID");
if(aspd!=null && aspd2!=null)
{  String userUrl = aspd.getParamValues();//url  String appId = aspd2.getParamValues();  if(userUrl!=null)  {  userUrl = userUrl.replace("{ACCESS_TOKEN}", accessToken);  JSONObject userParam = new JSONObject();  userParam.put("appid", appId);  userParam.put("ticket", ticket);  String userParamStr = userParam.toString();  logger.debug("*****ticket:"+ticket+"****获取云之家用户信息接口URL："+userUrl+"************");          logger.debug("*****ticket:"+ticket+"****获取云之家用户信息接口参数："+userParamStr+"************");                  String resStr = LocalUtil.sendPost(userUrl, userParamStr);  logger.debug("*****ticket:"+ticket+"****获取云之家用户信息接口结果："+resStr+"************");  JSONObject json = JSONObject.parseObject(resStr);  String errorCode = json.getString("errorCode") ;  if(errorCode.equals("0"))  {  JSONObject data = json.getJSONObject("data");  String userId = data.getString("userid");  String jobNo = data.getString("jobNo");  if(userId!=null && !"".equals(userId))  {  Map<String, Object> param = new HashMap<String, Object>();  param.put("xhUserId", userId);  param.put("xhJobNo", jobNo);  ModuleReturn<UserInfoXhMappingDto> weUserModule = userInfoXhMappingAPI.queryUserInfoXHMapping(param);  if(weUserModule.isSuccess())  {  UserInfoXhMappingDto xhUser = weUserModule.getDatas();  if(xhUser!=null)  {  String userAccount = xhUser.getUserAccount();  loginUser.setIsPointLogin("1");//单点登录  loginUser.setUserAccount(userAccount);  loginUser.setPassword(userAccount);//单点登录密码不校验  }  }  else //未获取到映射关系,根据jobNo登录并建立映射关系  {  UserInfoDto userDto = new UserInfoDto();  userDto.setUserAccount(jobNo);  userDto.setDeletedFlag(AppConstUtil.DEL_FLAG_NO);  ModuleReturn<UserInfoDto> userModule = userInfoAPI.selectOne(userDto);  if(userModule.isSuccess()&&userModule.getDatas()!=null)  {  UserInfoDto uDto = userModule.getDatas();  String userAccount = uDto.getUserAccount();  loginUser.setIsPointLogin("1");//单点登录  loginUser.setUserAccount(userAccount);  loginUser.setPassword(userAccount);//单点登录密码不校验  UserInfoXhMappingDto userIfoXhDto =new UserInfoXhMappingDto();  userIfoXhDto.setUserId(uDto.getId());  userIfoXhDto.setUserAccount(userAccount);  userIfoXhDto.setXhUserId(userId);  userIfoXhDto.setXhJobNo(jobNo);  Date sysDate = DateCovertUtil.getSysDate();   userIfoXhDto.setGmtCreate(sysDate);  userIfoXhDto.setGmtModified(sysDate);  userIfoXhDto.setCreateBy(uDto.getId());  userIfoXhDto.setLastModifiedBy(uDto.getId());  userIfoXhDto.setDeletedFlag(AppConstUtil.DEL_FLAG_NO);  userInfoXhMappingAPI.saveUserXHMapping(userIfoXhDto);  }  else  {  String xhNoPermission = messageHandler.getMessage("xhNoPermission");   logger.debug("*********云之家用户"+jobNo+"对应的本系统用户不存在************");  moduleReturn.setCode(ConstUtils.COM_FAIL_500);  moduleReturn.setReturnMessage(jobNo+xhNoPermission);  return moduleReturn ;  }  }  }  else  {  String tip = messageHandler.getMessage("xhNoUserId");  moduleReturn.setCode(ConstUtils.COM_FAIL_500);  moduleReturn.setReturnMessage(tip);  return moduleReturn ;  }  }
}  return moduleReturn;

2.3.4 集成效果

应用集合：

第三方应用入口：

第三方应用页面：