通过 IAM 数据源可以将钉钉、企业微信、飞书或天书中的组织架构、部门和成员身份数据接入当前组织。
开始前
登录超级麦吉，并进入管理后台。
在右上角切换到需要配置的组织。
确认账号拥有该组织的管理权限。
准备对应第三方平台的管理员账号和应用凭证。
配置过程中不要通过截图、聊天或公开文档发送 AppSecret、CorpSecret、Token 和 AES Key 等敏感凭证。
当前页面只允许启用一个数据源。更换数据源前，请先确认现有组织身份数据的使用情况。
进入数据源页面
在管理后台顶部点击 企业功能。
在左侧导航中展开 IAM 管理。
点击 数据源。
页面会显示钉钉、企业微信、飞书和天书四种数据源卡片。每张卡片会显示当前是否启用以及是否已经配置。
配置第三方数据源
找到当前组织要接入的第三方平台。
点击数据源卡片右下角的 未配置。
在数据源详情页点击 配置 页签。
点击右上角的 配置指引。
系统会打开《Teamshare OS 配置第三方组织同步配置指引》。请按照该文档在第三方平台中准备应用权限、组织同步设置和凭证。
返回超级麦吉，在 配置 页签填写当前平台要求的应用凭证。
不同数据源的主要配置字段如下，实际字段以当前页面为准：
数据源 | 页面要求的主要配置 |
|---|---|
钉钉（DingTalk） | AgentId、AppKey、AppSecret、CorpId |
企业微信（WeCom） | CorpId、CorpSecret、AgentId |
飞书（FeiShu） | AgentId、AppSecret |
天书（Teamshare） | 接口地址、组织编码、AppKey、AppSecret |
以钉钉为例，配置页面会显示应用凭证、激活规则和数据源更新频率。
在 激活规则 中选择 手工激活 或 自动激活。
点击 数据源更新频率。
选择 关闭实时更新 或 实时更新。
按页面提示保存配置。
保存后，数据源凭证和同步策略会保存到当前数据源中，返回数据源列表后，该卡片不再显示为未配置。
按需配置回调接口
如果第三方平台的配置指引要求使用事件回调，请按以下方式配置：
进入目标数据源详情页。
点击 回调接口 页签。
查看页面生成的 回调地址、加密密钥和 TOKEN。
将这些信息填写到第三方平台的回调设置中。
保存第三方平台的回调设置后，请确认回调地址、密钥和 Token 与超级麦吉页面显示的内容一致。
启用组织架构同步
返回 IAM 数据源列表。
检查目标数据源已经完成凭证和同步策略配置。
打开目标数据源卡片左下角的启用开关。
如页面出现确认提示，核对数据源名称。
点击确认。
该截图只用于定位启用开关，截图中的数据源仍显示为 未配置；实际启用前必须先完成数据源配置。
数据源卡片的状态会由 未启用 变为启用状态。由于页面只允许启用一个数据源，其他数据源不能同时保持启用。
查看和维护同步结果
在管理后台顶部点击 企业功能。
在左侧导航中展开 组织架构。
点击 成员与部门。
点击 部门 页签。
查看部门列表中的 来源。
第三方同步的部门会在 来源 中显示对应的平台名称。组织架构的实际更新结果以当前成员与部门页面显示为准。
第三方平台同步的部门不能直接在超级麦吉后台编辑或新增下级部门。需要调整组织结构时，请回到对应的第三方平台修改，等待数据更新后再返回成员与部门页面查看结果。
如果身份数据没有变化，请先检查数据源是否处于启用状态，再核对应用凭证、第三方应用权限和 数据源更新频率。如果使用了回调，还要检查第三方平台中的回调信息是否一致。