在当今数字化时代，用户认证的便捷性和安全性愈发重要。对于使用 Halo 搭建个人博客或网站的开发者而言，引入 GitHub - OAuth2 认证能够极大地提升用户登录体验。今天，我们就来详细探讨一下如何在 Halo 中设置 GitHub - OAuth2 认证。

一、为什么选择 GitHub - OAuth2 认证

1. 便捷性：用户无需再单独注册账号和设置密码，只需使用已有的 GitHub 账号即可快速登录。这大大简化了注册和登录流程，减少了用户因繁琐注册步骤而流失的可能性。
2. 安全性高：GitHub 作为全球知名的代码托管平台，拥有成熟且严格的安全体系。通过 OAuth2 协议进行认证，能有效保障用户信息的安全传输，降低账号被盗用等风险。

二、准备工作

1.拥有一个 Halo 站点：确保你的 Halo 已经成功安装并可以正常访问。如果还未安装 Halo，可以参考安装文档进行安装。

2.GitHub 账号：你需要有一个 GitHub 账号，并且具备在 GitHub 上创建 OAuth 应用的权限。

三、在 GitHub 上创建 OAuth 应用

1.登录你的 GitHub 账号，点击右上角头像，选择 “Settings”。

2.在左侧菜单中选择 “Developer settings”。

3.点击 “OAuth Apps”，然后点击 “New OAuth App”。

4.填写应用信息：

• Application name：为你的应用取一个有意义的名称，例如 “君主阁”。
• Homepage URL：填写你的 Halo 站点的首页地址。
• Authorization callback URL：这是 GitHub 认证成功后回调的地址，格式为https://你的Halo站点地址/login/oauth2/code/github。例如，如果你的 Halo 站点地址是https://gfjzz.cn，则该字段应填写https://gfjzz.cn/login/oauth2/code/github。

5.填写完毕后，点击 “Register application”。

6.注册成功后，你将看到生成的 “Client ID” 和 “Client Secret”，这两个值非常重要，后续在 Halo 中配置时会用到，务必妥善保管。

四、在 Halo 中配置 GitHub - OAuth2 认证

1.登录到你的 Halo 管理后台。

2.在左侧菜单中选择 “插件 - “安装”。

3.在应用市场里面找到一个名为"OAuth2 认证"的插件并安装

4.返回管理后台，选择“用户”

5.点击“身份认证”按钮

6.启用GitHub认证方式，并点击设置按钮，进入配置页面

7.在配置页面中，点击“设置”，填写在 GitHub 上获取的 “Client ID” 和 “Client Secret”。

8.点击 “保存”。

五、测试认证功能

1. 退出 Halo 管理后台和你的 GitHub 账号（确保测试环境干净）。
2. 访问你的 Halo 站点，在登录页面应该能看到 “GitHub 登录” 按钮。
3. 点击 “GitHub 登录” 按钮，此时会跳转到 GitHub 的认证页面。
4. 输入你的 GitHub 账号和密码进行登录认证。
5. 认证成功后，你将被自动重定向回 Halo 站点，并以 GitHub 账号成功登录。

通过以上步骤，你已经成功在 Halo 中设置了 GitHub - OAuth2 认证。这不仅提升了用户体验，还增强了站点的安全性。赶紧让你的用户体验便捷高效的 GitHub 登录方式吧！