配置企业微信数据源

如果您已经在使用企业微信作为您的办公IM软件，您可以通过配置企业微信作为数据源，将您的组织架构快速导入到One ID中，同时进行后续的同步。

本文档将指导您如何配置企业微信数据源，完成配置之后，通过自动同步或手动同步您可以将企业微信组织架构数据同步至One ID目录中。在此之前，您需要拥有企业微信管理平台的权限。

第一步：企业微信侧应用创建及配置

1. 创建应用

若已有稳定可用的已发布应用，此处也可不新建，直接点击需选用的应用进入详情页进行操作即可，为确保应用稳定可用，此处建议新建应用（以下操作需要登录企业微信管理平台，请先确保已经注册企业微信管理员账号，企业微信管理员账号注册流程请参见企业微信官网，此处不再赘述）。

登录企业微信管理平台。（若链接无法直达，可如下图操作，通过进入企业微信官网，点击右上角「企业登录」进入后台管理登录界面）
登录成功后，点击「应用管理」按钮，进入应用管理页面。
在应用管理页面最下方找到【自建】区域，点击「创建应用」按钮，进入【创建应用】页面。
进入【创建应用】页面，在创建应用页面填写「应用Logo」「应用名称」「应用描述」并选择「可见范围」。（提示：「可见范围」决定当前应用获取企业微信数据的范围，请根据业务需要进行数据范围选择，后期根据业务变化也可以再次修改，具体可参考步骤3:范围及权限管理）
创建成功后，进入应用详情页面并提示「应用创建成功，可继续配置应用属性」，此时我们所需应用已经创建成功。

2. 查询企业微信凭证信息

企业微信凭证信息主要包含：企业ID、Agentid、Secret三个信息，主要用于后面One ID侧企业微信数据源配置使用。

在【企业微信管理后台-应用管理-自建】区域找到上一步骤新创建应用，点击应用，进入应用详情页面。查看Agentid和Secret。（注意：Secret需要点击「查看」后，使用管理员账号在移动端企业微信App中进行确认，确认通过后，会将Secret放发送到企业微信App上）

进入【企业微信管理后台-我的企业】页面，在我的企业页面查看「企业ID」信息。

3. 配置可信域名及可信IP

因企业微信开发管理规则要求，自建应用如想获取企业微信内数据，需提前配置可信域名及可信IP，以下步骤描述如何进行可信域名及可信IP配置。（注意：可信域名及可信IP配置是数据源配置的必须步骤，省略此步骤会造成接口调用失败，进而无法获取企业微信数据，配置此步骤需提前拥有企业可信域名并提前查询One ID所部署服务对外访问时IP地址信息）。

在【企业微信管理后台-应用管理-自建】区域找到上一步骤新创建应用，点击应用，进入应用详情页面。在应用详情页面下方，找到开发者接口区域，点击「设置可信域名」，进入可信域名配置页面。

在「可信域名」处填写公司官网可信的域名信息，点击「确定」。（注意：填写时，企业微信方会校验域名的真实性以及所有权，如校验不通过请参考本文末FAQ进行辅助排查）

域名配置成功后，返回应用详情页面，在应用详情页面下方，找到开发者接口区域-企业可信IP，点击「配置」，进入可信IP配置页面。

在「企业可信IP」地址框中，配置One ID部署机器对外访问的IP地址。（注意：如果是集群配置可配置多个，中间用英文；隔开）

4. 范围及权限管理

企业微信创建应用时会对应用所能访问的数据（包括：用户数据和组织机构数据）进行权限控制，此步骤描述如何进行访问权限配置。

在应用详情页找到「可见范围」，显示的是当前应用可以访问数据的范围，点击「编辑」进入权限编辑页面。

进入权限编辑页面，可对当前权限进行删除、添加等操作，点击「添加」按钮，进入添加页面。

添加权限方式有「根据部门」「根据成员」「根据标签」三种，三种方式可以同时使用，也可以只使用其中一种或两种，具体可根据业务需要进行选择，选择完成点击「确认」。

回到权限编辑页面，点击「完成」，完成权限变更操作。

第二步：One ID侧数据源配置

1. 数据源选择&应用凭证绑定

登录One ID管理后台，在通讯录模块下点击「数据源」，进入页面后，选择企业微信数据源。

手动填写企微凭证信息

进入企微应用凭证配置页面，填写相关配置信息。在配置项中依次填写选择agent、「AgentId」、「Secret」和「企业ID」。

请注意：因大多数企微服务器拒绝非客户真实域名的第三方服务直接进行链接，所以需要通过agent进行代理链接，具体可参考：Agent配置。配置agent成功后，通过选择运行中agent完成对企微的通信连接。

一键获取凭证信息

当认证源已经完成企微认证源配置，并且企微数据源和企微认证源使用的是同一台企微服务器时，系统会自动获取您在认证源配置的企微信息，你可以点击选择企微认证源选项，自动拉取企微配置信息。

数据源功能详情配置需注意，此处One ID暂不支持设置部门或人员范围，若同步过程有指定范围的要求，可在第一步创建企业微信应用时在「可见范围」中进行数据权限设置，详情可查看【第一步：企业微信侧应用创建及配置-第四节：范围及权限管理】。

字段映射配置

有关字段映射的更多问题可查看字段映射说明文档 1）部门映射字段对应关系固定，不可修改； 2）人员字段对应关系中，用户id、用户登录名、用户姓名字段对应关系固定，不可修改。其他字段可自行添加对应关系。（注意：受企业微信个人隐私保护规则影响，企业微信部分数据不可直接获取，即：配置映射关系，也获取不到对应数据信息，具体可获取字段明细请参考字段映射说明文档第二章节：企业微信获取数据说明）

配置定时同步

定时器可以让同步任务定时触发，以保企微中的组织架构的变更能周期性地同步到腾讯统一身份中，对该配置项的具体说明可以参考文档同步方式。定时器可以设置触发时间和触发间隔。

删除保护配置此处为了防止您误删除操作，我们设置了删除保护条件，系统执行同步任务之前将识别本次操作是否会触发保护条件，若满足保护条件，则本次同步任务将不会进行，我们会给您留下的联系方式发送通知，删除保护条件可支持修改（为了避免误删除操作带来的影响，若非频繁触发导致日常同步难以进行，不建议修改保护条件）。注意：触发删除保护时，仅会自动停止您的删除操作请求，如果同一次同步中同时发起了新建、修改请求，新增、修改等请求会继续执行，不会受到影响。

8. 保存页面配置点击「保存配置」按钮，对页面全局改动进行保存，即完成了整体企业微信数据源配置流程。