JustAuth: A Java repository from xusisheng

Login, so easy.

JustAuth，如你所见，它仅仅是一个第三方授权登录的工具类库，它可以让我们脱离繁琐的第三方登录SDK，让登录变得So easy!

项目开源地址：gitee | github
项目文档：参考文档

特点

废话不多说，就俩字：

全：已集成十多家第三方平台（国内外常用的基本都已包含），仍然还在持续扩展中（开发计划）！
简：API就是奔着最简单去设计的（见后面快速开始），尽量让您用起来没有障碍感！

快速开始

引入依赖

<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>1.15.3-alpha</version>
</dependency>

调用api

// 创建授权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);

如下任选一种 HTTP 工具依赖，项目内如果已有，请忽略

hutool-http

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-http</artifactId>
    <version>5.2.5</version>
</dependency>

httpclient

<dependency>
	<groupId>org.apache.httpcomponents</groupId>
  	<artifactId>httpclient</artifactId>
  	<version>4.5.12</version>
</dependency>

okhttp

<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>4.4.1</version>
</dependency>

后续开发计划

参考：[开发计划] 待扩展的第三方平台

另外，期待您和我一起完善这个项目！

贡献代码

fork本项目到自己的repo
把fork过去的项目也就是你仓库中的项目clone到你的本地
修改代码
commit后push到自己的库
发起PR（pull request）请求，提交到dev分支
等待作者合并

贡献者名单

contributors

致谢

在项目立项初期，也对当前开源圈的一些相同类型的项目作过调研，同时本项目也参考过这些项目，再次感谢开源圈内的朋友。

YurunOAuthLogin: PHP 第三方登录授权 SDK
阿里妈妈MUX倾力打造的矢量图标库-iconfont: 本文档中的图标大部分取自该平台
mica：Spring Cloud 微服务开发核心包，支持 web 和 webflux。注：JustAuth项目中的UuidUtils就是直接使用的mica提供的高性能的uuid创建工具类源码StringUtil.java
感谢 JetBrains 提供的免费开源 License：

开源推荐

spring-boot-demo 深度学习并实战 spring boot 的项目: https://github.com/xkcoding/spring-boot-demo
mica SpringBoot 微服务高效开发工具集: https://github.com/lets-mica/mica
pig 宇宙最强微服务认证授权脚手架(架构师必备): https://gitee.com/log4j/pig
SpringBlade 完整的线上解决方案（企业开发必备）: https://gitee.com/smallc/SpringBlade
MaxKey 马克思的钥匙，寓意是最大钥匙,是用户单点登录认证系统（Sigle Sign On System）,OAuth 2.0/OpenID Connect、SAML 2.0、JWT、CAS等标准化的开放协议，使用JustAuth集成OAuth第三方认证。: https://shimingxy.github.io/MaxKey/