钉钉集成移动BOS应用

前言：

• 移动BOS是公网应用，要求客户的EAS服务器有公网可访问的地址；

  
  

• EAS服务器会访问钉钉的接口，需要EAS能访问到钉钉服务地址，一般能访问公网就没有问题；

  
  

• 本文集成方案将不再支持低于8.0版本的EAS，低版本的建议升级EAS。
  

一、  注册开通移动bos平台

• 注册过程移动bos平台会访问eas的接口，需要eas开放外网地址

• 如果现场网络要求严格，可以仅代理出EAS服务的mbos工程的接口即可，例如http://127.0.0.1:6888/mbos

1、获取客户钉钉的企业id

        企业id（eid）用作客户在移动BOS平台的唯一标识，对应客户唯一的EAS服务，要用钉钉管理人员登录管理后台查看，如下图：Corpid即企业id。

2、更新补丁

        更新移动bos&流程助手模块补丁，查看补丁更新步骤

3、提交部署 （请使用管理员登录！）

    方式1：登录EAS门户->应用->EAS移动门户->移动开发门户->移动BOS-安装部署 

    方式2：打开链接地址进行部署： http://EAS外网服务器ip:端口/easweb/light_deploy/deploy.jsp 

    如下图：配置时请填写正确的钉钉企业号！提交的应用信息请到第二步创建应用

小结

• 通过以上步骤，客户已经可以在移动BOS平台登录，在主页的企业登录进行登录

  
  

• 公有云移动bos的主页为：https://mbos.kdeascloud.com

  
  

• 使用administrator登录可管理应用的许可，给EAS账号赋予开发权限

  
  

• 使用EAS开发者账号登录可管理平台上的轻应用

二、  移动BOS应用配置

    1、钉钉上创建应用

            钉钉管理人员登录管理后台，过程如图

2、钉钉应用权限申请

        创建应用并申请接口权限：

            个人权限    —> 个人手机号信息(Contact.User.mobile)

            通讯录管理 —> 成员信息读权限 (qyapi_get_member)

        流程助手应用还需要申请：

            待办任务—> 待办应用中待办写权限（Todo.Todo.Write）

3、配置服务器出口ip

• 服务器出口ip是服务器的公网ip，可在服务器的浏览器中百度ip，即可看到本机的公网ip；

• Linux系统的服务器可自行百度如何查看公网ip；

• 如果客户现场的网络环境已知有多个出口ip，请将这这些ip都配置上去，避免出口ip的切换导致应用不能使用！
  

    注意！出口ip不一定是服务器的公网ip，现场的服务器有的网络出入口是不同的，这点经常有人弄错导致应用不能使用！

4、配置应用首页地址

        以下是常用应用的链接地址（链接中红色字体是需要修改的部分，其他信息不用改）：

        流程助手：

        https://mbos.kdeascloud.com/mbos/auth/dingtalk.html?CorpId=$CORPID$&eid=$CORPID$&AppKey=dingqhyxdmlhr90sb4y8

        SHR应用：如员工自助、经理人自助、天天勤等应用链接，可在专项服务中咨询相关人员。

        现场开发的移动bos应用：
        可在预览页面获取到应用的链接，再获取到链接中的path和name参数，再修改以下链接中对应的参数,其他想加入的参数在链接后面加上即可;

            https://mbos.kdeascloud.com/mbos/auth/dingtalk.html?CorpId=$CORPID$&eid=$CORPID$&replaceUrl=page/loadPage&path=mcpbc/bizAccount&name=bizAccountEdit.editui&AppKey=dingqhyxdmlhr90sb4y8

5、EAS添加钉钉应用配置

        配置文件：{EASHOME}/eas/server/properties/XTServiceConfig.xml

        修改说明：(箭头指向的配置区域都是需要修改的地方)

        1、配置文件的 config根节点下增加一个Dingtalk配置项，与DbInfo为兄弟节点，可在提供的配置文件的基础上修改。如截图；

        2、AppSecret配置项原文件就有，加上新建应用的配置即可，在钉钉上每建一个应用，都需要