Directory Connector 桌面 App

对应的官方文档地址

Directory Connector 桌面 App 是一个独立的桌面应用程序，可用于从选定的目录服务同步用户、群组以及群组关联。

Directory Connector 桌面 App

Directory Connector 也提供 CLI 工具版本。桌面 App 和 CLI 共享数据库和配置，因此不建议在一台机器上同时使用。推荐的做法是，建议使用桌面 App 完成配置和测试，然后使用 CLI 来 调度自动同步到您的生产组织。

开始使用

要开始使用 Directory Connector 桌面 App：

1、从我们的 GitHub 发布页面或使用以下官方链接之一下载最新版本的 App：

• ​ Windows Installer (.exe)

• Windows Portable (.exe)

• macOS (ARM64) (.dmg) | macOS (x64) (.dmg)

• Linux (.AppImage)

2、如果您使用的是 Bitwarden 的自托管版本或使用 EU 服务器，请在登录前设置 Directory Connector 使用的服务器 URL：

1. 在登录界面上，选择 Setting。

2. 在 Server URL 字段中，输入带 https:// 的 Bitwarden 实例的域名。例如，https://vault.bitwarden.eu 或 https://your.domain.bitwarden.com。

3. 选择 Save。

3、使用您的组织 API 密钥登录 Directory Connector。如果您没有 API 密钥，请联系组织的所有者。

4、在 Setting 选项卡上，连接到您的目录并配置同步选项。此过程基于所使用的目录而有所不同，请参阅以下文章之一以获取说明：

• 使用 AD 或 LDAP 同步

• 使用 Microsoft Entra ID 同步

• 使用 Google Workspace 同步

• 使用 Okta 同步

• 使用 OneLogin 同步

如果您要重新配置同步选项，而不是第一次设置它们，请导航到 More 选项卡然后选择 Clear Sync Cache 按钮以防止与之前的同步操作发生潜在的冲突（了解更多）。

5、在 Setting 选项卡上，从 Organization 下拉菜单中选择您的组织。

6、执行同步测试。以检查您的目录连接和同步选项是否已成功配置并按预期工作：

1. 打开 Dashboard 选项卡。

2. 选择 Test Now 按钮。

同步测试将查询目录服务器并将结果打印到仪表板。结果包含的内容有：

• 将从目录中同步的用户列表。

• 将从目录中同步的群组列表。

• 根据用户在目录中的状态而将禁用的用户列表。

• 根据用户在目录中的状态而将从组织中删除的用户列表。

Directory Connector 测试同步

如果打印的结果符合您的预期，您就可以开始同步了。

使用 Directory Connector 同步

Directory Connector 可用于运行一次性手动同步或自动同步轮询：

手动同步

要运行从您的目录到 Bitwarden 组织的一次性手动同步，请打开 Dashboard 选项卡，然后选择 Sync Now 按钮。

已同步的用户将被邀请加入您的组织，并且将立即创建群组。

自动同步

只要应用程序处于打开状态，自动同步就会根据同步选项中指定的时间间隔轮询您的目录。如果您退出或关闭应用程序，自动同步轮询将停止。

要使用 Directory Connector 启动自动同步轮询，请打开 Dashboard 选项卡然后选择 Start Sync 按钮。

如果您使用的是团队入门版方案，则成员数量限制为 10 人。如果您尝试同步超过 10 名成员，Directory Connector 将显示错误并停止同步。

该方案已不再提供购买。此错误不适用于团队版方案。