如何实现已停用用户的自动恢复能力

本文介绍「已停用用户自动恢复」能力的适用场景与配置方法，帮助 IDaaS 管理员让因通讯录同步而停用的用户在重新入职或重新纳管时受控恢复为正常状态。

概述

在通讯录集成中，当上游身份源删除用户、且连接器的删除模式设置为「用户停用」时，系统不会物理删除本地用户，而是将其状态置为「停用」。停用可以保留用户数据、阻断登录、保留审计痕迹，但此前停用是不可恢复的终态——员工重新入职或跨源重新纳管时，无法让同一个用户恢复为正常状态。

「已停用用户自动恢复」能力为同步场景新增了一个明确、可审计、可配置的恢复入口：当被停用的用户重新进入有效同步范围、并能通过账号关联命中原用户时，系统可将其从「停用」受控恢复为正常状态。

说明：本能力默认关闭，仅在连接器（或连接流节点）开启后对该连接器同步的用户生效，不改变管理员手动「禁用/启用」的语义。

适用对象

角色	关注点
IDaaS 管理员	配置删除模式与恢复开关，处理离职/重新入职
HR 系统对接人	在上游恢复员工记录、调整筛选与部门归属

概念辨析：停用与禁用

状态	产生方式	含义	是否可恢复
停用	通讯录同步删除模式选择「用户停用」时自动产生	上游已不再承认该账号，阻断其登录与访问，但保留用户主体与历史记录	开启本能力后，满足条件可自动恢复
禁用	管理员在后台手动操作	管理员主动暂停账号	由管理员手动「启用」恢复

重要：本能力只针对「停用」状态，不影响管理员手动「禁用/启用」的行为。

用户为什么会进入停用

当连接器删除模式为「用户停用」时，以下情况会让用户进入停用状态：

场景	是否会进入停用	说明
上游删除用户，或全量同步不再返回该用户	是	用户被判定为已离开同步范围
用户仍在上游，但不再满足连接器筛选条件	是	例如筛选「仅在职员工」，员工转为离职
用户仍在上游，但部门不在同步范围或映射不到本地部门	是	用户被判定为已离开同步范围
删除数量超过连接器的删除阈值	暂不进入停用	触发删除保护，本轮停用被阻断

恢复判定条件

开启自动恢复后，系统按以下原则判定一个停用用户能否恢复：

判定维度	规则
主恢复信号	上游用户重新进入有效同步范围：被连接器返回、通过筛选条件、能构建有效部门关系
账号命中	按连接器的账号关联规则命中同一个本地停用用户；命中多个则记录异常、不自动恢复
状态映射	若连接器配置了状态映射，映射结果须为正常（不能是停用/挂起等）；未配置则以「重新进入有效同步范围」为信号
连接器开关	默认关闭，开启后该连接器才允许恢复停用用户
适用范围	普通通讯录连接器、通讯录集成连接流中的「创建/更新用户」节点均适用

前提条件

已配置通讯录集成连接器，并完成至少一次同步

连接器删除模式为「用户停用」（即停用而非物理删除）

已确认账号关联字段（如工号、手机号、邮箱）稳定可靠，避免误命中

拥有连接器/连接流的编辑权限

操作步骤

步骤 1：进入连接器配置

使用管理员账号登录集成平台，进入 用户中心 → 通讯录集成，打开目标连接器的配置页。

步骤 2：开启「已停用用户自动恢复」

在连接器配置中找到「已停用用户自动恢复」开关，将其打开。

配置项	说明	默认值
已停用用户自动恢复	开启后，连接器同步到的用户若通过账号关联命中已停用用户、且重新进入有效同步范围，系统会将其从停用恢复为正常	关闭

重要：开启前请确认账号关联字段稳定，避免因字段漂移造成误恢复。

步骤 3：（可选）在连接流节点覆盖配置

若通过 AI 连接流编排同步，可在「创建/更新用户」节点上单独配置该开关。节点默认继承连接器配置，也可在节点上覆盖。

步骤 4：保存并等待下次同步

保存配置。下次同步时，满足恢复条件的停用用户将被自动恢复，并继续同步其属性与部门关系。

上游动作与系统结果对照

停用原因	上游需要做什么	系统处理结果
上游删除或全量不再返回	恢复或重新创建同一员工记录，保持账号关联字段可命中原用户	再次读到该用户，命中本地停用用户，满足条件后自动恢复
不符合筛选条件	修改上游字段，使用户重新通过筛选	用户重新进入同步范围，满足条件后自动恢复
部门不在同步范围或映射失败	将用户放入可同步、可映射的部门	形成有效部门关系后允许恢复
跨 HR 源重新入职	新源返回该员工，且开启恢复的连接器能命中原用户	由新连接器恢复原停用用户，并记录恢复来源
仅把上游状态改为在职、但用户仍不在同步范围	——	无效，系统拿不到有效用户记录，无法恢复

典型场景

场景一：同一 HR 源离职后重新入职

场景二：跨 HR 源重新入职

场景三：筛选条件恢复

验证与测试

验证项	验证方法	预期结果
开关生效	开启后触发一次同步	满足条件的停用用户恢复为正常状态
账号命中	检查恢复用户是否为原用户	恢复的是同一本地用户，属性与部门被继续同步
未开启对照	关闭开关再同步	命中的停用用户保持停用，并产生对应同步日志
恢复来源记录	跨源恢复后查看用户/同步日志	记录了恢复来源连接器

注意事项

警告：账号关联字段（工号、手机号、邮箱等）不稳定时，可能将不同的人误命中为同一用户并错误恢复。开启前务必确认关联字段的唯一性与稳定性。

注意：在多连接器场景下，一个连接器的恢复行为可能影响仍被其他连接器关联的本地用户，请结合实际同步关系评估影响范围。

建议：首次启用时，先在测试连接器或小范围数据上验证恢复结果，确认无误后再在生产连接器开启。

常见问题

Q：开启后，所有历史停用用户会立刻恢复吗？

Q：自动恢复会影响管理员手动禁用的账号吗？

Q：只在上游把员工状态改成在职，用户能恢复吗？

Q：连接流节点和连接器的开关冲突时以哪个为准？

关联文档	关系说明
通讯录身份集成概述	上游身份源同步基础
通讯录同步概述	同步策略与删除模式说明
上下游用户关系视图	排查用户停用/恢复与上下游关系

如何实现已停用用户的自动恢复能力

概述#

适用对象#

概念辨析：停用与禁用#

用户为什么会进入停用#

恢复判定条件#

前提条件#

操作步骤#

上游动作与系统结果对照#

典型场景#

验证与测试#

注意事项#

常见问题#

相关文档#

概述