身份同步
作为应用开发者，你的核心需求是：当企业员工的组织或用户信息发生变更时，及时、准确地将这些数据同步到你的应用系统中。
竹云 IDaaS 提供了两种身份同步机制，覆盖不同场景下的数据同步需求。本文档帮助你快速理解「同步什么」「何时同步」「怎么同步」，并选择最适合你应用的接入方式。
快速选择
| 你的情况 | 推荐方式 |
|---|---|
| 自研业务系统，需要实时感知员工变动 | 事件回调 |
| 应用已支持 SCIM 2.0 标准 | SCIM 协议 |
| 应用已在 IDaaS 预集成应用列表中 | 使用应用连接器，无需开发 |
同步什么
身份同步的核心数据包括三类：
| 数据类型 | 说明 | 典型场景 |
|---|---|---|
| 组织信息 | 部门、团队、分支机构等组织架构 | 员工调岗、部门合并、新设部门 |
| 用户信息 | 姓名、工号、手机号、邮箱、职级等 | 新员工入职、员工离职、个人信息变更 |
| 权限信息 | 应用账号、角色 | 授权应用访问 |
何时同步
身份同步由员工生命周期的各类事件触发：
| 事件类型 | 说明 |
|---|---|
| 新增 | 新员工入职，创建用户和组织节点 |
| 修改 | 调岗、个人信息变更 |
| 删除 | 员工离职，禁用或删除用户 |
当上述事件在 IDaaS 平台发生时，你的应用系统需要在第一时间感知并同步数据，确保用户能够正常访问、权限准确生效。
怎么同步
竹云 IDaaS 提供两种同步方式，满足不同技术架构的应用系统：
方式一：事件回调（推荐）
事件回调是 IDaaS 主动将变更事件推送给你的应用系统。
- 机制：IDaaS 在检测到身份数据变更后，立即通过 HTTPS 请求将事件数据推送到你预先配置的回调地址
- 实时性：准实时推送，变更发生后秒级到达
- 适用场景：自研业务系统、需要即时感知身份变更的应用
- 开发成本：低，只需开发一个接收接口并进行验签解密
方式二：SCIM 协议
SCIM（System for Cross-domain Identity Management）是业界标准的身份同步协议。
- 机制：你的应用系统通过标准 SCIM API 主动查询或接收 IDaaS 中的身份数据
- 实时性：取决于轮询频率或配合事件回调触发查询
- 适用场景：支持 SCIM 标准的商业应用、多租户 SaaS 产品
- 开发成本：中，需实现 SCIM 标准接口
快速接入
事件回调（3 步）
SCIM 协议（3 步）
- 了解 SCIM 协议 — 掌握核心概念和端点规范
- 实现 SCIM 服务端 — 按标准实现 Users / Groups 资源的 CRUD 接口
- 联调验证 — 测试数据同步的正确性
错误处理
无论选择哪种同步方式，都需要关注异常场景的处理：
- 事件回调错误码 — 推送失败、验签失败、数据格式错误等
- 网络超时重试 — 回调地址不可达时的重试策略
- 数据冲突处理 — 下游系统已存在同名用户时的合并策略
建议：首次接入优先选择事件回调，实现简单、实时性强。当你的应用规模扩大或需要对接多租户环境时，再考虑引入 SCIM 协议作为补充。