JustAuth/docs

Login, so easy!

史上最全的整合第三方登录的开源库

开源地址： Gitee | Github

QQ群：230017570

文档更新日期： {docsify-updated}

简介

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

特点

废话不多说，就俩字：

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

项目关注度趋势

已集成的平台

💻 平台	☕ API类	📄 SDK
	AuthGiteeRequest	参考文档
	AuthGithubRequest	参考文档
	AuthWeiboRequest	参考文档
	AuthDingTalkRequest	参考文档
	AuthBaiduRequest	参考文档
	AuthCodingRequest	参考文档
	AuthTencentCloudRequest	参考文档
	AuthOschinaRequest	参考文档
	AuthAlipayRequest	参考文档
	AuthQqRequest	参考文档
	AuthWeChatRequest	参考文档
	AuthTaobaoRequest	参考文档
	AuthGoogleRequest	参考文档
	AuthFacebookRequest	参考文档
	AuthDouyinRequest	参考文档
	AuthLinkedinRequest	参考文档
	AuthMicrosoftRequest	参考文档
	AuthMiRequest	参考文档
	AuthToutiaoRequest	参考文档
	AuthTeambitionRequest	参考文档
	AuthRenrenRequest	参考文档
	AuthPinterestRequest	参考文档
	AuthStackOverflowRequest	参考文档
	AuthHuaweiRequest	参考文档
	AuthWeChatEnterpriseRequest	参考文档
	AuthKujialeRequest	参考文档
	AuthGitlabRequest	参考文档
	AuthMeituanRequest	参考文档
	AuthElemeRequest	参考文档
	AuthTwitterRequest	参考文档
	AuthCsdnRequest	无

快速开始

• 引入依赖

<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>${latest.version}</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);

参与&贡献

JustAuth的发展离不开朋友们的支持，时至今日，JustAuth已渐趋完善，但仍有很大的改善空间。欢迎各位朋友为JustAuth贡献一份力量。

提供bug或建议

• Gitee
• Github

如果你正在使用JustAuth，可以在这儿留下你的足迹，获得优先推送、曝光

• Gitee
• Github

贡献代码的步骤

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

注意事项

1. JustAuth只接受集成OAuth2.0的平台
2. 建议安装“阿里编码规约”插件，然后进行开发
3. 提交PR前请格式化好自己的代码
4. 注释规范，自定义的方法一定要加上：方法说明、参数说明、返回值说明等

功能尝鲜

JustAuth一共有两个主要分支：

• 线上版分支（master）：稳定版，发布版就是这个分支的代码
• 开发版分支（dev）：不保证稳定，新功能都会优先推送到该分支，对于想尝鲜的朋友，可以直接下载代码，然后源码编译dev分支

开源推荐

• 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

捐赠

支付宝	微信