# 企业用户目录同步

URL: https://docs.ones.cn/admin/account-integration/what-is-account-integration/enterprise-directory-sync

# 1.概述

如果你的团队正在使用身份管理服务、企业级IM工具或者OA系统管理团队用户目录，你可以将用户目录同步到系统以便统一管理、降低成本。将用户目录同步到ONES可以有以下好处：

- 快速将需要使用系统的团队成员加入到系统中，帮助团队成员更快的启用系统；
- 统一管理团队的组织架构与用户信息，保持系统间用户信息一致；
- 统一管理账号生命周期，降低管理员维护多个系统的成本；
基于用户目录同步下的账号生命周期管理：

![企业用户目录同步 配图 1](https://docs.ones.cn/assets/images/d804050c8b2ad2d2-fd8d1a654a039874af28fb061a8223e2.png)

# 2.同步数据

用户目录同步数据主要包含两种数据：用户信息、企业组织架构信息；

## 2.1用户信息

用户信息通过「同步成员属性」建立映射关系，建立映射关系的属性将保持与同步数据源一致，且在系统内不可手动编辑。

![企业用户目录同步 配图 2](https://docs.ones.cn/assets/images/a8bd46a2c78ad786-7818d077bd9ae6f534c37874bbf08fc7.png)

目前可供建立映射关系的系统用户属性包括：

| 属性名 | 数据格式 | 长度限制 |
| --- | --- | --- |
| 用户名 | 字符串 | 64 |
| 公司名称 | 字符串 | 128 |
| 职位 | 字符串 | 16 |
| 工号 | 字符串 | 128 |

## 2.2企业组织架构信息

系统将从企业用户目录服务获取组织架构部门信息，最后在系统团队组织架构中以树状结构展示。

![企业用户目录同步 配图 3](https://docs.ones.cn/assets/images/dbdfe8248309ff84-e9491e2ac0e4d6ec1ec8bf3e8d2ef3bc.png)

# 3.系统支持的企业用户目录服务

系统支持以下服务作为「用户目录同步数据源」：

> 注意：系统仅支持从单个数据源同步用户目录

| 用户目录服务 |
| --- |
| LDAP（私有部署版本） |
| AD（私有部署版本） |
| 钉钉（私有部署版本） |
| 标准API（私有部署版本） |

# 4.用户目录同步机制

系统支持以下3种机制同步用户目录：

- 自动定时同步：指系统周期性的自动从「用户目录同步数据源」拉取最新的用户目录数据到系统；
- 手动同步：指管理员可以通过系统界面上的「同步」按钮，手动触发拉取最新用户目录数据到系统；
- 变更通知触发同步：指某些服务支持将用户目录变更推送到系统，系统收到通知后拉取更新的用户目录数据；

> 注：不同用户目录服务支持的同步机制有所不同，详情请参考各集成说明

# 5.常见问题

[1.如果系统中已经邀请了一部分用户正在使用，再使用企业用户目录同步会怎样？](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/SR7kTUiA/page/5nGDvNmV)[2.企业用户目录同步如何与单点登录一起工作？[示例：如何配置多个集成的组合使用？以AD和CAS为例]](https://docs.ones.cn/wiki/#/team/6mRWUuNv/space/SR7kTUiA/page/Tz6FKDGz)