企业微信集成(老包:企业微信-带自动域名)

有数提供了微信小程序集成企业微信的能力,目前仅私有部署版本支持微信小程序集成功能。通过企业微信后台的配置可以实现有数与企业微信用户的打通,实现免密登录,登录后可在企业微信上轻松查看有数报告,且能收到度量预警的消息通知。
通过在微信开发者后台和有数后台的配置,即可实现企业微信集成功能,具体操作步骤如下:

企业微信集成(老款:企业微信-带自动域名) - 图1

1.准备外网可访问的https域名

小程序在配置服务器域名时,微信仅支持https域名,而微信接入又必须要外网可以访问,所以接入前必备的条件为
①域名为https安全域名,需要证书
②https域名可以在外网访问,端口可开443端口或80端口
③域名指向BI服务器,使用该域名可直接访问有数
注:鉴于私有化部署BI工具的数据安全性,对于外网访问有数在此基础上提供额外的安全策略
①最小可用原则,仅开放443端口
②进微信小程序服务器可访问该域名,具体操作为nginx配置为仅限指定user_agent访问,小程序的user_agent为mini program

企业微信集成(老款:企业微信-带自动域名) - 图2
③关闭微信小程序搜索登入入口,无法通过搜索小程序登入BI
以上可实现,该域名仅有企业微信这一个入口可以访问,风险最小化

2.注册微信公众平台小程序

企业需要在微信公众平台注册账号,按照微信官方的小程序接入流程进行小程序的上架:

企业微信集成(老款:企业微信-带自动域名) - 图3
注册链接:https://mp.weixin.qq.com/wxopen/waregister?action=step1

  • 填写账号信息

企业微信集成(老款:企业微信-带自动域名) - 图4

  • 邮箱激活

企业微信集成(老款:企业微信-带自动域名) - 图5

  • 信息登记

选择企业为主体类型(个人认证无法配置业务域名这里必须选择企业)

企业微信集成(老款:企业微信-带自动域名) - 图6
登记主体信息,需要营业执照注册号及注册认证,认证方式有两种
①对公账号向腾讯公司小额打款验证(推荐)

  • 小额打款金额一般为0.1元-1元不等
  • 款项会在认证结束后退回

②微信认证(需300元额外费用)

企业微信集成(老款:企业微信-带自动域名) - 图7

3.配置小程序信息

企业微信集成(老款:企业微信-带自动域名) - 图8
内容包括小程序名称,小程序简称,小程序头像,小程序介绍,及服务类目(服务类目选择工具-计算类)

企业微信集成(老款:企业微信-带自动域名) - 图9
注:小程序名称修改,仅能通过微信认证方式,需要300元费用,修改入口为 设置-基本设置
小程序简称、小程序头像、介绍和服务类目可以免费修改

企业微信集成(老款:企业微信-带自动域名) - 图10

4.上传小程序代码

下载并安装微信开发工具:

https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html

扫码登录,导入项目

企业微信集成(老款:企业微信-带自动域名) - 图11

企业微信集成(老款:企业微信-带自动域名) - 图12

解压代码包,将代码包中的project.config.json文件中的APPID替换为当前小程序的APPID(代码包请联系有数技术支持获取对应版本包)

企业微信集成(老款:企业微信-带自动域名) - 图13

企业微信集成(老款:企业微信-带自动域名) - 图14

企业微信集成(老款:企业微信-带自动域名) - 图15

导入项目,目录设置为解压后的代码包文件夹

企业微信集成(老款:企业微信-带自动域名) - 图16

修改app.js文件里面的ENV DOMAIN:修改用户自己的bi域名

企业微信集成(老款:企业微信-带自动域名) - 图17

点击上传

企业微信集成(老款:企业微信-带自动域名) - 图18

填写版本号及项目备注

企业微信集成(老款:企业微信-带自动域名) - 图19

返回小程序页面,在管理-版本管理中设置该版本为体验版

企业微信集成(老款:企业微信-带自动域名) - 图20

生成体验版二维码备用

企业微信集成(老款:企业微信-带自动域名) - 图21

5.配置域名

  • 服务器信息

开发-配置服务器域名 中配置

企业微信集成(老款:企业微信-带自动域名) - 图22

