如何配置与 Microsoft Entra ID (Azure AD) 的 SAML SSO

在本指南中，我们将使用 Microsoft Entra ID 作为 SSO 提供商，并采用安全断言标记语言（SAML）协议作为首选身份协议。

我们目前支持 SP 发起和 IdP 发起的身份验证。有关用户配置，请参阅 SCIM。

此功能属于 Team & Enterprise 计划的一部分。

步骤 1：在您的身份提供商中创建新应用

在浏览器中打开一个新标签页/窗口，并登录您所在组织的 Azure 门户。

导航至“企业应用程序”并点击“新建应用程序”按钮。

您将被重定向到该页面，点击“Create your own application”，填写您的应用名称，然后“Create”该应用。

然后选择“单点登录”，并选择 SAML

步骤 2：在 Azure 上配置您的应用

在浏览器中打开一个新标签页/窗口，并导航到您组织的设置中的 SSO 部分。选择 SAML 协议。

从 Hugging Face 的组织设置中复制“SP Entity Id”，并将其粘贴到 Azure 的“Identifier (Entity Id)”字段中（1）。

从 Hugging Face 的组织设置中复制“Assertion Consumer Service URL”，并将其粘贴到 Azure 的“Reply URL”字段中（2）。

URL 的格式如下：https://huggingface.co/organizations/[organizationIdentifier]/saml/consume。

然后在“SAML Certificates”下，确认“Signin Option”已设置为“Sign SAML response and assertion”。

保存您的新应用程序。

步骤 3：在 Hugging Face 上完成配置

在您的 Azure 应用中，在“设置”下，找到以下字段：

• 登录 URL

在“SAML 证书”下：

• 下载“证书 (base64)”

您需要使用它们来完成 Hugging Face 上的 SSO 设置。

在您的组织设置的 SSO 部分，从 Azure 复制并粘贴这些值：

• 登录 URL -> 登录 URL
• 证书 -> 公钥证书

公共证书必须具有以下格式：

-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----

现在您可以点击“更新并测试 SAML 配置”来保存设置。

您将被重定向到 SSO 提供商（IdP）的登录提示。登录成功后，您将被重定向到组织的设置页面。

SAML 选择器旁边的绿色对勾表示测试成功。

步骤 4：在您的组织中启用 SSO

现在，单点登录已配置并测试完毕，您可以点击“启用”按钮，为您的组织成员启用该功能。

启用后，您组织的成员必须完成工作原理部分中描述的 SSO 身份验证流程。