企业微信授权版部署安装
企业微信授权版部署安装
1. 安装企业微信集成清单
需联系平台支持人员,人工授权获取企业微信集成清单;
本项目引入企业微信清单后,更新到执行系统,进行重启。
企业号的介绍可以查看微信官方文档:https://work.weixin.qq.com/?from=qyh_redirect
2. 企业微信申请服务商
(1)企业微信登陆:https://work.weixin.qq.com/
(2)填写相关信息,并根据填写的手机号和管理员的微信验证并激活企业号。
(1)注册成功后点击“进入管理后台”或者在企业微信管理页面登录进入。
(2)进入https://qy.weixin.qq.com/app,点击"申请服务商"(如需成为服务商请配置)
3. 授权版应用配置
设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 系统设置
依次填写相应的域名、WEB服务上下文、白名单IP,并将白名单IP填写至企业微信服务商管理后台 → 服务商信息的白名单IP中。
白名单IP获取方式:在服务所在的服务器百度IP即可得。
在企业微信服务商管理后台 → 应用管理 → 网页应用,新建普通应用(区别于简单版是在企业管理后台的应用管理中创建应用)
应用类型:普通应用和通讯录应用
注意:通讯录应用只支持使用通讯录功能。
设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 微信管理
(1) 登录授权信息:填写登录受权秘钥和登录授权发起域名
注:登录授权密钥获取方式如下图:providesecret即为授权密钥。
(2)配置供应商管理:业务编码自定义,corpid需要从企业微信服务商的后台获取
(3)应用管理:新建应用
注意
- 将企业微信管理页面中的 suitid,Secret,Token,EncodingAESKey复制到配置中心,点击保存。
- 再将系统生成的指令回调url、数据回调url复制到企业微信管理页面,点击保存。
- 先要在配置中心中保存,再保存企业微信管理页面。
(4)旧套件管理:已废弃,不需要配置
(5)应用商城:将创建好的应用授权给相应的企业号,并设置应用的可见范围
(6)微信附加属性:只有多租户的服务才需要配置此步骤
设置路径:配置中心 → 业务系统初始化配置 → 集成服务 → 企业微信 → 企业微信授权版 → 业务系统基本设置
其中,授权方企业号ID和秘钥是接收应用授权方的企业号ID和秘钥。
注意:不能勾选远程调用API。
4. 多租户服务
注意:在配置中心上新建应用时,需要手动在oauth验证回调url的最后面加上“VucTenant
”(其余的配置和上述一致)。
5. 远程调用(需要熟悉统一认证的配置以及原理)
将配置好的应用授权给其他服务使用时,需要将应用的oauth认证url、oauth认证回调url、数据回调url的地址改为业务系统(客户端)的地址。(其余配置和上述一致)
业务系统分离管理-业务系统基本设置,勾选“是否远程调用api”并填写应用的编码、应用名称、授权方企业号id、授权方企业号秘钥。
注意:授权方企业号id、授权方企业号秘钥为接收应用授权的企业号id和秘钥。
配置中心 → 系统高级配置 → 系统维护 → 配置管理中,微信企业号授权版的配置:将是否强制进行远程调用设置为Y。
6. 常见配置注意事项
(1)本地服务需要能被外网访问
在微信管理页面填写的url,域名,文件等都需要能被外网访问到。
(2)应用可见范围
注意:该应用要设置可见范围,且该用户要加入该企业号,应用才能被看到。