学习目标

掌握第三方APP如何集成苍穹应用的方案

内容简介

本单元会介绍第三方APP集成苍穹应用的方案，

背景

随着移动互联网的兴起，越来越多的人喜欢在手机APP中处理个人生活和工作相关的事宜，下一代苍穹作为企业信息处理中枢，需要和类似云之家、企业微信之类的手机APP应用进行集成以方便用户业务处理。

方案简介

第三方APP集成苍穹的应用，首先要解决苍穹人员和第三方APP人员同步的问题，其次第三方APP需要建一个新应用，新应用配置苍穹应用首页的URL，以实现点击新应用会跳转到苍穹应用首页，最后要解决跳转苍穹应用首页时登录问题，由于第三方APP已经登录过了，且人员是同步的，为了避免重复登录认证，需要开发插件实现免登录。

人员同步配置

苍穹与任何系统集成基本上都要考虑和解决人员同步的问题，目前苍穹标准产品预置了云之家、企业微信、钉钉等第三方应用的同步功能。在系统服务云-配置工具-系统参数-系统服务云-基础服务中启用对应的第三方应用后，在系统服务云-基础服务-人员中会显示对应的同步按钮。

人员同步标准方案参考

其他第三方APP如果也需要做人员同步操作，可参考标准产品同步人员方案。

a. 同步功能的主要逻辑是：通过第三方系统提供的组织人员接口，获取到人员信息，并以两个系统中人员的焦点(比如手机号、邮箱账号等)作为比较条件，建立两个系统的人员映射关系，存储至苍穹系统中。

b. 苍穹与微信、钉钉等第三方系统人员映射关系表t_bas_immapping。

字段	编码	类型	描述
	FID	Bigint(20)
映射类型ID	FIMTYPEID	Bigint(20)	0~100为原厂预留，扩展渠道第三方需要>100
苍穹人员ID	FUSERID	Bigint(20)	t_sec_user表中ID
第三方系统人员ID	FOPENID	Varchar(80)

c. 参考代码实现：

kd.bos.sec.user.utils.UserOperationUtils.synWxqyh，该方法为企业微信同步人员信息实现过程，其中saveIMMapping方法为保存账号映射关系。

注意：需要同步处理人员新增情况，考虑第三方是否提供增量同步接口等。

免登录配置

目前苍穹标准产品已经实现与企业微信，钉钉和微信公众号的免登录认证，在系统服务云-配置工具-单点登录中添加对应的应用账号信息，然后在配置管理中心（MC）配置当前环境需要使用的第三方APP的认证类，如果多个APP同时存在，多个类之间用，隔开，配置后需要重新发布集群。

企业微信的认证类是kd.bos.login.thirdauth.app.tencent.WxqyhAuthtication，

云之家认证类是kd.bos.login.thirdauth.app.yzj.YZJAppAuthtication，

微信公众号认证类是kd.bos.login.thirdauth.app.tencent.WxgzhAuthtication，

钉钉认证类是kd.bos.login.thirdauth.app.dingding.DDAuthtication。

免登录开发

其他第三方APP如果也想实现免登录，可参考标准产品企业微信免登陆方案。

a.开发一个基础资料存储第三方应用的账号信息，如系统服务云-配置工具-单点登录-企业微信号。

b.苍穹接收到第三方的请求后需要处理与第三方应用的认证处理逻辑。开发时只需要实现一个类继承ThirdAppAuthtication并重写isNeedHandle和appAuthtication方法。

（1）isNeedHandle方法

方法的目的检查当前所使用的url是否是本APP应用自己需要处理的，如果是返回true，否返回false。

示例：

  @Override
  public boolean isNeedHandle(HttpServletRequest request,Account currentCenter) {
        boolean isNeed = false;
        String ticket = request.getParameter("ticket");
        if(StringUtils.isNotEmpty(ticket)&&){
            isNeed=true;
        }
        return isNeed;
    }

（2）appAuthtication方法

方法的目的是如果当前所使用的url是本应用需要处理的，则自己实现和第三方应用的认证处理逻辑并返回用户的标识及标识类型，方便苍穹系统建立关联。

示例：

@Override
    public AppAuthResult appAuthtication(HttpServletRequest request,Account currentCenter) {
        // TODO Auto-generated method stub
        AppAuthResult result = new AppAuthResult();
        result.setSucceed(false);
        try {
            String ticket = request.getParameter("ticket");
            // 请求的URL路径
            String path = request.getServletPath();
            // 轻应用id确定，由于云之家url变更做如下处理
AppContext appCtx = TicketService.getContextByTicket(currentCenter.getTenantId(), ticket);
            if (appCtx != null) {
                result.setSucceed(true);//
                result.setUserFlag(appCtx.getMobile());
                result.setUserType(UserType.MOBILE_PHONE);
            }
        } catch (KDException ex) {
            throw ex;          
        } catch (Exception e) {
            logger.error(e);
String sMsg = String.format("App验证错误: ", ExceptionUtils.getExceptionStackTraceMessage(e));
    throw new KDException(LoginErrorCode.loginBizException, sMsg);
        }
        return result;
}

说明：

AppAuthResult.isSucceed :认证是否成功，如果是返回true，否返回false;

AppAuthResult.UserType:返回用户的类型。目前支持手机，uid，yzhuid三种，以后可扩展;

AppAuthResult.UserFlag：返回用户类型具体的值，比如手机号或uid值等。

可参考YZJAppAuthtication、WxqyhAuthtication的实现。

c. 在配置管理中心配置authtication.apps，加上自己二开的实现类。

例子：企业微信免登录苍穹

人人费用、人人差旅集成到企业微信详细操作见

https://vip.kingdee.com/article/224185432299076352

第三方APP如何集成苍穹应用

恭喜您！