大家好，我是 `Java陈序员`。我们在企业开发中，常常需要实现登录功能，而有时候为了方便，就需要集成第三方平台的授权登录。如常见的微信登录、微博登录等，免去了用户注册步骤，提高了用户体验。为了业务考虑，我们有时候集成的不仅仅是一两个第三方平台，甚至更多。这就会大大的提高了工作量，那么有没有开源框架来统一来集成这些第三方授权登录呢？答案是有的，今天给大家介绍的项目提供了一个第三方授权登录的**工具类库**！ ## 项目介绍 `JustAuth` —— 一个第三方授权登录的工具类库，可以让你脱离繁琐的第三方登录 SDK，让登录变得So easy! ![JustAuth](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/f60eff81635a410f88aa70c5842aefeb~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=1303\&h=1057\&s=179729\&e=png\&b=ffffff) `JustAuth` 集成了诸如：Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软、今日头条、Teambition、StackOverflow、Pinterest、人人、华为、企业微信、酷家乐、Gitlab、美团、饿了么、推特、飞书、京东、阿里云、喜马拉雅、Amazon、Slack和 Line 等第三方平台的授权登录。功能特色： * 丰富的 OAuth 平台：支持国内外数十家知名的第三方平台的 OAuth 登录。 * 自定义 state：支持自定义 State 和缓存方式，开发者可根据实际情况选择任意缓存插件。 * 自定义 OAuth：提供统一接口，支持接入任意 OAuth 网站，快速实现 OAuth 登录功能。 * 自定义 Http：接口 HTTP 工具，开发者可以根据自己项目的实际情况选择相对应的HTTP工具。 * 自定义 Scope：支持自定义 scope，以适配更多的业务场景，而不仅仅是为了登录。 * 代码规范·简单：JustAuth 代码严格遵守阿里巴巴编码规约，结构清晰、逻辑简单。 ## 安装使用 #### 回顾 OAuth 授权流程 **参与的角色** * `Resource Owner` 资源所有者，即代表授权客户端访问本身资源信息的用户（User），也就是应用场景中的“开发者A” * `Resource Server` 资源服务器，托管受保护的用户账号信息，比如 Github Authorization Server 授权服务器，验证用户身份然后为客户端派发资源访问令牌，比如 Github * `Resource Server` 和 `Authorization Server` 可以是同一台服务器，也可以是不同的服务器，视具体的授权平台而有所差异 * `Client` 客户端，即代表意图访问受限资源的第三方应用 **授权流程** ![OAuth 授权流程](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/cd4cfe7c68914cec9e935a7d2b0cb044~tplv-k3u1fbpfcp-jj-mark:0:0:0:0:q75.image#?w=811\&h=582\&s=53292\&e=png\&b=f6f6f6) ### 使用步骤 1、申请注册第三方平台的开发者账号 2、创建第三方平台的应用，获取配置信息(accessKey, secretKey, redirectUri) 3、使用 `JustAuth` 实现授权登陆 ### 引入依赖 ```xml me.zhyd.oauth JustAuth {latest-version} ``` ### 调用 API ```java // 创建授权request AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder() .clientId("clientId") .clientSecret("clientSecret") .redirectUri("redirectUri") .build()); // 生成授权页面 authRequest.authorize("state"); // 授权登录后会返回code（auth_code（仅限支付宝））、state，1.8.0版本后，可以用AuthCallback类作为回调接口的参数 // 注：JustAuth默认保存state的时效为3分钟，3分钟内未使用则会自动清除过期的state authRequest.login(callback); ``` > 说明： > `JustAuth` 的核心就是一个个的 request，每个平台都对应一个具体的 request 类。 > 所以在使用之前，需要就具体的授权平台创建响应的 request.如示例代码中对应的是 Gitee 平台。 ### 集成国外平台 > 国外平台需要额外配置 `httpConfig` ```java AuthRequest authRequest = new AuthGoogleRequest(AuthConfig.builder() .clientId("Client ID") .clientSecret("Client Secret") .redirectUri("应用回调地址") // 针对国外平台配置代理 .httpConfig(HttpConfig.builder() // Http 请求超时时间 .timeout(15000) // host 和 port 请修改为开发环境的参数 .proxy(new Proxy(Proxy.Type.HTTP, new InetSocketAddress("127.0.0.1", 10080))) .build()) .build()); ``` ### SpringBoot 集成 **引入依赖** ```xml com.xkcoding.justauth justauth-spring-boot-starter 1.4.0 ``` **配置文件** ```yaml justauth: enabled: true type: QQ: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/qq/callback union-id: false WEIBO: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/weibo/callback GITEE: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/gitee/callback DINGTALK: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/dingtalk/callback BAIDU: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/baidu/callback CSDN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/csdn/callback CODING: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/coding/callback coding-group-name: xx OSCHINA: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/oschina/callback ALIPAY: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/alipay/callback alipay-public-key: MIIB**************DAQAB WECHAT_OPEN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_open/callback WECHAT_MP: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_mp/callback WECHAT_ENTERPRISE: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_enterprise/callback agent-id: 1000002 TAOBAO: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/taobao/callback GOOGLE: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/google/callback FACEBOOK: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/facebook/callback DOUYIN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/douyin/callback LINKEDIN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/linkedin/callback MICROSOFT: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/microsoft/callback MI: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/mi/callback TOUTIAO: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/toutiao/callback TEAMBITION: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/teambition/callback RENREN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/renren/callback PINTEREST: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/pinterest/callback STACK_OVERFLOW: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/stack_overflow/callback stack-overflow-key: asd*********asd HUAWEI: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/huawei/callback KUJIALE: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/kujiale/callback GITLAB: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/gitlab/callback MEITUAN: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/meituan/callback ELEME: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/eleme/callback TWITTER: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/twitter/callback XMLY: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/xmly/callback # 设备唯一标识ID device-id: xxxxxxxxxxxxxx # 客户端操作系统类型，1-iOS系统，2-Android系统，3-Web client-os-type: 3 # 客户端包名，如果 clientOsType 为1或2时必填。对Android客户端是包名，对IOS客户端是Bundle ID #pack-id: xxxx FEISHU: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/feishu/callback JD: client-id: 10**********6 client-secret: 1f7d08**********5b7**********29e redirect-uri: http://oauth.xkcoding.com/demo/oauth/jd/callback cache: type: default ``` **代码使用** ```java @Slf4j @RestController @RequestMapping("/oauth") @RequiredArgsConstructor(onConstructor_ = @Autowired) public class TestController { private final AuthRequestFactory factory; @GetMapping public List list() { return factory.oauthList(); } @GetMapping("/login/{type}") public void login(@PathVariable String type, HttpServletResponse response) throws IOException { AuthRequest authRequest = factory.get(type); response.sendRedirect(authRequest.authorize(AuthStateUtils.createState())); } @RequestMapping("/{type}/callback") public AuthResponse login(@PathVariable String type, AuthCallback callback) { AuthRequest authRequest = factory.get(type); AuthResponse response = authRequest.login(callback); log.info("【response】= {}", JSONUtil.toJsonStr(response)); return response; } } ``` ## 总结 `JustAuth` 集成的第三方授权登录平台，可以说是囊括了业界中大部分主流的应用系统。如国内的微信、微博、Gitee 等，还有国外的 Github、Google 等。可以满足我们日常的开发需求，开箱即用，可快速集成！最后，贴上项目地址： https://github.com/justauth/JustAuth 在线文档： https://www.justauth.cn/ ## 最后推荐的开源项目已经收录到 `GitHub` 项目，欢迎 `Star`： https://github.com/chenyl8848/great-open-source-project 或者访问网站，进行在线浏览： https://chencoding.top:8090/#/ > 大家的点赞、收藏和评论都是对作者的支持，如文章对你有帮助还请点赞转发支持下，谢谢！