Hub documentation
如何配置 Google Workspace 的 OIDC SSO
单点登录(SSO) 审计日志 存储区域 用于私有数据集的 Data Studio 资源组(访问控制) 高级计算选项 高级安全 令牌管理 服务账号 发布者分析 门控组集合 网络安全 下载分析 速率限制 博客文章
PRO 计划 仓库 入门仓库 仓库设置 存储限制 存储后端(Xet) 本地缓存 Pull Requests 与 Discussions 通知 集合 Webhooks GitHub Actions Notebooks 后续步骤 许可证
模型 数据集 Spaces Spaces 概览 Spaces GPU 升级 Spaces ZeroGPU Spaces 开发模式 Spaces 磁盘使用量与存储 Spaces 自定义域名 Spaces 作为 MCP 服务器 Spaces 作为智能体工具 将 Spaces 用作 API 端点 Gradio Spaces Streamlit Spaces 静态 HTML Spaces Docker Spaces 嵌入您的 Space 使用 Docker 运行 Spaces Spaces 配置参考 使用 HF 登录按钮 精选 Spaces Spaces 更新日志 高级主题
存储桶 new 容器镜像 new 任务 智能体 智能体概述 Hugging Face AI 智能体 CLI Hugging Face MCP 服务器 Hugging Face Agent Skills 使用 HF SDK 构建智能体 使用 llama.cpp 的本地代理 Agent 库 会话跟踪格式
其他 如何配置 Google Workspace 的 OIDC SSO
在本指南中,我们将使用 Google Workspace 作为 SSO 提供商,并采用 OpenID Connect (OIDC) 协议作为首选的身份验证协议。
我们目前支持由服务提供商发起的身份验证。有关用户配置,请参阅 SCIM。
此功能属于 Team & Enterprise 计划的一部分。
步骤 1:在 Google Workspace 中创建 OIDC 应用
- 在您的 Google Cloud 控制台中,搜索并导航至
Google Auth Platform>Clients。 - 单击
Create Client。 - 对于 Application Type,请选择
Web Application。 - 为您的应用程序提供一个名称。
- 从您的 Hugging Face 组织设置中获取
Redirection URI,前往SSO选项卡并选择OIDC协议。 - 点击
Create。 - 将弹出一个窗口,显示
Client ID和Client Secret,请复制它们并粘贴到 Hugging Face 组织设置中。在SSO选项卡中(确保已选择OIDC),将Client Identifier和Client Secret对应的值粘贴到相应位置。

步骤 2:使用 Google 的 OIDC 详细信息配置 Hugging Face
- 此时,Client ID 和 Client Secret 应已在您的 Hugging Face 组织设置的
SSO选项卡中设置好。 - 将 Issuer URL 设置为
https://accounts.google.com。

步骤 3:测试并启用 SSO
在测试之前,请确保已为相应用户授予该应用程序的访问权限。执行测试的管理员必须拥有访问权限。
- 现在,在您的 Hugging Face SSO 设置中,点击 “更新并测试 OIDC 配置”。
- 您将被重定向到 Google 登录提示页面。登录成功后,您将被重定向到组织的设置页面。
- OIDC 选择器旁边的绿色对勾将确认测试成功。
- 测试成功后,您可以点击“启用”按钮为您的组织启用 SSO。
- 启用后,您组织的成员必须完成工作原理部分中描述的 SSO 身份验证流程。