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