Skip to content

halo-sigs/plugin-oauth2

Repository files navigation

plugin-oauth2

Halo 2.0 的 OAuth2 第三方登录插件。

使用方法

  1. Releases 下载最新的 JAR 文件。
  2. 在 Halo 后台的插件管理上传 JAR 文件进行安装。
  3. 进入 Console 端的用户管理,点击右上角的 认证方式 按钮进入认证方式管理列表即可看到当前插件提供的认证方式。
  4. 按照下方的配置指南配置所需的认证方式并启用。
  5. 进入当前登录用户的个人资料页面,即可绑定已启用的认证方式。

配置指南

目前支持的认证方式:

服务商 文档 Halo 所需配置 Scope 回调地址
GitHub https://docs.github.com Client ID Client Secret 无需手动设置 <SITE_URL>/login/oauth2/code/github
GitLab https://docs.gitlab.com Client ID Client Secret read_user <SITE_URL>/login/oauth2/code/gitlab
Gitee https://gitee.com/oauth/applications Client ID Client Secret user_info <SITE_URL>/login/oauth2/code/gitee

注意事项:

  1. 如果认证失败,回调地址请使用 http 尝试。
  2. <SITE_URL> 是不包含 console 的。
  3. 如果你用于部署的服务器无法访问 GitHub,那 GitHub 认证会失败,其它同理,请先确认连通性。

开发环境

插件开发的详细文档请查阅:https://docs.halo.run/developer-guide/plugin/hello-world

git clone git@github.com:halo-sigs/plugin-oauth2.git

# 或者当你 fork 之后

git clone git@github.com:{your_github_id}/plugin-oauth2.git
cd path/to/plugin-oauth2
# macOS / Linux
./gradlew build

# Windows
./gradlew.bat build

修改 Halo 配置文件:

halo:
  plugin:
    runtime-mode: development
    fixedPluginPath:
      - "/path/to/plugin-oauth2"