如何配置 Okta 的 SAML SSO

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

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

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

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

在浏览器中打开一个新标签页/窗口，并登录您的 Okta 账户。

导航至“Admin/Applications”，然后单击“Create App Integration”按钮。

然后选择一个“SAML 2.0”应用程序并点击“创建”。

步骤 2：在 Okta 上配置您的应用程序

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

从 Hugging Face 的组织设置中复制“Assertion Consumer Service URL”，并将其粘贴到 Okta 的“Single sign-on URL”字段中。 该 URL 的格式如下：https://huggingface.co/organizations/[organizationIdentifier]/saml/consume。

在 Okta 上，设置以下配置：

• 将受众 URI（SP Entity Id）设置为与 Hugging Face 上的“SP Entity ID”值相匹配。
• 将名称 ID 格式设置为Unspecified。
• 将 Application username 设置为 Custom，表达式为 user.getInternalProperty("id")。
• 在“属性声明”下，添加 http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress，其值为 user.email。
• 在“显示高级设置”下，确认 Response 和 Assertion Signature 已设置为：Signed。

保存您的新应用程序。

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

在您的 Okta 应用程序中，在“Sign On/Settings/More details”下，找到以下字段：

• 登录 URL
• 公共证书
• SP 实体 ID 您需要在 Hugging Face 上完成 SSO 设置时使用它们。

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

• 登录 URL
• SP 实体 ID
• 公共证书

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

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

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

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

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

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

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

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