使用 Okta 同步

对应的官方文档地址

本文将帮助您使用 Directory Connector 将您的 Okta 目录中的用户和群组同步到您的 Bitwarden 组织。

创建 Okta API 令牌

Directory Connector 需要 Okta 生成的令牌的信息才能连接到您的目录。完成以下步骤以创建和获取供 Directory Connector 使用的 Okta API 令牌：

1. 从您的 Okta Developer Console (https://yourdomain-admin.okta.com) 导航到 Security → API → Tokens。

2. 选择 Create Token 按钮，然后给您的令牌指定一个专用于 Bitwarden 的名称（比如 bitwartden-dc）。

3. 将生成的 Token Value 复制到剪贴板。

您的 Token Value 不会再次显示。请将其粘贴到某个安全的地方以防丢失。

连接到您的目录

完成以下步骤以配置 Directory Connector 使用您的 Okta 目录：

1. 打开 Directory Connector 桌面 App。

2. 导航到 Setting 选项卡。

3. 从 Type 下拉菜单中，选择 Okta。 此部分中的可用字段将根据您选择的类型而变化。

4. 在 Organization URL 字段中输入您的 Okta Organization URL（比如 https://yourdomain.okta.com）。

5. 将 API Token Value 粘帖到 Token 字段中。

配置同步选项

完成配置后，请导航至 More 标签页，然后选择 Clear Sync Cache 按钮，以防止与先前的同步操作发生潜在的冲突。更多信息，请参阅清除同步缓存。

完成以下步骤以配置当使用 Directory Connector 同步时要使用的设置：

1. 打开 Directory Connector 桌面 App。

2. 导航到 Setting 选项卡。

3. 在 Sync 部分，根据需要配置如下选项：

选项	描述
Interval	自动同步检查的时间间隔（分钟为单位）。
Remove disabled users during sync	选中此框以从 Bitwarden 组织中删除已在您的组织中禁用的用户。
Overwrite existing organization users based on current sync settings	选中此框以始终执行完全同步，如果任何用户不在同步用户集中，则将其从 Bitwarden 组织中移除。
More than 2000 users or groups are expected to sync	如果预计同步 2000 个以上用户或群组，请选中此框。如果不勾选此框，Directory Connector 会将同步限制在 2000 个用户或群组。
Sync Users	选中此框以将用户同步到您的组织。 选中此框将允许您指定用户筛选器。
User Filter	参阅指定同步筛选器。
Sync Groups	选中此框以将群组同步到您的组织。 选中此框将允许您指定群组筛选器。
Group Filter	参阅指定同步筛选器。

指定同步筛选器

使用逗号分隔的列表可根据用户电子邮箱、群组名称在同步中包含或排除。此外，Okta API 为用户和群组提供了有限的筛选功能，这些功能可以在 Directory Connector 筛选器字段中使用。

有关为用户和群组使用 filter 参数的更多信息，请查阅 Okta 文档。

用户筛选器

按电子邮箱包含/排除用户

要基于电子邮箱地址在同步中包含或排除特定用户：

include:[e-mail],[e-mail],[e-mail]

exclude:[e-mail],bill@example,[e-mail]

使用 filter 连接

要使用 filter 参数连接用户筛选器，请使用管道符 (|)：

include:[e-mail],[e-mail]|profile.firstName eq "John"

exclude:[e-mail],[e-mail]|profile.firstName eq "John"

只使用 filter

要只使用 filter 参数，请在查询前加上管道符 (|)：

|profile.lastName eq "Smith"

群组筛选器

Okta 不支持嵌套群组。

包含/排除群组

要基于群组名称包含或排除群组：

include:Group A,Group B

exclude:Group A,Group B

使用 filter 连接

要使用 filter 参数连接群组筛选器，请使用管道符 (|)：

include:Group A|type eq "APP_GROUP"

exclude:Group A|type eq "APP_GROUP"

只使用 filter

要只使用 filter 参数，请在查询前加上管道符 (|)：

|type eq "BUILT_IN"

测试同步

在测试或执行同步之前，请检查 Directory Connector 是否连接到正确的云服务器（如 US 或 EU）或自托管服务器。了解如何使用桌面 App 或 CLI 进行检查。

要测试 Directory Connector 是否成功连接到您的目录并返回所需的用户和群组，导航到 Dashboard 选项卡，然后选择 Test Now 按钮。如果成功，则用户和群组将根据指定的同步选项和筛选器显示在 Directory Connector 窗口中：

测试同步的结果

启动自动同步

配置并测试同步选项和筛选器后，就可以开始同步了。完成以下步骤以使用 Directory Connector 启动自动同步：

1. 打开 Directory Connector 桌面 App。

2. 导航到 Dashboard 选项卡。

3. 在 Sync 部分，选择 Start Now 按钮。 或者您可以选择 Sync Now 按钮以运行一次性手动同步。

Directory Connector 将根据配置的同步选项和筛选器开始轮询目录。

如果您退出或关闭了 Directory Connector，自动同步将停止。最小化或隐藏此程序到系统托盘，以保持后台运行。

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

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