# GitHub 登录

# 前置条件

开始之前,确保你有一个 GitHub 开发者账号 (opens new window)

# 步骤

连接 GitHub 社会化登录,你需要:

# 创建 GitHub OAuth 应用

请按照 GitHub 文档 (opens new window)指引创建一个 GitHub OAuth 应用,你需要记录下该应用的 Client IDClient Secret,后面需要用到。

创建应用过程中,请使用以下设置:

Field
Authorization callback URL https://core.authing.cn/connection/social/github/<YOUR_USERPOOL_ID>/callback

将其中的 <YOUR_USERPOOL_ID> 替换为你的用户池 ID。

# 在 Authing 控制台配置 GitHub 社会化登录应用

在 Authing 控制台(连接身份源 - 社会化登录)找到 GitHub 应用,填入 GitHub OAuth 应用的配置:

  • Client ID
  • Client Secret
  • Callback URL这是你的业务回调域名,和社会化登录应用配置的回调链接不一样。比如你的网站域名是 https://example.com , 处理 Authing 回调请求的 url 为 /auth/callback , 那么你应该填写为 https://example.com/auth/callback。如果你需要在应用中单独配置回调链接,此处地址可填入: #。
  • Scopes(可选): 默认情况下,Authing 只会向用户申请基础用户信息(如头像、昵称、邮箱等)的授权,如果你需要更多高级权限,可以勾选上对应的选项。详细说明请见配置登录授权 Scopes

配置完成后请点击「确定」保存信息。

# 接下来

配置完成之后,接下来你可以开始正式将社会化登录集成到你的系统了,Authing 社会化登录共支持四种接入方式:使用 JavaScrit SDK、使用 Guard for Web 登录表单组件、 使用 Authing 在线登录页面 和 手动调用社会化登录接口,关于每种方式的适用场景和优劣势对比,请见:社会化登录接入指南