# 企业用户目录同步

URL: https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/what-is-account-integration/enterprise-directory-sync

## 1.概述

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

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

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

## 2.同步数据

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

### 2.1 用户信息

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

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

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

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

### 2.2 企业组织架构信息

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

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

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

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

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

| **用户目录服务** |
| --- |
| [LDAP](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/ldap-ad/ldap-directory/) |
| [AD](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/ldap-ad/ad-directory/) |
| [钉钉](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/dingtalk/) |
| [企业微信](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/wechat-work/) |
| [飞书](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/feishu/) |
| [标准 API](https://docs.ones.cn/on-premises/7.33/product-manual/admin/account-integration/third-party-integration/api-sync/) |

## 4.用户目录同步机制

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

1. 自动定时同步：指系统周期性的自动从「用户目录同步数据源」拉取最新的用户目录数据到系统；
2. 手动同步：指管理员可以通过系统界面上的「同步」按钮，手动触发拉取最新用户目录数据到系统；
3. 变更通知触发同步：指某些服务支持将用户目录变更推送到系统，系统收到通知后拉取更新的用户目录数据；
*注：不同用户目录服务支持的同步机制有所不同，详情请参考各集成说明*