1.概述

1.1 应用场景

   随着企业内部信息技术的迅猛发展，内部的应用系统越来越多，由于这些系统相互独立，用户在使用每个系统之前都必须   按照相应的系统身份进行登录，为此用户需记住每一个系统的用户名和密码，这给用户带来了不少麻烦。特别是随着系统    的增多，出错的可能性就会增加，收到非法截获和破坏的可能性也会增大，安全性就会相应降低。针对于这种情况，在BI  项 目整体规划中也就有钉钉集成，这样就能减少那些不必要的麻烦，安全性也能够相应的提升。

1.2 功能介绍

环境配置、配置参数、云之家添加应用

1.3 环境准备

Node,

pm2,

redis,

mysql/sqlite

1.4版本配置差异

新框架V2.0以后版本配置云之家集成参考：云之家集成（新）

1.5 云之家部署

2. 云之家相关

 ,cloudOp:{

  appid:"500357331",//云之家轻应用id(非云之家App和非桌面版登录轻应用所需)
  secret:"mySe3WCuuD2wTJ0JRXYG",//云之家轻应用secret,即appsecret(非云之家App和非桌面版登录轻应用所需)

 }

 新建完轻应用之后从轻应用明细获取

 如图：

3.云之家增加应用

 3.1打开云之家官网,管理员登录 http://www.yunzhijia.com/home/

3.1.2登陆成功之后选择面板中的管理中心

可看到EID 记录起来发送给实施人员，然后点击轻应用进入应用管理

 

 

3.1.3新建应用

3.1.4填写应用信息

 

（1）红色星号为必填写内容，应用logo按照图中要求，可自行使用ps的工具调整logo大小

（2）应用名称建议填写标识性比较强的字眼

（3）移动端访问地址填写http://ip地址(可参考BI地址ip): 3003/cloud/（奥威nodejs中间层云之家首页地址）

端口：云之家服务对应的端口配置文件serverPort对应值

（4）可见范围根据需求自选即可

保存完成可见如下页面，页面中可见appid与appsecret 两个信息，记录起来发送给实施人员

3.1.5应用添加完成之后验证

3.1.6打开移动端云之家app，选择工作台，拉到最下的企业自建应用即可看到最新添加的应用,

注意要先选择正确的团队归属，可以在app的我的面板中选择切换团队

3.1.7通讯录秘钥获取

页面中可见通讯录密钥，记录起来发送给实施人员

3.2云之家服务与BI系统的配置（由实施人员实现）

必备条件：

（1）首先要确保该文档的1-4章节的条件满足，就是环境准备与服务正常启动（与钉钉用的是同一个服务）

（2）云之家后台配置（客户完成）完成之后需要从客户手中拿到几个必备信息，如下

应用id: APPID（截图标注 2）  应用密钥：APPSecret（截图标注 3）

注册EID（截图标注 1）  通讯录Secret（截图标注 4）

3.2.1云之家基本信息的使用

BI系统》第三方集成管理》基本信息页面 处使用，如下图

admin账号登录才可以集成配置

云之家服务配置文件处用，配置文件位置如下图

注：修改好之后关闭文件再次编辑文件验证是否更改成功

 

3.2.2验证是否有权限获取到用户数据（admin登录）

3.2.3配置的检查，如各项正常可忽略

（1）应用信息配置，参考该文档2云之家相关

（2）数据库配置，参考钉钉集成文档2.1数据库参数

（3）BI地址配置以及钉钉服务端口配置，参考钉钉集成文档3其他参数

 

3.2.4云之家服务是否正确被访问到，可查看实时日志

 

点击访问应用应有实时日志输出，如有报错信息也可以看到

访问应用验证效果