更新时间:2024-01-08
企业微信认证说明
aTrust设备支持与企业微信对接,实现使用企业微信扫码登录aTrust设备,也支持移动端app在企业微信的工作台中,点击发布的Web应用即可访问内网业务系统。
企业微信,根据客户的使用场景不同,需要提供的配置信息也不同,存在差异。
企业微信提供三种使用场景:1、仅在企业微信APP访问应用;2、仅企业微信扫码登录;3、上述两个场景之和。
步骤1. 在控制中心[业务管理/认证管理/认证服务器]中点击<新增>按钮新增企业微信认证。
表27企业微信认证操作说明表
操作 | 说明 |
状态 | 设置企业微信认证服务器是否启用。 |
名称 | 设置认证服务器的名称。 |
描述 | 设置认证服务器的描述,非必填项。 |
使用场景 | 使用企业微信认证的场景 ,分为:1)企业微信APP或扫码登录访问;2)仅在企业微信APP应用访问;3)仅企业微信扫码登录aTrust访问应用。 |
CorpID | 标识企业的唯一标识符,获取路径:企业微信后台管理/我的企业/企业ID。 |
授权应用Secret | 需在企业微信上创建一个影子应用,用于获取认证信息,其获取方式见本节后面的内容。 |
授权应用AgentId | 需在企业微信上创建一个影子应用,用于获取认证信息,其获取方式见本节后面的内容。 |
获取用户信息Secret | 获取企业微信用户的组织架构和用户详细信息,并可根据此字段同步至atrust本地进行管理,做精细化授权,其获取方式见本节后面的内容。 |

:
1、企业微信APP拉起miniconnect APP单点登录的相关接口已于2022年4月份被企业微信停用。
2、企业微信APP集成SDK单点登录(适用于隧道应用)这一场景仅支持粤政易APP集成SDK。
步骤2. 用户源设置,关联用户目录有两个场景,具体配置如下。
场景1、如果用户目录已经提前创建好了,则直接选择关联。

场景2、如果未新建好,可直接点击新增 ,会跳转到用户目录新建页面,用户来源选择外部(支持从企业微信、MS ActiveDirectory/Open LDAP/Sangfor IDTrust LDAP)或自选择定义获取用户(可批量导入本地用户) ,具体配置可在该页面查看右侧帮助教程或参考本文档的“用户管理”章节。

aTrust对接企业微信服务器配置各参数信息获取,请参考如下操作。
一、如何获取cropID
企业微信管理员登录企业微信后台,在[我的企业]处获取CorpID信息。

二、如何获取授权应用Secret和授权应用AgentId
- 企业微信管理员登录在企业微信后台,进入[应用管理/应用/自建]点击<+>创建认证应用。

- 完成认证应用创建,填写应用logo、应用名称、描述和设置可见范围信息,点击创建应用,完成应用创建,并设置用户 可见范围。

- 应用完成创建后,可获取到认证应用的Secret和AgentId信息。

- 在该页面的开发者接口处,设置网页授权及JS-SDK和企业微信授权登录,使得SDPC设备对接企业微信后,能正常在企业 微信授信和访问。
- 设备网页授权及JS-SDK,将零信任客户端接入地址设置为企业微信的可信域名。

- 设置企业微信授权登录,设置企业微信扫码认证授权回调域为客户端接入地址。

三、如何获取用户信息Secret
企业微信管理员登录企业微信后台,在[管理工具/通讯录同步]获取用户信息Secret,点击查看secret可在管理员企业微信 获取信息。


- 用户使用客户端接入地址访问aTrust,切换到二维码,使用企业微信APP可以扫码登录成功,登录用户应用中心。


使用企业微信发布H5应用案例
员工通过企业微信APP或扫码登录访问,在完成对接企业微信后,可发布H5微应用。用户在企业微信内访问H5微应用,可直接点击访问到对应的应用,对员工使用是无感知。
预制条件
- 配置H5微应用,需用使用域名和证书。请客户提前准备好域名和证书,建议使用泛域名和泛域名证书,域名的A记录解析 指向代理网关地址。
- 配置web应用的基本配置,包括后端服务器地址、前端访问地址和证书配置(如是https协议应用),前端访问地址A记录解析指向Proxy地址。
配置指导
一、WEB应用的基本配置
- 管理员登录SDPC控制中心,进入[业务管理/应用管理/应用列表]点击<新增>创建web应用。
- 完成web应用的应用属性、基础配置和开启web水印,点击保存完成配置。


二、企业微信后台配置应用
- 管理员登录企业微信后台,完成新建H5应用配置,进入[应用管理/应用/自建]点击<创建应用>新建应用。

- 完成应用基本配置,包括应用logo、应用名称、应用介绍和可见范围(指定应用的人员访问权限),点击<创建应用>完成配置。

- 进入新建应用的配置详情页,完成应用主页和网页授权及JS-SDK的配置。其中应用主页的网页地址和可信域名须填写在SDPC上的前端访问地址。


三、效果演示
完成配置后,可在移动端和PC端登录企业微信,点击该应用进行访问。
PC端输入客户端接入地址,可显示企业微信扫码登录界面。

PC端企业微信访问应用。

移动端企业微信APP访问应用。
