ad.example.com，
ldap.company.local
cn=users，
dc=ad，
dc=example，
dc=com，
dc=ldap，
dc=company，
dc=org
选中此框将提示您选择以下选项之一：
Use SSL (LDAPS) - 如果您的 LDAPS 服务器使用不受信任的证书，则可以在此屏幕上配置证书选项。
Use TLS (STARTTLS) - 如果您的 LDAP 服务器使用 STARTTLS 的自签名证书，则可以在此屏幕上配置证书选项。
| | | Username | 应用程序在连接到目录服务器时，使用的管理用户的专有名称。对于 **Active Directory**，用户应该是内置管理员群组的成员。 | | | Password | 上面指定的用户的密码。此密码安全地存储在操作系统的本机凭据管理器中。 | | ## 配置同步选项 {% hint style="success" %} 完成配置后，请导航至 **More** 标签页，然后选择 **Clear Sync Cache** 按钮，以防止与先前的同步操作发生潜在冲突。有关更多信息，请参阅[清除同步缓存](https://help.ppgg.in/docs/admin-console/manage-members/directory-connector/clear-sync-cache)。 {% endhint %} 完成以下步骤，以配置当使用目录连接器同步时的设置： {% hint style="info" %} 如果您使用的是 Active Directory，则其中许多设置是为您预先确定的，因此不会显示。 {% endhint %} 1. 打开目录连接器[桌面 App](https://help.ppgg.in/docs/admin-console/manage-members/directory-connector/directory-connector-desktop-app)。 2. 导航到 **Setting** 标签页。 3. 在 **Sync** 部分，根据需要配置如下选项： | 选项 | 描述 | | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Interval | 自动同步检查的时间间隔（分钟为单位）。 | | Remove disabled users during sync（**不适用于 LDAP**） | 选中此框以从 Bitwarden 组织中删除已在您的组织中禁用的用户。 | | Overwrite existing organization users based on current sync settings |选中此框以始终执行完全同步，如果任何用户不在同步用户集中，则将其从 Bitwarden 组织中移除。
如果在启用此选项时出于任何原因运行了空同步，则目录连接器将移除所有用户。启用此选项以始终在同步之前运行测试同步。
| | More than 2000 users or groups are expected to sync | 如果预计同步 2000 个以上用户或群组，请选中此框。如果不勾选此框，目录连接器会将同步限制在 2000 个用户或群组。 | | Member Attribute | 目录用此属性名称来定义群组的成员资格（例如 `uniqueMember`） | | Creation Date Attribute | 目录用此属性名称来指定条目创建的时间（例如 `whenCreated`） | | Revision Date Attribute | 目录用此属性名称来指定条目上次的修改时间（例如 `whenChanged`） | | If a user has no email address, combine a username prefix with a suffix value to form an email |选中此框可为没有电子邮箱地址的用户生成有效的电子邮箱选项。没有真实或没有生成电子邮箱地址的用户将被目录连接器跳过。
生成的电子邮箱 = Email Prefix Attribute + Email Suffix
| | Email Prefix Attribute | 用于生成电子邮箱地址时创建前缀。 | | Email Suffix | 用于生成电子邮箱地址时创建后缀的字符串（ `@example.com`）。 | | Sync Users |选中此框以将用户同步到您的组织。
选中此框将允许您指定用户筛选器、用户路径、用户对象类以及用户电子邮箱属性。
| | User Filter | 参阅[指定同步筛选器](#specify-sync-filters)。 | | User Path | 与指定的**根路径**一起使用的属性，用于搜索用户（例如 `ou=users`）。如果未提供任何值，则子树搜索将从根路径开始。 | | User Object Class | 用于 LDAP 用户对象类的名称（例如 `user`）。 | | User Email Attribute | 用于加载用户电子邮箱地址时使用的属性。 | | Sync Groups |选中此框以将群组同步到您的组织。
选中此框将允许您指定群组筛选器、群组路径、群组对象类以及群组名称属性。
| | Group Filter | 参阅[指定同步筛选器](#specify-sync-filters)。 | | Group Path | 与指定的**根路径**一起使用的属性，用于搜索群组（例如 `ou=groups`）。如果未提供任何值，则子树搜索将从根路径开始。 | | Group Object Class | 用于 LDAP 群组对象类的名称（例如 `groupOfUniqueNames`）。 | | Group Name Attribute | 目录使用此属性名称来定义群组的名称（例如 `name`） | ### 指定同步筛选器 用户和群组筛选器可以是任何 LDAP 兼容的搜索筛选器形式。 与标准 LDAP 指导相比，Active Directory 提供了一些用于编写搜索筛选器时使用的高级选项和限制。在[此处](https://docs.microsoft.com/en-us/windows/win32/adsi/search-filter-syntax?redirectedfrom=MSDN)了解有关编写 Active Directory 搜索筛选器的更多信息。 {% hint style="info" %} 嵌套的群组可以在目录连接器中使用单个引用同步多个群组对象。具体方法是创建一个其成员属于其他群组的群组。 {% endhint %} ### 示例 要为具有包含 `Marketing` 的 `cn`（通用名称）以及具有 `objectClass=user` 的所有条目筛选同步： ```systemd (&(objectClass=user)(cn=*Marketing*)) ``` （**仅适用于 LDAP**）要为具有 \ `ou`（组织单元）组件（他们的 `dn`（专有名词）是 `Miami` 或 `Orlando`）的所有条目筛选同步： ```systemd (|(ou:dn:=Miami)(ou:dn:=Orlando)) ``` （**仅适用于 LDAP**）要排除与表达式相匹配的条目，例如所有 `ou=Chicago` 但排除同样匹配 `ou=Wrigleyville` 的条目： ```systemd (&(ou:dn:=Chicago)(!(ou:dn:=Wrigleyville))) ``` （**仅适用于** **AD**）要为 `Heroes` 群组中的用户筛选同步： ```systemd (&(objectCategory=Person)(sAMAccountName=*)(memberOf=cn=Heroes,ou=users,dc=company,dc=com)) ``` （**仅适用于** **AD**）要通过目录或嵌套为 `Heroes` 群组成员的用户筛选同步： ```systemd (&(objectCategory=Person)(sAMAccountName=*)(memberOf:1.2.840.113556.1.4.1941:=cn=Heroes,ou=users,dc=company,dc=com)) ``` ## 测试同步 {% hint style="success" %} 在测试或执行同步之前，请检查目录连接器是否连接到正确的云服务器（如 US 或 EU）或自托管服务器。了解如何使用[桌面 App](https://help.ppgg.in/docs/admin-console/manage-members/directory-connector/directory-connector-desktop-app) 或 [CLI](https://help.ppgg.in/docs/admin-console/manage-members/directory-connector/directory-connector-cli) 进行检查。 {% endhint %} 要测试目录连接器是否成功连接到您的目录并返回所需的用户和群组，导航到 **Dashboard** 标签页并选择 **Test Now** 按钮。如果成功，则用户和群组将根据指定的[同步选项](#configure-sync-options)和[筛选器](#specify-sync-filters)显示在目录连接器窗口中： {% embed url="