hhy5277 / justauth

:100: 史上最全的整合第三方登录的工具,目前已支持Github、Gitee、微博、钉钉、百度、Coding、腾讯云开发者平台、OSChina、支付宝、QQ、微信、淘宝、Google、Facebook、抖音、领英、小米、微软和今日头条等第三方平台的授权登录。 Login, so easy!

Login, so easy.

---

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

项目开源地址：gitee | github

特点

废话不多说，就俩字：

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

快速开始

• 引入依赖

<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>1.8.0</version>
</dependency>

• 调用api

// 创建授权request
AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
        .clientId("clientId")
        .clientSecret("clientSecret")
        .redirectUri("redirectUri")
        .state("state")
        .build());
// 生成授权页面
authRequest.authorize();
// 授权登录后会返回code（auth_code（仅限支付宝））、state，1.8.0版本后，可以用AuthCallback类作为回调接口的参数
authRequest.login(callback);

注：1.8.0版本后，增加了state参数校验，用于防止CSRF。强烈建议，保证单次流程内state的唯一性，且每个state只可用一次。

配套Demo：JustAuth-demo

具体的例子可以参考：

• 实现Gitee授权登录
• 实现Github授权登录

API列表

💻 平台	☕ API类	📄 SDK
	AuthGiteeRequest	参考文档
	AuthGithubRequest	参考文档
	AuthWeiboRequest	参考文档
	AuthDingTalkRequest	参考文档
	AuthBaiduRequest	参考文档
	AuthCodingRequest	参考文档
	AuthTencentCloudRequest	参考文档
	AuthOschinaRequest	参考文档
	AuthAlipayRequest	参考文档
	AuthQqRequest	参考文档
	AuthWeChatRequest	参考文档
	AuthTaobaoRequest	参考文档
	AuthGoogleRequest	参考文档
	AuthFacebookRequest	参考文档
	AuthDouyinRequest	参考文档
	AuthLinkedinRequest	参考文档
	AuthMicrosoftRequest	参考文档
	AuthMiRequest	参考文档
	AuthToutiaoRequest	参考文档
	AuthCsdnRequest	无

请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经下线。如果以前申请过的应用，可以继续使用，但是不再支持申请新的应用。so, 本项目中的CSDN登录只能针对少部分用户使用了

后续开发计划

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

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

贡献代码

1. fork本项目到自己的repo
2. 把fork过去的项目也就是你仓库中的项目clone到你的本地
3. 修改代码
4. commit后push到自己的库
5. 发起PR（pull request） 请求
6. 等待作者合并

致谢

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

YurunOAuthLogin: PHP 第三方登录授权 SDK

阿里妈妈MUX倾力打造的矢量图标库-iconfont: 本文档中的图标大部分取自该平台

关于OAuth

The OAuth 2.0 Authorization Framework

关注&交流

公众号	微信(备注:加群)

QQ群

• JustAuth交流群 （230017570）：专业交流该项目

• 开源总群 （190886500）：各个开源项目的都有，也有博客建设等方面的朋友。（注意，该群需付费进入，防止发垃圾广告、垃圾推广等人士）

请喝咖啡

支付宝	微信