大家好，我是 Java陈序员。
我们在企业开发中，常常需要实现登录功能，而有时候为了方便，就需要集成第三方平台的授权登录。如常见的微信登录、微博登录等，免去了用户注册步骤，提高了用户体验。
为了业务考虑，我们有时候集成的不仅仅是一两个第三方平台，甚至更多。这就会大大的提高了工作量，那么有没有开源框架来统一来集成这些第三方授权登录呢？
答案是有的，今天给大家介绍的项目提供了一个第三方授权登录的工具类库！
项目介绍
JustAuth —— 一个第三方授权登录的工具类库，可以让你脱离繁琐的第三方登录 SDK，让登录变得So easy!
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 客户端，即代表意图访问受限资源的第三方应用
授权流程
使用步骤
1、申请注册第三方平台的开发者账号
2、创建第三方平台的应用，获取配置信息(accessKey, secretKey, redirectUri)
3、使用 JustAuth 实现授权登陆
引入依赖
- <dependency>
- <groupId>me.zhyd.oauth</groupId>
- <artifactId>JustAuth</artifactId>
- <version>{latest-version}</version>
- </dependency>
- // 创建授权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
- 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());
引入依赖- <dependency>
- <groupId>com.xkcoding.justauth</groupId>
- <artifactId>justauth-spring-boot-starter</artifactId>
- <version>1.4.0</version>
- </dependency>
- @Slf4j
- @RestController
- @RequestMapping("/oauth")
- @RequiredArgsConstructor(onConstructor_ = @Autowired)
- public class TestController {
- private final AuthRequestFactory factory;
- @GetMapping
- public List<String> 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
推荐的开源项目已经收录到 GitHub 项目，欢迎 Star：- https://github.com/chenyl8848/great-open-source-project
- https://chencoding.top:8090/#/
大家的点赞、收藏和评论都是对作者的支持，如文章对你有帮助还请点赞转发支持下，谢谢！
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！ |
