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

本指南将使用 Microsoft Entra ID 作为 SSO 提供商，并采用 Open ID Connect (OIDC) 协议作为首选身份验证协议。

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

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

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

导航至 Microsoft Entra ID 管理中心，然后单击“企业应用程序”

您将被重定向到该页面。然后，点击顶部的“新建应用”和“创建您的专属应用”。

输入您的应用程序名称（例如，Hugging Face SSO），然后选择“注册应用程序以与 Microsoft Entra ID 集成（您正在开发的应用程序）”。

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

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

从 Hugging Face 上的组织设置中复制“Redirection URI”，并将其粘贴到 Azure Entra ID 的“Redirect URI”字段中。请确保在下拉菜单中选择“Web”。 该 URL 的格式如下：https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume。

保存您的新应用程序。

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

我们需要收集以下信息以完成 Hugging Face 上的设置：

• OIDC 应用的 Client ID
• OIDC 应用的客户端密钥
• OIDC 应用的 Issuer URL

在 Microsoft Entra ID 中，导航到 Enterprise applications，然后在列表中单击您新创建的应用程序。

在应用概览中，点击“单点登录”，然后选择“前往应用”

在 OIDC 应用概览中，您会找到一个名为“Application (client) ID”的可复制字段。 将该 ID 复制到剪贴板，然后粘贴到 Hugging Face 上的“Client ID”字段中。

接下来，在 Microsoft Entra 的顶部菜单中点击“Endpoints”。 复制“OpenID connect metadata document”字段中的值，并将其粘贴到 Hugging Face 的“Issue URL”字段中。

返回 Microsoft Entra，导航至“证书和机密”，然后单击“新的客户端机密”以生成新的机密。

创建密钥后，复制密钥值并将其粘贴到 Hugging Face 的“Client secret”字段中。

现在您可以点击“Update and Test OIDC configuration”来保存设置。

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

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

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

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

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

Update on GitHub