diff --git a/README.en-US.md b/README.en-US.md index 10034fb3fb47e3581de219512b5de5673feef59b..7c79882954b70813a93725b1e58fd9483988bf66 100644 --- a/README.en-US.md +++ b/README.en-US.md @@ -6,7 +6,7 @@

- + @@ -15,7 +15,7 @@ - + @@ -97,7 +97,7 @@ These artifacts are available from Maven Central: me.zhyd.oauth JustAuth - 1.15.0-alpha + 1.14.0 ``` - Using JustAuth @@ -115,6 +115,40 @@ authRequest.authorize("state"); authRequest.login(callback); ``` +Note, that since [v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0) JustAuth has been integrated by default with [simple-http](https://github.com/xkcoding/simple-http) as the HTTP general interface (see the update [JustAuth 1.14.0 release! Perfect decoupling of HTTP tools](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633197&idx=1&sn=11e625b307db62b2f1c4e82f7744b2a2&chksm=88929300bfe51a16562b45592a264482ae2c74c6dbfa4a3aa9611ad4fea4a9be5b1f0545527d&token=1093833287&lang=zh_CN#rd)). Since most projects already integrate HTTP tools such as OkHttp3, apache HttpClient, and hutool-http), in order to reduce unnecessary dependencies,Starting from [v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0), JustAuth will not integrate hutool-http by default. If the developer's project is new or there is no integrated HTTP implementation tool in the project, please add the corresponding HTTP implementation class by yourself. Alternative dependencies are as follows: + + +- hutool-http + + ```xml + + cn.hutool + hutool-http + 5.2.5 + + ``` + +- httpclient + + ```xml + + org.apache.httpcomponents + httpclient + 4.5.12 + + ``` + +- okhttp + + ```xml + + com.squareup.okhttp3 + okhttp + 4.4.1 + + ``` + + **Examples**： - [Springboot Example](https://github.com/justauth/JustAuth-demo) - [jFinal Example](https://github.com/xkcoding/jfinal-justauth-demo): by [xkcoding](https://github.com/xkcoding) diff --git a/README.md b/README.md index e8709e3df00fd9da6bec9d39ec7dbf5896be6e05..21030919700ae6e7fb242255c1b7b701422f977c 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@

- + @@ -15,7 +15,7 @@ - + @@ -73,10 +73,11 @@

查看更多
- ------------------------------------------------------------------------------- +

2020年4月10日（周五） 晚8点 直播间首秀《JustAuth 从开源到喜提「码云GVP」之路》

 + JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具类库**，它可以让我们脱离繁琐的第三方登录SDK，让登录变得**So easy!** @@ -97,7 +98,7 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具 me.zhyd.oauth JustAuth - 1.15.0-alpha + 1.14.0 ``` - 调用api @@ -115,7 +116,42 @@ authRequest.authorize("state"); authRequest.login(callback); ``` -**配套Demo**： +注意，JustAuth从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始默认集成了的[simple-http](https://github.com/xkcoding/simple-http)作为HTTP通用接口（更新说明见[JustAuth 1.14.0版本正式发布！完美解耦HTTP工具](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633197&idx=1&sn=11e625b307db62b2f1c4e82f7744b2a2&chksm=88929300bfe51a16562b45592a264482ae2c74c6dbfa4a3aa9611ad4fea4a9be5b1f0545527d&token=1093833287&lang=zh_CN#rd)），鉴于一般项目中都已经集成了HTTP工具，比如OkHttp3、apache HttpClient、hutool-http，因此为了减少不必要的依赖，从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始JustAuth将不会默认集成hutool-http，如果开发者的项目是全新的或者项目内没有集成HTTP实现工具，请自行添加对应的HTTP实现类，备选依赖如下： + +- hutool-http + + ```xml + + cn.hutool + hutool-http + 5.2.5 + + ``` + +- httpclient + + ```xml + + org.apache.httpcomponents + httpclient + 4.5.12 + + ``` + +- okhttp + + ```xml + + com.squareup.okhttp3 + okhttp + 4.4.1 + + ``` + + + +配套Demo**： + - [JustAuth-demo](https://github.com/justauth/JustAuth-demo) - [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo): Jfinal集成JustAuth的demo by [xkcoding](https://github.com/xkcoding) - [ActFramework版](https://github.com/xkcoding/act-justauth-demo): ActFramework 集成 JustAuth 的 demo by [xkcoding](https://github.com/xkcoding) diff --git a/bin/version.txt b/bin/version.txt index d547af924d3327d01277085a5e0158387998c522..850e742404bba0ccc0dde11877e9737d6fe8f479 100644 --- a/bin/version.txt +++ b/bin/version.txt @@ -1 +1 @@ -1.15.0-alpha +1.14.0 diff --git a/docs/README.md b/docs/README.md index 6a5dc0e713581b1c74e7d2983e1d28be5c8b5ce2..0388ef218508870089d9e937e971e321e5d6470d 100644 --- a/docs/README.md +++ b/docs/README.md @@ -9,7 +9,7 @@

- + @@ -18,7 +18,7 @@ - + @@ -58,69 +58,6 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具 [![Stargazers over time](https://starchart.cc/justauth/JustAuth.svg)](https://starchart.cc/justauth/JustAuth) -## 已集成的平台 - -| :computer: 平台 | :coffee: API类 | :page_facing_up: SDK | -|:------:|:-------:|:-------:| -| | [AuthGiteeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java) | 参考文档 | -| | [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGithubRequest.java) | 参考文档 | -| | [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeiboRequest.java) | 参考文档 | -| | [AuthDingTalkRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDingTalkRequest.java) | 参考文档 | -| | [AuthBaiduRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthBaiduRequest.java) | 参考文档 | -| | [AuthCodingRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCodingRequest.java) | 参考文档 | -| | [AuthTencentCloudRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTencentCloudRequest.java) | 参考文档 | -| | [AuthOschinaRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthOschinaRequest.java) | 参考文档 | -| | [AuthAlipayRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthAlipayRequest.java) | 参考文档 | -| | [AuthQqRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthQqRequest.java) | 参考文档 | -| | [AuthWeChatOpenRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatOpenRequest.java) | 参考文档 | -| | [AuthWeChatMpRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatMpRequest.java) | 参考文档 | -| | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | 参考文档 | -| | [AuthTaobaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTaobaoRequest.java) | 参考文档 | -| | [AuthGoogleRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGoogleRequest.java) | 参考文档 | -| | [AuthFacebookRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthFacebookRequest.java) | 参考文档 | -| | [AuthDouyinRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDouyinRequest.java) | 参考文档 | -| | [AuthLinkedinRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthLinkedinRequest.java) | 参考文档 | -| | [AuthMicrosoftRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMicrosoftRequest.java) | 参考文档 | -| | [AuthMiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMiRequest.java) | 参考文档 | -| | [AuthToutiaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthToutiaoRequest.java) | 参考文档 | -| | [AuthTeambitionRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTeambitionRequest.java) | 参考文档 | -| | [AuthRenrenRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthRenrenRequest.java) | 参考文档 | -| | [AuthPinterestRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthPinterestRequest.java) | 参考文档 | -| | [AuthStackOverflowRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthStackOverflowRequest.java) | 参考文档 | -| | [AuthHuaweiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthHuaweiRequest.java) | 参考文档 | -| | [AuthKujialeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthKujialeRequest.java) | 参考文档 | -| | [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java) | 参考文档 | -| | [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java) | 参考文档 | -| | [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java) | 参考文档 | -| | [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java) | 参考文档 | -| | [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java) | 无 | - - -## 快速开始 - -- 引入依赖 -```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的发展离不开朋友们的支持，时至今日，JustAuth已渐趋完善，但仍有很大的改善空间。欢迎各位朋友为JustAuth贡献一份力量。 diff --git a/docs/_404.md b/docs/_404.md index e5dcca72c8b6b304826d74654359830c3286a98c..50f699b452288232f773da8e74212fff52bbf01d 100644 --- a/docs/_404.md +++ b/docs/_404.md @@ -1,6 +1,8 @@ -**非常感谢您对JustAuth的关注**，您现在查询的内容，资料库中暂时没有，我们后续会补充上。 +# :alien: 404:alien: -您可能还会需要以下文档： +**非常感谢您对JustAuth的关注**，您现在查询的内容，作者正在补充中！ + +您可能对以下文章感兴趣： - [OAuth的授权流程是什么样的？](https://docs.justauth.whnb.wang/#/oauth) - [如何使用JustAuth？](https://docs.justauth.whnb.wang/#/how-to-use) @@ -12,11 +14,24 @@ - [如何自定义接入自己搭建的oauth平台？](https://docs.justauth.whnb.wang/#/customize-the-oauth) - [有哪些配套项目？](https://docs.justauth.whnb.wang/#/supporting) +### 想使用JustAuth集成第三方OAuth登录？ + +- [Gitee登录](oauth/gitee.md) +- [Github登录](oauth/github.md) +- [qq登录](oauth/qq.md) +- [微信开放平台登录](oauth/wechat_open.md) +- [微博登录](oauth/weibo.md) +- [支付宝登录](oauth/alipay.md) +- [酷家乐登录](oauth/kujiale.md) +- 更多文章，正在补充中... + + ### 如果还是没有您想要的内容，您可以： 1. (建议) 提Issue： 【[github](https://github.com/justauth/JustAuth/issues)】 | 【[gitee](https://gitee.com/yadong.zhang/JustAuth/issues)】 -2. 本页面底部直接留言 -3. 关注公众号（公众号会不定期推送相关内容），扫下方二维码关注公众号： +2. 点击本页面右下角【OPEN CHAT】开始在线聊天 +3. 本页面底部直接留言 +4. 关注公众号（公众号会不定期推送相关内容），扫下方二维码关注公众号： diff --git a/docs/_coverpage.md b/docs/_coverpage.md index 3850d2bcd78d03e628d2e06e4fdebccccc70d3fc..9614e6f4fb5851c53e4a213dbfbeae65571df070 100644 --- a/docs/_coverpage.md +++ b/docs/_coverpage.md @@ -1,8 +1,8 @@ ![](_media/justauth@0,25x.png) -# JustAuth 1.15.0-alpha +# JustAuth 1.14.0 -

2020年4月10日（周五） 晚8点 直播间首秀《JustAuth 从开源到喜提「码云GVP」之路》

+

2020年4月10日（周五） 晚8点 直播间首秀《JustAuth 从开源到喜提「码云GVP」之路》

 史上最全的整合第三方登录的开源库 diff --git a/docs/_media/extended/justauth_integrated_with_the_existing_account_system.png b/docs/_media/extended/justauth_integrated_with_the_existing_account_system.png new file mode 100644 index 0000000000000000000000000000000000000000..b257adb044becd6e214ec46be3171c834065d129 Binary files /dev/null and b/docs/_media/extended/justauth_integrated_with_the_existing_account_system.png differ diff --git a/docs/_media/justauth_live.png b/docs/_media/justauth_live.png new file mode 100644 index 0000000000000000000000000000000000000000..d769c46e8a48075ad3b27f9cf3742650c8953967 Binary files /dev/null and b/docs/_media/justauth_live.png differ diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 08a61b1be2b7ae0905eb4a2d0d7bf8e3a46d6cd7..31e0db02a8b74685cf18d7c0548de7551c36e3a1 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -10,10 +10,11 @@ - [√ Github登录](oauth/github.md) - [√ qq登录](oauth/qq.md) - [√ 微信开放平台登录](oauth/wechat_open.md) - - [微信企业版登录](oauth/wechatEnterprise.md) - - [微信公众平台登录](oauth/wechat_mp.md) - [√ 微博登录](oauth/weibo.md) - [√ 支付宝登录](oauth/alipay.md) + - [√ 酷家乐登录](oauth/kujiale.md) + - [微信企业版登录](oauth/wechatEnterprise.md) + - [微信公众平台登录](oauth/wechat_mp.md) - [百度登录](oauth/baidu.md) - [Coding登录](oauth/coding.md) - [钉钉登录](oauth/dingtalk.md) @@ -32,7 +33,6 @@ - [Pinterest登录](oauth/pinterest.md) - [Stackoverflow登录](oauth/stackoverflow.md) - [华为登录](oauth/huawei.md) - - [√ 酷家乐登录](oauth/kujiale.md) - [Gitlab登录](oauth/gitlab.md) - [美团登录](oauth/meituan.md) - [饿了么登录](oauth/eleme.md) @@ -43,8 +43,7 @@ - [自定义state缓存](customize-the-state-cache.md) - [自定义第三方平台的OAuth](customize-the-oauth.md) - 扩展内容 - - [与自有用户整合](extended/justauth_integrated_with_the_existing_account_system.md) -- [配套项目](supporting.md) + - [JustAuth与现有用户系统整合](extended/justauth_integrated_with_the_existing_account_system.md) - [Who is using](users.md) - [致谢](thx.md) - [更新记录](update.md) diff --git a/docs/oauth/baidu.md b/docs/back/baidu.md similarity index 100% rename from docs/oauth/baidu.md rename to docs/back/baidu.md diff --git a/docs/oauth/coding.md b/docs/back/coding.md similarity index 100% rename from docs/oauth/coding.md rename to docs/back/coding.md diff --git a/docs/oauth/csdn.md b/docs/back/csdn.md similarity index 100% rename from docs/oauth/csdn.md rename to docs/back/csdn.md diff --git a/docs/oauth/dingtalk.md b/docs/back/dingtalk.md similarity index 100% rename from docs/oauth/dingtalk.md rename to docs/back/dingtalk.md diff --git a/docs/oauth/douyin.md b/docs/back/douyin.md similarity index 100% rename from docs/oauth/douyin.md rename to docs/back/douyin.md diff --git a/docs/oauth/eleme.md b/docs/back/eleme.md similarity index 100% rename from docs/oauth/eleme.md rename to docs/back/eleme.md diff --git a/docs/oauth/facebook.md b/docs/back/facebook.md similarity index 100% rename from docs/oauth/facebook.md rename to docs/back/facebook.md diff --git a/docs/oauth/gitlab.md b/docs/back/gitlab.md similarity index 100% rename from docs/oauth/gitlab.md rename to docs/back/gitlab.md diff --git a/docs/oauth/google.md b/docs/back/google.md similarity index 100% rename from docs/oauth/google.md rename to docs/back/google.md diff --git a/docs/oauth/huawei.md b/docs/back/huawei.md similarity index 100% rename from docs/oauth/huawei.md rename to docs/back/huawei.md diff --git a/docs/oauth/linkedin.md b/docs/back/linkedin.md similarity index 100% rename from docs/oauth/linkedin.md rename to docs/back/linkedin.md diff --git a/docs/oauth/meituan.md b/docs/back/meituan.md similarity index 100% rename from docs/oauth/meituan.md rename to docs/back/meituan.md diff --git a/docs/oauth/mi.md b/docs/back/mi.md similarity index 100% rename from docs/oauth/mi.md rename to docs/back/mi.md diff --git a/docs/oauth/microsoft.md b/docs/back/microsoft.md similarity index 100% rename from docs/oauth/microsoft.md rename to docs/back/microsoft.md diff --git a/docs/oauth/oschina.md b/docs/back/oschina.md similarity index 100% rename from docs/oauth/oschina.md rename to docs/back/oschina.md diff --git a/docs/oauth/pinterest.md b/docs/back/pinterest.md similarity index 100% rename from docs/oauth/pinterest.md rename to docs/back/pinterest.md diff --git a/docs/oauth/renren.md b/docs/back/renren.md similarity index 100% rename from docs/oauth/renren.md rename to docs/back/renren.md diff --git a/docs/oauth/stackoverflow.md b/docs/back/stackoverflow.md similarity index 100% rename from docs/oauth/stackoverflow.md rename to docs/back/stackoverflow.md diff --git a/docs/oauth/taobao.md b/docs/back/taobao.md similarity index 100% rename from docs/oauth/taobao.md rename to docs/back/taobao.md diff --git a/docs/oauth/teambition.md b/docs/back/teambition.md similarity index 100% rename from docs/oauth/teambition.md rename to docs/back/teambition.md diff --git a/docs/oauth/tencentCloud.md b/docs/back/tencentCloud.md similarity index 100% rename from docs/oauth/tencentCloud.md rename to docs/back/tencentCloud.md diff --git a/docs/oauth/toutiao.md b/docs/back/toutiao.md similarity index 100% rename from docs/oauth/toutiao.md rename to docs/back/toutiao.md diff --git a/docs/oauth/wechatEnterprise.md b/docs/back/wechatEnterprise.md similarity index 100% rename from docs/oauth/wechatEnterprise.md rename to docs/back/wechatEnterprise.md diff --git a/docs/oauth/wechat_mp.md b/docs/back/wechat_mp.md similarity index 100% rename from docs/oauth/wechat_mp.md rename to docs/back/wechat_mp.md diff --git a/docs/contributors.md b/docs/contributors.md index 41d7022612f75cedbfe94359f6aa11730661f11d..58ed19bb68dd8fd480cf664cd689da492d2bc11b 100644 --- a/docs/contributors.md +++ b/docs/contributors.md @@ -18,6 +18,7 @@ - 升级fastjson版本至1.2.58 - · harrylee : [Gitee] - 升级fastjson依赖到1.2.60 + - 集成京东登录 - · Veigar : [Github] - 集成酷家乐登录 - · 蛋蛋 : [Gitee] | [Github] diff --git a/docs/extended/justauth_integrated_with_the_existing_account_system.md b/docs/extended/justauth_integrated_with_the_existing_account_system.md index 6bc1cb66f3f9689a7ee0a7cc3357df3cb85544d8..14714e8fa5fa03e3c5fb984e9b9816c3a9afe7c3 100644 --- a/docs/extended/justauth_integrated_with_the_existing_account_system.md +++ b/docs/extended/justauth_integrated_with_the_existing_account_system.md @@ -1,3 +1,12 @@ -# JustAuth与现有账户系统整合 -详情参考：https://www.processon.com/diagraming/5e71db28e4b03b9965216271 \ No newline at end of file +之前在群里经常会看到小伙伴有以下几点疑问： + +- JustAuth如何与现有用户系统整合？ +- JustAuth如何实现用户绑定？ + +我就此需求，整理了一份**JustAuth与现有用户系统整合逻辑图** + +在线版: [JustAuth与现有用户系统整合](https://www.processon.com/diagraming/5e71db28e4b03b9965216271) + +![JustAuth与现有用户系统整合](../_media/extended/justauth_integrated_with_the_existing_account_system.png) + diff --git a/docs/how-to-use.md b/docs/how-to-use.md index 7f47d3a0535f7c55fd7b2c992408768039a99d6d..16088950d75070980149cb314851a3353e99d3e0 100644 --- a/docs/how-to-use.md +++ b/docs/how-to-use.md @@ -1,5 +1,3 @@ -# 如何使用 - 在前面有介绍到，JustAuth的特点之一就是**简**，极简主义，不给使用者造成不必要的障碍。 既然牛皮吹下了， 那么如何才能用JustAuth实现第三方登录呢？ @@ -37,6 +35,40 @@ authRequest.authorize("state"); authRequest.login(callback); ``` + +注意，JustAuth从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始默认集成了的[simple-http](https://github.com/xkcoding/simple-http)作为HTTP通用接口（更新说明见[JustAuth 1.14.0版本正式发布！完美解耦HTTP工具](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633197&idx=1&sn=11e625b307db62b2f1c4e82f7744b2a2&chksm=88929300bfe51a16562b45592a264482ae2c74c6dbfa4a3aa9611ad4fea4a9be5b1f0545527d&token=1093833287&lang=zh_CN#rd)），鉴于一般项目中都已经集成了HTTP工具，比如OkHttp3、apache HttpClient、hutool-http，因此为了减少不必要的依赖，从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始JustAuth将不会默认集成hutool-http，如果开发者的项目是全新的或者项目内没有集成HTTP实现工具，请自行添加对应的HTTP实现类，备选依赖如下： + +- hutool-http + + ```xml + + cn.hutool + hutool-http + 5.2.5 + + ``` + +- httpclient + + ```xml + + org.apache.httpcomponents + httpclient + 4.5.12 + + ``` + +- okhttp + + ```xml + + com.squareup.okhttp3 + okhttp + 4.4.1 + + ``` + + ## API分解 **JustAuth**的核心就是一个个的`request`，每个平台都对应一个具体的`request`类，所以在使用之前，需要就具体的授权平台创建响应的`request` @@ -156,13 +188,12 @@ public Object revokeAuth(@PathVariable("source") String source, @PathVariable("t ## 配套项目 -**配套Demo**： - [JustAuth-demo](https://github.com/justauth/JustAuth-demo)：普通版springboot项目demo - [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo): Jfinal集成JustAuth的demo by [xkcoding](https://github.com/xkcoding) - [ActFramework版](https://github.com/xkcoding/act-justauth-demo): ActFramework 集成 JustAuth 的 demo by [xkcoding](https://github.com/xkcoding) - [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo): NutzBoot集成JustAuth的demo by [蛋蛋](https://github.com/EggsBlue) - [Blade版](https://github.com/justauth/blade-justauth-demo): Blade集成JustAuth的demo -## starter插件 +## SpringBoot插件 - [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot 集成 JustAuth 的最佳实践 by [xkcoding](https://github.com/xkcoding) - [justauth-spring-security-starter](https://github.com/justauth/justauth-spring-security-starter): JustAuth整合Spring security的 starter依赖 by [luoqiz](https://github.com/luoqiz) diff --git a/docs/supporting.md b/docs/supporting.md deleted file mode 100644 index 653d98b1bd1c05138d8088febf3d2eadc8d013b9..0000000000000000000000000000000000000000 --- a/docs/supporting.md +++ /dev/null @@ -1,13 +0,0 @@ -## 配套Demo -- [simple版](https://github.com/justauth/JustAuth-demo) -- [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo): Jfinal集成JustAuth的demo by [xkcoding](https://github.com/xkcoding) -- [ActFramework版](https://github.com/xkcoding/act-justauth-demo): ActFramework 集成 JustAuth 的 demo by [xkcoding](https://github.com/xkcoding) -- [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo): NutzBoot集成JustAuth的demo by [蛋蛋](https://github.com/EggsBlue) -- [Blade版](https://github.com/justauth/blade-justauth-demo): Blade集成JustAuth的demo - -## starter插件 -- [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot 集成 JustAuth 的最佳实践 by [xkcoding](https://github.com/xkcoding) -- [justauth-spring-security-starter](https://github.com/justauth/justauth-spring-security-starter): JustAuth整合Spring security的 starter依赖 by [luoqiz](https://github.com/luoqiz) - - -### 更多项目请参考： https://github.com/justauth \ No newline at end of file diff --git a/docs/update.md b/docs/update.md index 8512a4c49fa7038d420780b169779804ee0fa5ab..a240ef7a0b7219dc904cec678da7814d93e5fb98 100644 --- a/docs/update.md +++ b/docs/update.md @@ -4,6 +4,13 @@ - 合并[PR-59](https://github.com/justauth/JustAuth/pull/59)，抽取HTTP，具体实现交给开发者，解耦 hutool-http，开发者可以视自己项目的依赖决定使用何种HTTP方式。详情请参考：https://github.com/xkcoding/simple-http - 合并[PR-65](https://github.com/justauth/JustAuth/pull/65)，修改错误文案 - 修复其他一些问题 + +## v1.14.0 +### 2020/03/17 +- 修改 + - 合并[PR-59](https://github.com/justauth/JustAuth/pull/59)，抽取HTTP，具体实现交给开发者，解耦 hutool-http，开发者可以视自己项目的依赖决定使用何种HTTP方式。详情请参考：https://github.com/xkcoding/simple-http + - 合并[PR-65](https://github.com/justauth/JustAuth/pull/65)，修改错误文案 + - 修复其他一些问题 ## v1.13.2 ### 2019/12/24 diff --git a/docs/users.md b/docs/users.md index 7d08dc1c5cdc53329005e69b22fe48a679bda033..5558ac886fc2b345cec187f349198ee9ecefeb6d 100644 --- a/docs/users.md +++ b/docs/users.md @@ -6,6 +6,7 @@ - [Shiro-Action](https://github.com/zhaojun1998/Shiro-Action): 基于 Shiro 的权限管理系统，支持 restful url 授权 - [project-template](https://github.com/HobbyBear/project-template): 作为前后端分离项目的后端模板整个项目基于springboot2.1.3，集jsr303框架做参数校验，spring security 做权限管理，并实现限制同一账号登陆会话数量功能，spring mail 发送邮件，justAuth做的第三方登陆， spring session做session共享，orm框架采用jpa,集成七牛云实现图片上传，redis实现分布式锁 - [mica](https://github.com/lets-mica/mica/tree/master/mica-social)：mica是Spring Cloud 微服务开发核心包。采用源码形式（保留了作者名）另加改了一些代码。 +- [MaxKey](https://shimingxy.github.io/MaxKey)：马克思的钥匙，寓意是最大钥匙,是用户单点登录认证系统（Sigle Sign On System）,OAuth 2.0/OpenID Connect、SAML 2.0、JWT、CAS等标准化的开放协议，使用JustAuth集成OAuth第三方认证。 ... 我在这儿等你 >>> :alien: