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

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

我们目前支持 SP 发起和 IdP 发起的身份验证。有关用户配置，请参阅 [SCIM](./enterprise-scim)。

> [!WARNING]
> 此功能包含在 Team & Enterprise 套餐中。

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

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

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

您将被重定向到该页面，点击“创建您的应用程序”，填写您的应用程序名称，然后“创建”该应用程序。

然后选择“单点登录”，并选择 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

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

启用后，您组织的成员必须完成[工作原理](./security-sso-basic#how-it-works)部分中描述的 SSO 身份验证流程。