Hub 文档
使用 Hugging Face 登录
加入 Hugging Face 社区
并获得增强的文档体验
开始使用
使用 Hugging Face 登录
您可以使用 HF OAuth / OpenID 连接流程在任何网站或应用程序中创建“使用 HF 登录”流程。
这将允许用户通过单击类似于此按钮的按钮,使用他们的 HF 帐户登录您的网站或应用程序
单击此按钮后,您的用户将看到一个权限模态框,以授权您的应用程序
创建 OAuth 应用
您可以在您的设置中创建您的应用程序
如果您在 Spaces 中托管
如果您在 Spaces 上托管您的应用程序,那么流程将更容易实现(并且直接内置于 Gradio 中);请查看我们的 Spaces OAuth 指南。
当前支持的 scopes
当前支持的 scopes 包括
openid
:除了访问令牌外,还获取 ID 令牌。profile
:获取用户的个人资料信息(用户名、头像等)email
:获取用户的电子邮件地址。read-billing
:了解用户是否设置了付款方式。read-repos
:获取用户个人仓库的读取权限。write-repos
:获取用户个人仓库的写入/读取权限。manage-repos
:获取用户个人仓库的完全访问权限。还授予仓库创建和删除权限。inference-api
:访问 Inference API,您将能够代表用户发出推理请求。write-discussions
:代表用户发起讨论和拉取请求,以及与讨论互动(包括回复、发布/编辑评论、关闭讨论等)。要在私有仓库上打开拉取请求,您还需要请求read-repos
scope。
所有其他信息都可以在 OpenID 元数据中找到。
如果您需要任何额外的 scopes,请联系我们。
访问组织资源
默认情况下,oauth 应用不需要访问组织资源。
但是某些 scopes(如 read-repos 或 read-billing)也适用于组织。
用户可以在授权应用时选择要授予访问权限的组织。如果您需要访问特定组织,您可以将 orgIds=ORG_ID
作为查询参数添加到 OAuth 授权 URL。您必须将 ORG_ID
替换为组织 ID,该 ID 在 userinfo 响应的 organizations.sub
字段中可用。
品牌
您可以自由使用您自己的按钮设计。下面提供了一些有用的 SVG 图像。
查看我们的徽章,其中包含在 markdown 或 HTML 中集成它们的说明。
< > 更新 在 GitHub 上