Skip to main content

企业微信授权版部署安装

企业微信授权版部署安装

1. 安装企业微信集成清单

  • 需联系平台支持人员,人工授权获取企业微信集成清单;

  • 本项目引入企业微信清单后,更新到执行系统,进行重启。

  • 企业号的介绍可以查看微信官方文档:https://work.weixin.qq.com/?from=qyh_redirect

2. 企业微信申请服务商

2.1 注册企业号账号

(1)企业微信登陆:https://work.weixin.qq.com/

img

(2)填写相关信息,并根据填写的手机号和管理员的微信验证并激活企业号。

img

2.2 申请服务商

(1)注册成功后点击“进入管理后台”或者在企业微信管理页面登录进入。

img

(2)进入https://qy.weixin.qq.com/app,点击"申请服务商"(如需成为服务商请配置)

img

img

3. 授权版应用配置

3.1 系统配置

设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 系统设置

依次填写相应的域名、WEB服务上下文、白名单IP,并将白名单IP填写至企业微信服务商管理后台 → 服务商信息的白名单IP中。

白名单IP获取方式:在服务所在的服务器百度IP即可得。

img

img

3.2 企业微信服务商管理后台新建普通应用

在企业微信服务商管理后台 → 应用管理 → 网页应用,新建普通应用(区别于简单版是在企业管理后台的应用管理中创建应用

应用类型:普通应用和通讯录应用

注意:通讯录应用只支持使用通讯录功能。

img

img

img

3.3 微信管理

设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 微信管理

(1) 登录授权信息:填写登录受权秘钥和登录授权发起域名

img

注:登录授权密钥获取方式如下图:providesecret即为授权密钥。

img

(2)配置供应商管理:业务编码自定义,corpid需要从企业微信服务商的后台获取

img

(3)应用管理:新建应用

img

img

注意
  • 将企业微信管理页面中的 suitid,Secret,Token,EncodingAESKey复制到配置中心,点击保存。
  • 再将系统生成的指令回调url、数据回调url复制到企业微信管理页面,点击保存。
  • 先要在配置中心中保存,再保存企业微信管理页面。

(4)旧套件管理:已废弃,不需要配置

(5)应用商城:将创建好的应用授权给相应的企业号,并设置应用的可见范围

img

img

img

(6)微信附加属性:只有多租户的服务才需要配置此步骤

img

3.4 业务系统基本设置

设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 业务系统基本设置

其中,授权方企业号ID和秘钥是接收应用授权方的企业号ID和秘钥。

注意:不能勾选远程调用API。

img

3.5 微信企业号授权版的配置

设置路径:配置中心 → 系统高级配置 → 系统维护 → 配置管理

img

3.6 开启企业授权版

注意:如果是多租户的服务,需要开启授权版的js-sdk。

img

3.7 测试

设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信简单版 → 系统设置

微信的企业号应用和本地服务已经联通,可通过发送消息测试。

img

4. 多租户服务

注意:在配置中心上新建应用时,需要手动在oauth验证回调url的最后面加上“VucTenant”(其余的配置和上述一致)。

img

5. 远程调用(需要熟悉统一认证的配置以及原理)

5.1 认证中心(服务端):服务端配置好应用授权给客户端使用

将配置好的应用授权给其他服务使用时,需要将应用的oauth认证url、oauth认证回调url、数据回调url的地址改为业务系统(客户端)的地址。(其余配置和上述一致)

img

5.2 业务系统(客户端)

业务系统分离管理-业务系统基本设置,勾选“是否远程调用api”并填写应用的编码、应用名称、授权方企业号id、授权方企业号秘钥。

注意:授权方企业号id、授权方企业号秘钥为接收应用授权的企业号id和秘钥。

img

配置中心 → 系统高级配置 → 系统维护 → 配置管理中,微信企业号授权版的配置:将是否强制进行远程调用设置为Y。

img

6. 常见配置注意事项

(1)本地服务需要能被外网访问

在微信管理页面填写的url,域名,文件等都需要能被外网访问到。

(2)应用可见范围

注意:该应用要设置可见范围,且该用户要加入该企业号,应用才能被看到。

img