" %}
JumpCloud SSO 配置
{% endembed %}
| 字段 | 描述 |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| IdP Entity ID | 将此字段设置为唯一的、专用于 Bitwarden 的值，例如 `bitwardensso_yourcompany`. |
| SP Entity ID | 将此字段设置为从 Bitwarden SSO 配置界面中预先生成的 SP 实体 ID。
此自动生成的值可以从组织的设置 → 单点登录界面复制，并且会根据您的设置而有所不同。
|
| ACS URL | 将此字段设置为从 Bitwarden SSO 配置界面中预先生成的断言消费者服务 (ACS) URL。
此自动生成的值可以从组织的设置 → 单点登录界面复制，并且会根据您的设置而有所不同。
|
#### 仅对于自定义 SAML 应用程序
如果您创建了 Custom SAML Application，您还需要配置以下 **Single Sign-On Configuration** 字段：
| 字段 | 描述 |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SAMLSubject NameID | 指定将在 SAML 响应中作为 NameID 发送的 JumpCloud 属性。 |
| SAMLSubject NameID Format | 指定在 SAML 响应中发送的 NameID 的格式。 |
| Signature Algoritm | 选择用于签名 SAML 声明或响应的算法。 |
| Sign Assertion | 默认，JumpCloud 将对 SAML 响应进行签名。选中此框以签名 SAML 声明。 |
| Login URL | 将此字段设置为用户访问 Bitwarden 的登录 URL。
对于云托管客户，其始终为
|
### 属性
在 **Single Sign-On Configuration** → **Attributes** 部分，构建以下 SP → IdP 属性映射。如果您在 JumpCloud 中选择了 Bitwarden Application，则这些应该已经构建：
{% embed url="" %}
属性映射
{% endembed %}
完成后，选择 **activate** 按钮。
### 下载证书
应用程序激活后，再次使用 **SSO** 菜单选项打开已创建的 Bitwarden 应用程序。选择 **IDP Certificate** 下拉菜单然后 **Download certificate**：
{% embed url="" %}
下载证书
{% endembed %}
### 绑定用户群组
在 JumpCloud 门户网站中，从菜单中选择 **User Groups**：
{% embed url="" %}
用户群组
{% endembed %}
创建一个专用于 Bitwarden 的用户群组，或打开所有用户默认用户群组。在任一情况下，选择 **Applications** 选项卡并对该用户群组创建的 Bitwarden SSO 应用程序开启访问权限：
{% embed url="" %}
绑定应用程序权限
{% endembed %}
{% hint style="success" %}
或者，您可以直接从 **SSO** → **Bitwarden Application** 界面绑定对用户群组的访问权限。
{% endhint %}
## 返回网页 App
至此，您已经在 JumpCloud 门户网站中配置好了您所需要的一切。请返回 Bitwarden 网页 App 完成配置。
单点登录界面将配置分为两个部分：
* **SAML 服务提供程序配置**将决定 SAML 请求的格式。
* **SAML 身份提供程序配置**将决定用于 SAML 响应的预期格式。
### 服务提供程序配置
根据在 JumpCloud 门户网站的[应用程序创建期间](#create-a-jumpcloud-saml-app)所选择的选项配置以下字段：
| 字段 | 描述 |
| ---------------------------------- | ------------------------------------------------------------------------------------------ |
| Name ID Format | 如果您创建了 Custom SAML Application，请将其设置为指定的 SAMLSubject NameID 格式内容。否则，请保留为 **Unspecified**。 |
| Outbound Signing Algorithm | Bitwarden 用于签名 SAML 请求的算法。 |
| Signing Behavior | SAML 请求是否/何时将被签名。默认，JumpCloud 不要求对请求进行签名。 |
| Minimum Incoming Signing Algorithm | 如果您创建了自定义 SAML 应用程序，请将其设置为您选择的签名算法。否则，保留为 `rsa-sha256`。 |
| Want Assertions Signed | 如果您创建了自定义 SAML 应用程序，并且您在 JumpCloud 中设置了 **Sign Assertion** 选项，请选中此框。否则，保留为未选中。 |
| Validate Certificates | 通过受信任的 CA 使用来自 IdP 的受信任和有效证书时，请选中此框。除非在 Bitwarden SSO 登录 docker 镜像中配置了适当的信任链，否则自签名证书可能会失败。 |
完成服务提供程序配置部分后，**保存**您的工作。
### 身份提供程序配置
身份提供程序配置通常需要你返回 JumpCloud 门户网站以获取应用程序的值：
| 字段 | 描述 |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entity ID | 输入您的 JumpCloud **IdP Entity ID**，这可以从 JumpCloud [单点登录配置部分](#single-sign-on-configuration)来获取。 |
| Binding Type | 设置为 **Redirect**。 |
| Single Sign On Service URL | 输入您的 JumpCloud **IdP URL**，这可以从 JumpCloud [单点登录配置部分](#single-sign-on-configuration)来获取。 |
| Single Log Out Service URL | SSO 登录当前还**不支持** SLO。该选项计划未来开发。 |
| X509 Public Certificate | 黏贴已获取的证书，移除 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----。
证书值区分大小写，多余的空格、回车符和其他多余的字符将导致证书验证失败。
|
| Outbound Signing Algorithm | 如果您创建了 Custom SAML Application，请将其设置为您选择的签名算法。否则，请保留为 `rsa-sha256`。 |
| Disable Outbound Logout Requests | SSO 登录当前还**不支持** SLO。该选项计划未来开发。 |
| Want Authentication Requests Signed | JumpCloud 是否要求 SAML 请求被签名。 |
{% hint style="info" %}
填写 X509 证书时，请注意到期日期。必须续签证书，以防止向 SSO 最终用户提供的服务中断。如果证书已过期，管理员和所有者账户将始终可以使用电子邮箱地址和主密码登录。
{% endhint %}
完成身份提供程序配置部分后，**保存**您的工作。
{% hint style="success" %}
您可以通过激活单点登录身份验证策略来要求用户使用 SSO 登录。请注意，这需要先激活单一组织策略。[了解更多](https://help.ppgg.in/docs/admin-console/oversight-visibility/enterprise-policies)。
{% endhint %}
## 测试配置
配置完成后，通过导航到 或 [https://vault.bitwarden.eu](https://vault.bitwarden.eu/)，输入您的电子邮箱地址，选择**继续**，然后选择**使用单点登录**按钮来进行测试：
{% embed url="" %}
登录选项界面
{% endembed %}
输入[已配置的组织标识符](https://help.ppgg.in/docs/admin-console/login-with-sso/generic-saml#step-1-set-an-organization-identifier)，然后选择**登录**。如果您的实施已成功配置，您将被重定向到 JumpCloud 的登录界面：
{% embed url="" %}
JumpCloud 登录界面
{% endembed %}
使用您的 JumpCloud 凭据进行身份验证后，输入您的 Bitwarden 主密码来解密您的密码库！
{% hint style="info" %}
Bitwarden 不支持非请求响应，因此从您的 IdP 发起登录会导致错误。SSO 登录流程必须从 Bitwarden 发起。
{% endhint %}