OAuth2 认证

OAuth2 认证

21,245
6,801

提供 OAuth2 认证方式

下载

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索OAuth2 认证并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

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

开发环境

插件开发的详细文档请查阅: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"

安装到 Halo

方式一

如果安装了应用市场插件,可以直接在应用市场中搜索OAuth2 认证并安装。

方式二

输入你的 Halo 站点地址,点击安装之后会重定向到你 Halo 后台并自动安装,Halo 的版本需要 >= 2.6.0。

方式三

点击手动下载,然后在 Console 上传。

这是一个开源应用,我们推荐优先在开源仓库中提交 issue,以便开发者更好地接收和跟进问题。

去提交 issue