注:
request域名:表示微信可接受的接口请求域名,需填写当前私有部署有数https域名(例如:https://youdata.163.com);
socket合法域名:表示微信可接受的socket通讯域名,需填写和当前私有部署有数域名相同的wss前缀域名(例如:wss://youdata.163.com);
downloadFile合法域名:表示微信可接受的下载域名,一般不需要填写,如果在有数中有使用到自己的cdn,则需要填写改cdn域名。

  • 业务域名

填写当前有数域名,(例如:https://youdata.163.com)
注:需下载校验文件,放到有数服务器 /youdata/custom/static目录下

注:如果有问题的话可以在浏览器上使用通外网的域名/校验文件名字看一下是否返回的是正确的 实例:https://youdata.163.com/7ITsAf22Qw.txt

6.提交审核和发布

  • 准备一个测试账号,需交由微信审核人员审核,该账号权限最小化(建议仅可查看一个测试报告),配置1个最简单的报告,一个表格或图表即可。
  • 手机扫码登入体验版,截图并录制视频,图片内容建议为(域名登入页,账号登入页,登入后有数界面,报告页),录制视频的内容为从填入域名开始到报告页结束,图片示例如下:

企业微信集成(老款:企业微信-带自动域名) - 图23

企业微信集成(老款:企业微信-带自动域名) - 图24

企业微信集成(老款:企业微信-带自动域名) - 图25

企业微信集成(老款:企业微信-带自动域名) - 图26

  • 管理-版本管理-提交审核

企业微信集成(老款:企业微信-带自动域名) - 图27

  • 填写对应信息,选择加急审核,一般2小时内会有结果

企业微信集成(老款:企业微信-带自动域名) - 图28

7.在企业微信后台关联小程序

  • 小程序成功上架后,在企业微信后台关联已上架的小程序,路径:应用管理-小程序;点击【关联小程序】,由小程序后台的管理员扫码即可成功关联小程序:

企业微信集成(老款:企业微信-带自动域名) - 图29

8.在企业微信点击小程序进入登陆BI的时候报错

  • 如果企业微信进入小程序的时候报如下错误的时候

企业微信集成(老款:企业微信-带自动域名) - 图30

  • 需要进入企业微信后台查看一下是否在企业微信的后台对该小程序进行可信域名的认证,点击申请校验域名的时候会生成校验文件,将对应的校验文件放入bi服务器里面 路径为:/youdata/custom/static配置完成之后将下方的企业可信ip也配置一下即可 (一般来说可信IP是服务器的IP)

企业微信集成(老款:企业微信-带自动域名) - 图31

9.有数后台配置

  • 创建完成后,点击小程序,可以自行设置小程序的可见范围,这里需要特别注意一个参数:小程序的Secret,该参数后续将填写至有数后台。

企业微信集成(老款:企业微信-带自动域名) - 图32

  • 点击我的企业,可见“企业ID”参数,这也是后续需要填写到有数后台的参数:

企业微信集成(老款:企业微信-带自动域名) - 图33

  • 第三个参数,需要在小程序的管理后台获取,点击开发-开发设置,查看AppID(小程序ID):

企业微信集成(老款:企业微信-带自动域名) - 图34

  • 在有数的管理后台的设置页面,可以对企业微信集成的开启进行控制,若要在企业微信中启用有数小程序,首先在[企业微信集成设置]下打开集成开关,其次填写上文所说的三个参数:企业微信后台提供的企业ID、Secret,以及小程序管理后台提供的AppID。

企业微信集成(老款:企业微信-带自动域名) - 图35

附录:有数用户与企业微信账号的匹配

有数用户在企业微信上首次登录小程序后,在企业域管理-人员信息页面的人员列表可以看到已匹配用户的基本信息,且该用户下次即可在企业微信免密登录有数小程序。

企业微信集成(老款:企业微信-带自动域名) - 图36

对于部分用户,管理员可手动[设置企业微信匹配],通过企业微信用户的手机号或者姓名与有数用户进行匹配,匹配完成后的用户可以直接在企业微信免密登录有数小程序(用户在小程序里面登出账号之后需要从新进行匹配)。

企业微信集成(老款:企业微信-带自动域名) - 图37

企业微信集成(老款:企业微信-带自动域名) - 图38

注:
匹配需要有数服务器获取企业微信的通讯录信息,该任务为每天凌晨两点的定时同步任务,所以一般做匹配建议放在配置完成后第二天

也可以手动调取接口api/dash/weChat/update进行同步

示例:https://study.sf.163.com/documents/read/privatization/qywx1