Auth0 SAML 实施

对应的官方文档地址

本文是专门针对 Auth0 用于配置 SAML 2.0 方式的 SSO 登录的帮助。有关其他 IdP 方式配置 SSO 登录的帮助，请参阅 SAML 2.0 配置。

配置需要在 Bitwarden 网页密码库和 Auth0 门户网站中同时进行。在您继续进行操作时，我们建议您随时准备好并按照记录的顺序完成步骤。

已经是 SSO 专家？跳过本文中的说明，然后下载示例配置，将里面的屏幕截图与您自己的配置进行比较。

⬇️下载示例

在网页密码库中打开 SSO

如果你是直接从 SAML 2.0 配置过来的，你应该已经创建了一个组织 ID 并打开了 SSO 配置界面。如果你没有，请参考那篇文章，为 SSO 创建一个组织 ID。

导航到您组织的管理 → 单点登录界面：

你不需要编辑此界面上的任何内容，但要保持打开以方便引用。

如果您是自托管 Bitwarden，您可以选择性使用成员解密选项。此功能默认情况下被禁用，因此现在继续使用主密码解密，并了解如何在配置完成并成功运行后开始使用 Key Connector。

创建 Auth0 应用程序

在 Auth0 门户中，使用应用程序菜单来创建一个 Regular Web Application（常规的 Web 应用程序）：

点击 Setting 标签并配置以下信息，其中一些信息您需要从 Bitwarden 业务门户中获取：

Auth0 设置

描述

Grant Types

在 Advanced Settings → Grant Types 部分，确保选择了以下授权类型（可以预先选择）：

Certificates

在 Advanced Settings → Certificates 部分，复制或下载您的签名证书。你现在还不需要用它做任何事情，但需要稍后引用它。

Endpoints

不需要在 Advanced Settings → Endpoints 部分编辑任何东西，但你需要这个 SAML 端点，以便稍后引用它。

在较小的窗口中，Endpoints 选项卡可能会消失在浏览器的边缘。如果您找不到它，请单击 Certificates 选项卡，然后按右方向键键（→）。

配置 Auth0 规则

创建规则来定制你的应用程序的 SAML 响应行为。虽然 Auth0 提供了多个选项，但这里将只关注那些专门映射到 Bitwarden 的选项。要创建一个自定义 SAML 配置规则集，请使用 Auth Pipeline → Rules 菜单来 Create（创建）规则：

以下任何项目均可配置：

Key

描述

使用像下面这样的 Script（脚本）来实现这些规则。如需帮助，请参阅 Auth0 文档。

function (user, context, callback) {
    context.samlConfiguration.signatureAlgorithm = "rsa-sha256";
    context.samlConfiguration.digestAlgorithm = "sha256";
    context.samlConfiguration.signResponse = "true";
    context.samlConfiguration.nameIdentifierFormat = "urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress"
    context.samlConfiguration.binding = "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect";
    callback(null, user, context);
}