基本 SSO

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

基础 SSO 在标准的 Hugging Face 登录之上增加了一层访问控制。它允许你在成员访问组织命名空间下的资源（例如私有模型、数据集和 Spaces）时，强制通过你的身份提供商（IdP）进行身份验证。

如需与 Managed SSO 进行比较，请参阅 SSO 概述。

工作原理

基础 SSO 不会替代 Hugging Face 登录。您的成员仍需使用自己的凭据（邮箱/密码、Google 或 GitHub）登录 Hugging Face，之后才会被提示完成 SSO 认证以访问您组织的资源。这是有意为之的设计：基础 SSO 旨在保护您组织的访问权限，而不会接管用户的 Hugging Face 身份。

启用单点登录时，组织成员将通过您的身份提供商（IdP）进行身份验证。您可以选择 SSO 是强制还是可选：

• 强制（默认）：成员必须完成 SSO 身份验证，才能访问组织命名空间下的任何内容。
• 可选：成员会在页面顶部看到一个横幅，提示他们设置 SSO，但他们可以跳过该步骤并继续访问组织。这在迁移大量用户时非常有用，因为它可以给他们一些时间来整理自己的账户，之后再强制实施 SSO。

公开内容仍然对所有人可见，包括非成员。

我们使用电子邮件地址来识别 SSO 用户。作为用户，请确保您的组织电子邮件地址（例如公司邮箱）已添加到您的用户账户中。

用户登录时，系统会提示其完成单点登录身份验证流程，并显示类似以下内容的横幅：

单点登录仅适用于您的组织。成员可能同时属于 Hugging Face 上的其他组织。

入门

基本 SSO 可以直接在您的组织设置中进行配置。Hugging Face Hub 支持任何符合 OIDC 或 SAML 标准的身份提供商，包括 Okta、OneLogin 和 Microsoft Entra ID (Azure AD)。

请参阅我们的配置指南，了解逐步设置说明。

用户配置

在您的组织启用 SSO 后，可以直接复制加入链接并与新成员共享。此 SSO 加入链接可在 SSO 和 Members 设置选项卡中找到。由于启用了 SSO 的组织无法使用经典邀请链接，SSO 加入链接是邀请团队成员加入您组织的主要方式。只需点击复制按钮，即可将链接复制到剪贴板，并将其共享给您要邀请的成员。当接收者点击共享链接时，他们将通过 SSO 进行身份验证并直接加入您的组织。

使用企业版套餐的组织还可以使用 SCIM 来自动化基于邀请的来自您的身份提供商的预配。有关更多详细信息，请参阅 SCIM 指南。

SSO 功能

基本 SSO 支持角色映射、资源组映射、会话超时、匹配电子邮件域名以及外部协作者。这些功能可在您的组织设置中进行配置。

Update on GitHub