iOA 零信任安全管理系统 iOA SaaS 企业微信对接

·身份源：你导入组织架构的企业微信会和使用的 iOA 产品进行绑定，你可以给已导入的企业微信身份源创建多个身份目录进行同步。

·认证源：你创建的企业微信认证源需要和你导入企业微信身份源保持一致。相同企业微信的认证源可以创建多个，不受此影响。

注意：说明：

注意：iOS 端如需使用“企业微信对接”，请联系 iOA 项目技术支持人员，我们需要在后台配置登录参数，可以提供 iOS 端的登录 Demo。

一、1. 实现效果

二、2.1 资源准备

由于企业微信需要通过受信域名才能进行对接，所以需要你提前准备：

注意：说明：

·步骤1：申请一个域名。

·步骤2：域名备案。

·步骤3：申请或上传域名的 SSL 证书。

·步骤4：准备部署连接器的服务器（建议配置：Centos7.6 CPU：2-4核，内存4-8G，硬盘100G 以上）。

三、2.2.1 新建自建应用

1. 登录 企业微信管理后台，单击上方的应用管理，默认进入应用页面。

2. 在应用页面，单击自建 > 创建应用。

3. 在创建应用页面，配置相关参数，单击创建应用。

注意：可见范围务必包含需要同步的组织范围，否则无法同步组织；建议设置为根目录。

四、2.2.2 设置可信域名

1. 登录 企业微信管理后台，单击上方的应用管理，在应用页面，单击刚才创建的自建应用。

2. 在应用详情页面，选择网页授权及 JS-SDK，单击设置可信域名。

3. 在设置可信域名窗口中，单击申请校验域名。

4. 在设置可信域名窗口中，单击下载文件。

5. 可先关闭页面，待 iOA SaaS 控制台配置完成后再输入可信域名，单击确定，完成可信域名校验。

注意：说明：

注意：可信域名由 3.2 认证源配置 后获取，再填写到此处，进行可信域名校验。因此当前先跳过此可信域名填写步骤。

五、2.2.3 设置企业可信 IP

1. 在应用页面，单击刚才创建的自建应用。

2. 在应用详情页面，选择开发者接口，单击企业可信 IP 中的配置。

3. 在企业可信 IP 窗口中，输入 IP 地址，单击确定。

注意：说明：

注意：可信 IP 由 3.2 认证源配置 后获取，再填写到此处。因此当前先跳过此企业可信 IP 填写步骤。

六、2.2.4 设置企业微信授权回调域

1. 在应用页面，单击刚才创建的自建应用。

2. 在应用详情页面，选择开发者接口，选择企业微信授权登录。

3. 单击设置授权回调域，填写 web 网页授权回调域：scs.gateway.tencent.com 。

七、2.3.1 获取企业 ID

1. 登录 企业微信管理后台，单击上方的我的企业，默认进入企业信息页面。

2. 在企业信息页面的最下方，获取企业 ID。

八、2.3.2 获取自建应用 AgentId 和 Secret

1. 登录 企业微信管理后台，单击应用管理，并选中刚才创建好的自建应用。

2. 在应用详情页面，查看 AgentId，单击 Secret 右侧的查看，将 Secret 内容复制并保存。

注意：为确保数据安全，请确认为企业内部使用，切勿将 Secret 泄漏给第三方。

九、2.3.3 获取自建应用 Schema

1. 登录 企业微信管理后台，单击应用管理，并选中刚才创建好的自建应用。

2. 在应用详情页面，进入“企业微信授权登录”，Schema 参数是企微平台自动生成的，直接获取即可，将 Schema 内容复制并保存。

3. 填写企业微信授权登录信息。

·Web 网页：设置授权回调域 scs.gateway.tencent.com。

·iOS：设置 Bundle IDcom.tencent.ioa.saas。

·Android：设置应用签名9e4e6594cd64562c6ae8e3ae0288dd5a ， 应用包名com.tencent.ioa.saas。

十、3.1 连接器部署

1. 登录 iOA 零信任管理平台控制台，在左侧导航栏，选择无边界办公 > 资源网络连通 > 非腾讯云业务。

2. 在非腾讯云业务页面，单击，新建专线分组。

3. 编辑专线组名称：示例：企业微信对接，选择专线组，单击下一步。

4. 按提示完成连接器部署。详细步骤可参考连接器部署。

注意：说明：

注意：部署完成后该专线分组下不建议再添加专线，如需添加，应将新加连接器出口 IP 添加至企业微信自建应用的可信 IP 处。

十一、3.2 认证源配置

1. 登录 iOA 零信任管理平台控制台，在左侧导航栏，单击身份安全管控 > 认证源配置。

2. 在认证源配置页面，单击新增认证源实例。

注意：说明：

注意：iOA 高级版、远程接入专业版支持配置自定义域名。

注意：iOA 基础版、终端安全专业版无自定义域名，需用户自行准备做过可信域名校验的域名。

新增自定义域名填写说明：

注意：说明：

注意：特别说明：新增自定义域名后会在所选择的资源分组下自动生成两个 web 资源，该资源禁止修改，建议新建一个资源分组存放。

3. 将下方生成的信息保留，并单击保存。

·将自定义域名修改 CNAME 解析指向‘自定义域名指向’的域名。

·待解析生效后，返回2.2 配置企业微信自建应用，将‘授权回调域’、‘可信域名’、‘可信 IP’填写到企微自建应用处。

4. 登录 企业微信管理后台。

·授权回调域填写至：2.2.4 设置企业微信授权回调域。

·可信域名填写至：2.2.2 设置可信域名。

·可信 IP 填写至：2.2.3 设置企业可信 IP。

十二、3.3 身份源配置

1. 登录 iOA 零信任管理平台控制台，在左侧导航栏，单击组织架构管理。

2. 在组织架构管理页面，单击新增组织架构。

3. 在导入组织架构页面，选择企业微信，单击下一步。

4. 在组织架构配置页面，配置相关参数。

注意：请确认已经准备好了企业自建应用，连接器已部署完毕，具体操作：

注意：① 对于 Bool 类型和 String 类型，相同的值会关联到状态 1，不相同的统一到 0；

注意：② 对于 Int 类型，相同的值会关联到状态 1，其他值会默认保留。

5. 配置完成后单击下一步并保存。

6. 在组织架构管理页面，找到刚才创建的目录，单击目录管理，查看组织架构信息。

十三、3.4 认证策略配置

注意：说明：

1. 在身份安全管控 > 认证策略页面，选择目标目录，单击编辑。

2. 在编辑认证策略页面，PC 端将刚才添加的企业微信认证源作为主认证方式。

3. 单击添加，完成编辑。