关于 SCIM

对应的官方文档地址

跨域身份管理系统 (SCIM) 用于在您的 Bitwarden 组织中自动配置成员和群组。

Bitwarden 服务器提供了一个 SCIM 端点，该端点具有有效的 SCIM API 密钥，将接受来自您的身份提供程序 (IdP) 的用户和群组的配置和取消配置请求。

SCIM 集成适用于团队版组织和企业版组织。未使用与 SCIM 兼容的身份提供程序的客户可以考虑使用目录同步作为替代的配置方式。

Bitwarden 支持使用标准属性映射的 SCIM v2，并提供以下官方 SCIM 集成：

除了上面列出的提供程序之外，Bitwarden 还提供与 Google Workspace 的测试版集成。联系我们以了解更多信息。

设置 SCIM

要设置 SCIM，您的 IdP 需要一个 SCIM URL 和 API 密钥来向 Bitwarden 服务器发出授权请求。这些值可以通过导航到管理控制台的设置 → SCIM 配置获取：

以下部分涵盖了可用于设置 SCIM 的通用信息，但 Bitwarden 建议使用以下集成文档之一：

属性要求

Bitwarden 使用此处列出的标准 SCIM v2 属性名称，但每个 IdP 也可以使用在配置期间映射到 Bitwarden 的备用名称。

用户属性

对于每个用户，Bitwarden 将使用以下属性：

表明用户处于 active 状态的指示（必填）
emailª 或 userName（必填）
displayName
externalId

ª - 由于 SCIM 允许用户将多个电子邮箱地址表示为对象数组，因此 Bitwarden 将使用包含 "primary": true 的对象的 value。

群组属性

对于每个用户，Bitwarden 将使用以下属性：

displayName（必填）
membersª
externalId

ª - members 是一个对象数组，每个对象代表该群组中的一个用户。必须使用群组配置才能将已同步用户分配到群组，但是 SCIM API 不能用于查询群组中的成员。要查询群组成员资格，请使用公共 API。

SCIM 事件日志

组织将捕获 SCIM 集成所执行操作的事件日志，包括邀请用户和移除用户，以及创建或删除群组。SCIM 派生的事件将在成员列中注册 SCIM。

现有对象更新

以下章节将说明当 IdP 发生变更时，SCIM 配置会将哪些更改同步到组织的成员和群组：

成员状态

当用户在您的 IdP 中被暂时挂起或停用（而非直接移除）时，其对您组织的访问权限将自动撤销。被撤销访问权限的用户将显示在组织成员界面的已撤销标签页中，并且将：

无法访问任何组织密码库项目和集合
无法使用 SSO 登录或组织层面 Duo 两步登录
不受组织策略的约束
不占用许可证席位

对于那些使用受信任设备 SSO 而没有主密码的成员账户：

从您的组织中移除它们将切断它们对 Bitwarden 账户的所有访问权限，除非该账户此前通过账户恢复功能设置过主密码，且在移除前至少使用该主密码登录过一次。

除非在用户被从组织中移除之前采取了上述步骤，否则用户将无法重新加入您的组织。如果没有采取上述步骤，每个被移除的用户都必须删除自己的账户，然后重新获得邀请才能创建账户和加入组织。

撤销对组织的访问权限，但不会从组织中移除他们，他们仍然可以登录 Bitwarden 并仅可以访问他们的个人密码库。

成员电子邮箱地址

使用受信任设备的组织成员无法更改其电子邮件地址，除非已获得带有账户恢复功能的主密码。

使用 Key Connector 的组织成员无法更改其电子邮件地址。成员账户需要删除并重新配置才能更改电子邮件地址。请提醒用户在删除账户前导出数据，并在使用新电子邮件地址重新配置账户后导入数据。

使用 SCIM 配置的用户可以在 Bitwarden 及其组织的相关 IdP 中更改电子邮箱地址。要更改 SCIM 组织中的 Bitwarden 电子邮箱地址，请执行以下操作：

通过导航到设置 → 我的账户在 Bitwarden 中更改电子邮箱地址（了解更多）。
在 Bitwarden 上更改电子邮箱地址后，更新 IdP 或 AD 客户端上的用户值。这可以是 externalid 或相应的值，取决于组织对 IdP 的选择。
重新同步 IdP 或 AD 客户端，以实现更改。

如果在更新 Bitwarden 电子邮箱之前，用户电子邮箱地址已在 IdP 或 AD 上更新并同步过，则更新后的电子邮箱将被视为新的用户。

成员显示名称

虽然 SCIM API 请求可配置为包含成员显示名称，但该数据目前不会在初始配置时或 IdP 发生变更时同步至 Bitwarden。

成员外部 ID

虽然 SCIM 配置会在用户首次配置时为其分配一个外部 ID，但目前它不会将 IdP 中的外部 ID 更改同步至 Bitwarden。

SCIM 实施前的对象更新

如果您在实施 SCIM 之前使用 Directory Connector，请务必在启用 SCIM 配置之前将 Directory Connector 关闭。

以下章节说明 SCIM 配置将为组织中现有成员和群组同步的变更内容（针对 SCIM 实施前已存在的成员和群组）：

SCIM 实施前加入的成员

SCIM 配置将根据成员是否存在于 IdP 中，对 SCIM 实施之前加入您的组织的成员采取不同的处理方式：

存在于 IdP 中且在 SCIM 实施前加入的成员不会被重复创建、无需重新加入组织，也不会从任何群组中移除。
不存在于 IdP 中且在 SCIM 实施前加入的成员不会被移除，也不会被添加或移出任何群组。

SCIM 实施前创建的群组

SCIM 配置将根据群组是否存在于 IdP 中，对 SCIM 实施前创建于您的组织的群组采取不同的处理方式：

存在于 IdP 中且在 SCIM 实施前创建的群组不会被重复创建或移除任何成员，但会根据身份提供商分配的成员资格添加新成员。
不存在于 IdP 中且在 SCIM 实施前创建的群组不会被移除，也不会添加或移除任何成员。

上一页SCIM 下一页JumpCloud SCIM 集成

最后更新于4天前