使用 Hugging Face 登录

您可以使用 HF OAuth/OpenID Connect 流程在任何网站或应用中创建**“使用 HF 登录”**流程。

这将允许用户通过点击类似于此按钮的按钮，使用其 HF 帐户登录您的网站或应用。

点击此按钮后，您的用户将看到一个权限模态，以授权您的应用。

创建 OAuth 应用

您可以在您的设置中创建您的应用程序。

如果您在 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 在用户信息响应的organizations.sub字段中提供。

您可以自由使用您自己的按钮设计。下面提供了一些有帮助的 SVG 图像。

查看我们的徽章，其中包含在 Markdown 或 HTML 中集成它们的说明。