目录连接器文件存储

对应的官方文档地址

桌面 App 和 CLI 共享数据库和配置，因此不建议在一台机器上同时使用。建议使用桌面 App 完成配置和测试，然后使用 CLI 调度自动同步到生产组织。

我们建议在调节目录连接器配置文件之前使用桌面 App 或 CLI，因为无法通过该文件设置目录连接器的全部内容。密钥或机密等身份验证的值必须通过桌面 App 或 CLI 设置。

配置文件

目录连接器配置文件（data.json）包含可以直接编辑的对象，以便于：

• 设置到您的目录的连接

• 配置同步选项

无法通过 data.json 文件设置目录连接器的全部内容。例如密钥或密码等用于身份验证的值，这些值必须通过桌面 App 或 CLI 来设置。

⬇️下载示例配置文件

避免在目录连接器桌面 App 或 CLI 可执行文件运行时打开或修改 data.json 文件。

位置

data.json 的位置取决于您使用的平台：

• Windows：

  • 安装版：%AppData%\Bitwarden Directory Connector

  • 便携版：.\bitwarden-connector-appdata

• macOS：~/Library/Application Support/Bitwarden Directory Connector

• Linux：~/.config/Bitwarden Directory Connector

当使用目录连接器 CLI 时，运行 data-file 命令来获取 data.json 的绝对路径。

加密存储

默认情况下，目录连接器桌面 App 和 CLI 都使用安全方法来加固敏感数据（例如您的目录账户密码、API 密钥等等）。

在 Linux 系统上，这需要 GNOME 密钥环和 X11，它们通常保留用于桌面环境。如果您使用的是无头 Linux 环境，则可能会遇到以下错误：

Cannot autolaunch D-Bus without X11 $DISPLAY

无头环境下的加密存储

如果没有安全的存储环境，则可以将目录连接器 CLI 配置为使用纯文本存储。要这样做，请设置以下环境变量以覆盖安全存储。比如通过运行 sudo -H gedit /etc/environment：

BITWARDENCLI_CONNECTOR_PLAINTEXT_SECRETS=true

启用纯文本存储后，您可以从 data.json 配置文件中以纯文本配置所有设置项。

纯文本的加密存储与目录连接器桌面 App 不兼容。您只能将纯文本的加密存储与目录连接器 CLI 一起使用。