开源三方授权登录工具库JustAuth

易道合之逍遥峰

于 2024-08-27 14:06:19 发布

阅读量1.4k

点赞数 39

文章标签：开源快捷登录三方登录

本文链接：https://blog.csdn.net/mopmgerg54mo/article/details/141601327

版权

JustAuth是一个开源的Java第三方登录集成工具类库，它可以帮助开发者快速集成第三方登录功能，极大地简化了开发流程，提高了开发效率。

以下是关于JustAuth的详细介绍：

一、概述

定义：JustAuth是一个集成了国内外数十家第三方平台的登录认证工具库，支持OAuth2等授权模式。
目的：让开发者脱离繁琐的第三方登录SDK，使登录变得简单。
开源平台：JustAuth在GitHub和Gitee上均有开源，项目地址分别为GitHub和Gitee。

二、特点

全面性：已集成国内外数十家常用第三方平台，如Github、Gitee、微信、QQ、微博、Google、Facebook、Twitter等，且仍在持续扩展中。
简洁性：API设计简洁，上手容易，尽量让开发者使用起来没有障碍感。
灵活性：
- 支持自定义State缓存，可以适配各种分布式缓存组件。
- 支持自定义OAuth平台，更容易适配自有的OAuth服务。
- 支持自定义HTTP实现，不会单独依赖某一具体实现。
- 支持自定义Scope，支持更完善的授权体系。

三、支持的平台

JustAuth支持的平台包括但不限于：

国内平台：Github、Gitee、支付宝、新浪微博、微信、QQ、钉钉、百度、Coding、腾讯云、OSChina、淘宝等。
国际平台：Google、Facebook、Twitter、LinkedIn、StackOverflow、Pinterest、YouTube、Microsoft等。

四、使用流程

使用JustAuth实现第三方登录的大致流程如下：

前期准备：
- 在需要接入的第三方平台上注册应用，获取Client ID和Client Secret。
- 配置应用的回调地址（Redirect URI）。
开发准备：
- 在Java项目中引入JustAuth的依赖。
```
<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>${latest.version}</version>
</dependency>
```
- 配置项目中的application.yml或application.properties文件，设置JustAuth的相关参数。
编写代码：
- 创建授权请求实例，配置Client ID、Client Secret和Redirect URI等参数。
- 调用授权请求实例的authorize方法，获取授权链接，并重定向用户到第三方平台的授权页面。
- 在回调接口中处理授权响应，获取访问令牌（Access Token）和用户信息。
- 使用访问令牌向第三方平台请求用户信息（如用户ID、头像、昵称等）。
- 使用用户信息创建或更新本地用户账号，完成用户登录。

以钉钉登录集成为例：

》首先在钉钉开发者中心创建要集成的应用：

》然后编写钉钉登录和回调函数的代码：

@RestController
@RequestMapping("/oauth")
public class RestAuthController {

    @RequestMapping("/render")
    public void renderAuth(HttpServletResponse response) throws IOException {
        AuthRequest authRequest = getAuthRequest();
        response.sendRedirect(authRequest.authorize(AuthStateUtils.createState()));
    }

    @RequestMapping("/callback")
    public Object login(AuthCallback callback) {
        AuthRequest authRequest = getAuthRequest();
        return authRequest.login(callback);
    }

    private AuthRequest getAuthRequest() {
        return new AuthDingTalkRequest(AuthConfig.builder()
                .clientId("API Key")
                .clientSecret("Secret Key")
                .redirectUri("应用回调地址")
                .build());
    }
}

》登录授权成功后返回的信息如下：

{
    "code":2000,
    "data":{
        "gender":"UNKNOWN",
        "nickname":"码上行动",
        "rawUserInfo":{
            "nick":"码上行动",
            "unionid":"4FiSzxIAgiEiE",
            "dingId":"$:LWCP_xYfqxZ3z99w==",
            "openid":"hHkfeC0xxfLr85zQiEiE",
            "main_org_auth_high_level":false
        },
        "source":"DINGTALK",
        "token":{
            "expireIn":0,
            "openId":"hHkfeC0XNixr85zQiEiE",
            "unionId":"4FiSzv7YnxIE5IAgiEiE"
        },
        "username":"码上行动",
        "uuid":"4FiSzv7YnxIE5IAgiEiE"
    }
}