Microsoft Entra ID SAML 实施
最后更新于
这有帮助吗？
最后更新于
这有帮助吗？
对应的官方文档地址
本文是专门针对 Azure 用于配置 SAML 2.0 方式的 SSO 登录的帮助。有关其他 IdP 方式配置 SSO 登录的帮助，请参阅 SAML 2.0 配置。
配置需要在 Bitwarden 网页 App 和 Azure 控制台中同时进行。在您继续进行操作时，我们建议您准备好这两样东西，并按照文档中的顺序完成这些步骤。
已经是 SSO 专家？跳过本文中的说明，然后下载快速配置以与您自己的配置进行比较。
⬇️快速配置指南
登录到 Bitwarden 网页 App，使用产品切换器打开管理控制台：
打开组织的设置 → 单点登录界面：
如果还没有为您的组织创建唯一的 SSO 标识符，请创建一个，然后从类型下拉菜单中选择 SAML。保持此界面打开，以方便参考。
如果愿意，您可以在此阶段关闭设置专属的 SP 实体 ID 选项。这样做会从 SP 实体 ID 值中移除组织 ID，但大多数情况下都建议打开该选项。
您可以选择性使用成员解密选项。了解如何开始使用受信任设备 SSO 和 Key Connector。
在 Azure 门户中，导航到 Microsoft Entra ID 然后从导航菜单中选择 Enterprise applications：
选择 🞤New application 按钮：
在 Microsoft Entra ID Gallery 界面，选择 🞤Create your own application 按钮：
在 Create your own application 界面，为应用程序指定一个唯一的、专用于 Bitwarden 的名称并选择 Create 按钮。
在应用程序概览界面，从导航菜单选择 Single sign-on：
在 Single sign-on 界面，选择 SAML。
选择 Edit 按钮并配置如下字段：
Identifier (Entity ID)
将此字段设置为预先生成的 SP Entity ID。
Reply URL (Assertion Consumer Service URL)
将此字段设置为预先生成的 Assertion Consumer Service (ACS) URL。 此自动生成的值可以从组织的设置 → 单点登录界面复制，并根据设置而有所不同。
Sign on URL
Azure 构造的默认声明可用于 SSO 登录，但您可以选择使用此部分来配置 Azure 在 SAML 响应中使用的 NameID 格式。
选择 Edit 按钮并选择 Unique User Identifier (Name ID) 条目以编辑 NameID 声明：
选项包括默认、电子邮件地址、永久、未指定和 Windows 限定域名。有关详细信息，请参阅 Microsoft Azure 文档。
下载 Base64 证书以在后续步骤中使用。
复制或记下此部分中的 Login URL 和 Azure AD Identifier，以在后续步骤中使用：
如果在 SSO 登录时收到任何密钥错误，请尝试从联邦元数据 XML 文件中复制 X509 证书信息。
从导航菜单选择 Users and Groups：
选择 Add user/group 按钮，以分配用户或群组级别对 SSO 登录应用程序的访问权限。
至此，你已经在 Azure 门户范围内配置好了你所需要的一切。返回 Bitwarden 网页 App 来完成配置。
单点登录界面将配置分为两个部分：
SAML 服务提供程序配置将决定 SAML 请求的格式。
SAML 身份提供程序配置将决定用于 SAML 响应的预期格式。
配置以下字段：
Name ID Format
Outbound Signing Algorithm
Bitwarden 用于签名 SAML 请求的算法。
Signing Behavior
SAML 请求是否/何时将被签名。
Minimum Incoming Signing Algorithm
默认，Azure 将使用 RSA SHA-256 签名。请从下拉列表中选择 rsa-sha256。
Want Assertions Signed
Bitwarden 是否要求 SAML 声明被签名
Validate Certificates
通过受信任的 CA 使用来自 IdP 的受信任和有效证书时，请选中此框。除非在 Bitwarden SSO 登录 docker 镜像中配置了适当的信任链，否则自签名证书可能会失败。
完成服务提供程序配置部分后，Save（保存）您的工作。
身份提供程序配置通常需要你返回 Azure 门户以获取应用程序的值：
Entity ID
Binding Type
设置为 HTTP POST 或 Redirect。
Single Sign On Service URL
Single Log Out Service URL
SSO 登录当前不支持 SLO。该选项计划用于将来的开发，但如果您需要，可以将其预先配置为 Logout URL。
Artifact Resolution Service URL
Azure 当前不支持 Artifact 绑定，因此请将此字段留空。
X509 Public Certificate
Outbound Signing Algorithm
默认，Azure 将使用 RSA SHA-256 签名。请从下拉列表中选择 rsa-sha256。
Allow Unsolicited Authentication Response
SSO 登录当前不支持未经请求（由 IdP 发起）的 SAML 声明。该选项计划用于将来的开发。
Disable Outbound Logout Requests
SSO 登录当前不支持 SLO。该选项计划用于将来的开发。
Want Authentication Requests Signed
Azure 是否要求 SAML 请求被签名。
填写 X509 证书时，请注意到期日期。必须续签证书，以防止向 SSO 最终用户提供的服务中断。如果证书已过期，管理员和所有者账户将始终可以使用电子邮箱地址和主密码登录。
完成身份提供程序配置部分后，Save（保存）您的工作。
您可以通过激活单点登录身份验证策略来要求用户使用 SSO 登录。请注意，这需要先激活单一组织政策。了解更多。
配置完成后，通过导航到 https://vault.bitwarden.com 或 https://vault.bitwarden.eu，输入您的电子邮箱地址，选择继续，然后选择企业单点登录按钮来进行测试：
输入已配置的组织标识符，然后选择登录。如果您的实施已成功配置，您将被重定向到 Microsoft 的登录界面：
使用您的 Azure 凭据进行身份验证后，输入您的 Bitwarden 主密码来解密您的密码库！
Bitwarden 不支持非请求响应，因此从您的 IdP 发起登录会导致错误。SSO 登录流程必须从 Bitwarden 发起。Entra ID SAML 管理员可以为用户设置一个应用程序注册，将其引导到 Bitwarden 网络密码库登录页面：
通过导航到当前的 Bitwarden 企业应用程序，选择 Properties 并将 Visible to users 选项设置为 No，禁用 All Applications 页面中现有的 Bitwarden 按钮。
在 App Registrations 中选择 New Registration，创建新的应用程序注册。
为应用程序提供一个名称，如 Bitwarden SSO，但不要指定重定向 URL。选择 Register 完成表格。
应用程序创建完成后，导航至导航菜单上的 Branding & Properties。
向应用程序添加以下设置：
上传一个用于终端用户识别的徽标。您可以在此处获取 Bitwarden 徽标。
将主页 URL 设为 Bitwarden 客户端登录页面，如 https://vault.bitwarden.com/#/login。
完成此过程后，分配的用户将拥有一个直接链接到 Bitwarden 网络密码库登录页面的 Bitwarden 应用程序。
将此字段设置为用户访问 Bitwarden 的登录 URL。
对于云托管客户，其始终为 https://vault.bitwarden.com/#/sso 或 https://vault.bitwarden.eu/#/sso。对于自托管实例，这由您 决定，例如为 https://your.domain.com/#/sso。
默认，Azure 将使用电子邮件地址。如果您更改，请选择对应的值。否则，请将此字段设置为 Unspecified 或 Email Address。
输入从 Azure 门户的部分获取到的 Azure AD Identifier。
输入从 Azure 门户的部分获取到的 Login URL。
黏贴，移除 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE-----。
多余的空格、回车符和其他多余的字符将导致证书验证失败。