企业微信
功能及平台机制说明
提供与企业微信第三方平台配置参数功能 从38版本开始,第三方平台参数配置都在门户的统一通用配置中设置参数,包括企业微信、钉钉、短信、邮件、双重认证、水印、门户配置等
具体操作
- 在官网进行企业微信注册,具体可参考官网注册说明。
- 进入企业微信管理后台,打开【我的企业】页面,企业ID即企业微信CorpId
- 打开应用管理页面的自建应用中,点击+创建应用
- 创建完成后,即可企业微信AgentId、企业微信应用Secret
.png)
- 在门户应用中的系统配置下,打开统一通用配置功能。
- 在统一通用配置页面点击添加按钮,打开要配置项页面
- 点击放大镜按钮,选择要配置的参数项确定
- 添加完成后,返回到统一通用配置项页面列表中,在操作中选择编辑按钮
- 打开参数设置页面,在配置项中进行参数设置
配置项参数说明如下:
- CorpId:填写企业微信ID,必填
- 授权服务URL:私有部署企业微信环境下的url地址,具体URL地址参考私有部署的环境,私有部署情况下必填
- AgentId:填写创建企业微信应用的AgentId,必填
- 应用Secre:填写创建企业微信应用的Secret,必填
- 通讯录回调Secret:填写企业微信通讯录回调Secret,目前可不填
- 通讯录回调Token:填写企业微信通讯录回调Token,目前可不填
- 通讯录Secret:填写企业微信通讯录Secret,必填
- 用户自动映射:新增特性,针对组织和企业微信组织各自独立不需要同步组织情况下,设置为用户ID自动映射后,只要门户的组织账号和企业微信组织的ID一致,即可完成自动映射(注:原需要企业微信和门户组织账号是通过企业集成应用中的映射表进行映射)
- 禁用用户同步:针对门户组织自动往企业微信同步时使用;1、设置为禁用时,组织禁用状态同时会同步到企业微信;2、设置为删除时,门户里禁用状态的组织,对应企业微信组织会被直接删除(此选项前提必须是全量同步过一次,禁用/删除才会生效)
- 是否同步别名:针对门户组织自动往企业微信同步时使用,从平台组织里同步到企业微信时有别名,导致在通讯录里看到xxx(xxx),不想看到别名时,此选项设置为否。
- 是否同步不存在禁用用户:针对门户组织自动往企业微信同步且在企业微信里组织不存在时使用,选项设置为否时,门户组织里禁用状态组织则不再同步到企业微信中
- 是否忽略用户同步错误:针对门户组织自动往企业微信同步时使用,当用户手机号不全时,组织同步日志中会提示错误提示,如想忽略则设置此属性为是;
仅同步选中部门及子部门:针对门户组织自动往企业微信同步且只同步某个节点下组织情况下使用,属性值填写组织编码路径,多个组织使用逗号分隔
- 打开组织管理,选中要同步的组织或者子组织,勾选显示组织全路径编码
- 打开组织管理,选中要同步的组织或者子组织,勾选显示组织全路径编码
人员扩展字段映射:针对企业微信通讯录管理中自定义字段值与门户组织扩展字段映射配置属性
- 如上图中配置映射规则为:企业微信自定义字段:门户users表中字段,多个字段映射使用用逗号分隔
- 如上必填项参数配置完成后,在第三个平台配置菜单中的企业微信配置里会自动生成一个企业微信工作台URL地址,这个地址需要复制到企业微信后台自建应用的应用主页中,用于后续从企业微信中打开自建应用打开企业门户主页
- 进入企业微信后台,打开自建应用,在功能区,选择工作台应用主页,设置应用主页(使用步骤11中获取的工作台URL地址)
在开发者接口区,对网页授权及JS-SDK、企业微信授权登录设置业务域名(注:只需配置域名,由于企业微信调整,目前新建应用设置可信域名都需要进行域名归属校验)。
- 在平台中进行域名归属校验步骤如下:
- 下载校验文件(微信公众平台配置业务域名里获取校验文件)
- 登录微信后台配置业务域名里下载校验文件
- 定制打开企业门户ide,创建服务和请求(命名仅供参考,可以自己定义)
- 画代码中定义返回字符串(返回串就是下载的校验文件内容)
- 切换到代码页签,添加转调的配置文件,在main下创建文件夹及文件名为app.m文件,参考如下
- 登录微信后台配置业务域名里下载校验文件
- 下载校验文件(微信公众平台配置业务域名里获取校验文件)
- 正式发布部署企业门户应用
- 发布完成后,在浏览器地址栏访问域名根目录下TXT校验文件,返回校验内容即可
附:app.m内容如下
<?xml version="1.0" encoding="UTF-8" ?> <service target="kong2"> <name>myredirect</name> <request_path>/BFhLI8eSCp.txt</request_path> <preserve_host>false</preserve_host> <strip_request_path>true</strip_request_path> <upstream_url>http://entry.newdao-tenant-g31/main/test/test</upstream_url> </service>
- 在平台中进行域名归属校验步骤如下:
- 由于企业微信接口调整 ,新建自建应用,在企业微信后台开发者接口中,企业微信可信ip属性必须设置,