> For the complete documentation index, see [llms.txt](https://help.ppgg.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ppgg.in/docs/admin-console/manage-members/directory-connector/directory-connector-desktop-app.md).

# Directory Connector 桌面 App

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/directory-sync-desktop/)
{% endhint %}

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

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/7r6eylncijFasEUrKXe2Hk/b6eec60c8a6452a300eeba5272c46ea4/app.png?w=896&#x26;fm=avif" alt=""><figcaption><p>Directory Connector 桌面 App</p></figcaption></figure></div>

Directory Connector 也提供 [CLI 工具版本](/docs/admin-console/manage-members/directory-connector/directory-connector-cli.md)。桌面 App 和 CLI [共享数据库和配置](/docs/admin-console/manage-members/directory-connector/directory-connector-file-storage.md)，因此不建议在一台机器上**同时**使用。推荐的做法是，建议使用[桌面 App](/docs/admin-console/manage-members/directory-connector/directory-connector-desktop-app.md) 完成配置和测试，然后使用 [CLI](/docs/admin-console/manage-members/directory-connector/directory-connector-cli.md) 来 [调度自动同步](/docs/admin-console/manage-members/directory-connector/schedule-a-sync.md)到生产组织。

## 开始使用 <a href="#getting-started" id="getting-started"></a>

要开始使用 Directory Connector 桌面 App：

1、从我们的 [GitHub 发布页面](https://github.com/bitwarden/directory-connector/releases)或使用以下官方链接之一下载最新版本的 App：

* ​![](https://files.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-M2XqgFI6fAcTD0lL3MZ%2F-M2lgIMT8p-h_KydT0nq%2F-M2lmjhiYHSJ5-sYyb6Z%2Fos-windows-24.png?alt=media\&token=0d9e6b96-ec16-4dc0-a39a-a78fdfb0e33a) [Windowsstaller  (.exe)​](https://bitwarden.com/download/?app=connector\&platform=windows)
* ​​![](https://files.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-M2XqgFI6fAcTD0lL3MZ%2F-M2lgIMT8p-h_KydT0nq%2F-M2lmjhiYHSJ5-sYyb6Z%2Fos-windows-24.png?alt=media\&token=0d9e6b96-ec16-4dc0-a39a-a78fdfb0e33a) [Windows Portable (.exe)](https://bitwarden.com/download/?app=connector\&platform=windows\&variant=portable)​
* ​​![](https://files.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-M2XqgFI6fAcTD0lL3MZ%2F-M2lgIMT8p-h_KydT0nq%2F-M2lmd9QDMlX1Sn3aHOo%2Fapple-24.png?alt=media\&token=e90fd6d0-5ca3-43a7-9818-441b86ae2147) [macOS (.dmg)](https://bitwarden.com/download/?app=connector\&platform=macos)​
* ​​![](https://files.gitbook.com/v0/b/gitbook-28427.appspot.com/o/assets%2F-M2XqgFI6fAcTD0lL3MZ%2F-M2lgIMT8p-h_KydT0nq%2F-M2lmhr5ffWYeEG74jXf%2Flinux-24.png?alt=media\&token=26403b17-eb24-4721-8c42-b6fb70164cc2) [Linux (.AppImage)](https://bitwarden.com/download/?app=connector\&platform=linux)

2、如果您使用的是 Bitwarden 的自托管版本或使用 [EU 服务器](/docs/security/server-geographies.md)，请在登录前设置 Directory Connector 使用的服务器 URL：

1. 在登录界面上，选择 **Setting**。
2. 在 **Server URL** 字段中，输入带 `https://` 的 Bitwarden 实例的域名。例如，`https://vault.bitwarden.eu` 或 `https://your.domain.bitwarden.com`。
3. 选择 **Save**。

3、使用您的[组织 API 密钥](/docs/admin-console/bitwarden-public-api.md#authentication)登录 Directory Connector。如果您没有 API 密钥，请联系[组织的所有者](/docs/admin-console/manage-members/member-roles.md)。

4、在 **⚙️Setting** 选项卡上，连接到您的目录并配置[同步选项](/docs/admin-console/manage-members/directory-connector/sync-options-and-filters.md)。此过程基于所使用的目录而有所不同，请参阅以下文章之一以获取说明：

* [使用 AD 或 LDAP 同步](/docs/admin-console/manage-members/directory-connector/sync-with-ldap-or-ad.md)
* [使用 Microsoft Entra ID 同步](/docs/admin-console/manage-members/directory-connector/sync-with-microsoft-entra-id.md)
* [使用 Google Workspace 同步](/docs/admin-console/manage-members/directory-connector/sync-with-google-workspace.md)
* [使用 Okta 同步](/docs/admin-console/manage-members/directory-connector/sync-with-okta.md)
* [使用 OneLogin 同步](/docs/admin-console/manage-members/directory-connector/sync-with-onelogin.md)

{% hint style="success" %}
如果您要重新配置同步选项，而不是第一次设置它们，请导航到 **More** 选项卡然后选择 **Clear Sync Cache** 按钮以防止与之前的同步操作发生潜在的冲突（[了解更多](/docs/admin-console/manage-members/directory-connector/clear-sync-cache.md)）。
{% endhint %}

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

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

1. 打开 🎨**Dashboard** 选项卡。
2. 选择 **Test Now** 按钮。

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

* 将从目录中同步的用户列表。
* 将从目录中同步的群组列表。
* 根据用户在目录中的状态而将禁用的用户列表。
* 根据用户在目录中的状态而将从组织中删除的用户列表。

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6HK5d7qPL22HYTHbgRS1tp/42127d0fde4fea4f645ea7ce807ebadc/Screenshot_2024-08-19_at_1.44.23_PM.png?w=1400&#x26;fm=avif" alt=""><figcaption><p>Directory Connector 测试同步</p></figcaption></figure></div>

如果打印的结果符合您的预期，您就可以[开始同步](#sync-with-directory-connector)了。

## 使用 Directory Connector 同步 <a href="#sync-with-directory-connector" id="sync-with-directory-connector"></a>

Directory Connector 可用于运行一次性[手动同步](#perform-a-manual-sync)或[自动同步轮询](#start-automatic-sync)：

### 手动同步 <a href="#manual-sync" id="manual-sync"></a>

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

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

### 自动同步 <a href="#automatic-sync" id="automatic-sync"></a>

只要应用程序处于打开状态，自动同步就会根据[同步选项](/docs/admin-console/manage-members/directory-connector/sync-options-and-filters.md)中指定的时间**间隔**轮询您的目录。如果您退出或关闭应用程序，自动同步轮询将停止。

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

{% hint style="info" %}
如果您使用的是[团队入门版](/docs/plans-and-pricing/password-manager/about-bitwarden-plans.md#teams-starter-organizations)方案，则成员数量限制为 10 人。如果您尝试同步超过 10 名成员，Directory Connector 将显示错误并停止同步。

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