关于 SCIM

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

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

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

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

设置 SCIM

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

SCIM 预配

属性要求

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

用户属性

对于每个用户,Bitwarden 将使用以下属性:

  • 表明用户处于 active 状态的指示(必填

  • emailª 或 userName必填

  • displayName

  • externalId

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

群组属性

对于每个用户,Bitwarden 将使用以下属性:

  • displayName必填

  • membersª

  • externalId

ª - members 是一个对象数组,每个对象代表该群组中的一个用户。

撤销和恢复访问权限

使用 SCIM 在 Bitwarden 中配置用户后,您可以暂时撤销他们对您的组织及其密码库项目的访问权限。当用户在您的 IdP 中被暂停/停用时,他们对您组织的访问权限将被自动撤销。

已撤销访问权限的用户列在组织的成员界面的已撤销选项卡中,并将:

  • 无权访问任何组织密码库项目、集合等。

  • 无法使用 SSO 登录,或使用 Organizational Duo 进行两步登录。

  • 不受您的组织策略的约束。

  • 不占用许可席位。

了解有关撤销恢复访问权限的更多信息。

SCIM 事件日志

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

已有用户和群组

在手动或使用目录连接器激活 SCIM 之前,具有用户和群组的组织应注意以下事项:

...已存在于 IdP 中
...不存在于 IdP 中

已有的用户

•不会重复

•不会被迫重新加入组织

•将根据 IdP 添加到相关群组

•不会从他们已经是其成员的组织中移除

•不会从组织中移除

•不会添加或移除群组成员身份

已有的群组

•不会重复

•将根据 IdP 添加成员

•不会移除现有成员

•不会从组织中移除

•不会添加或移除成员

如果您使用的是 Directory Connector,请确保在激活 SCIM 之前关闭同步。

更改 Bitwarden 电子邮箱地址

隶属于使用 SCIM 的组织的用户可以在 Bitwarden 及其组织的相关 IdP 中更改电子邮箱地址。要更改 SCIM 组织中的 Bitwarden 电子邮箱地址,请执行以下操作:

  1. 通过导航到设我的账户在 Bitwarden 中更改电子邮箱地址(更多信息请参阅这里)。

  2. 在 Bitwarden 上更改电子邮箱地址后,更新 IdP 或 AD 客户端上的用户值。这可以是 externalid 或相应的值,取决于企业对 IdP 的选择。

  3. 重新同步 IdP 或 AD 客户端,以实现更改。

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

最后更新于