🎨 新增文档 + 增加阿里云登录刷新token的接口和支持忽略state校验的逻辑

2026-01-07 19:31:48 +08:00 · 2020-06-30 12:18:39 +08:00 · 2020-06-30 12:18:39 +08:00 · 369388c11d
commit 369388c11d
parent a1200b2510
7 changed files with 48 additions and 30 deletions
--- a/README.en-US.md
+++ b/README.en-US.md
@ -1,5 +1,5 @@
 <p align="center">
-	<a href="https://docs.justauth.whnb.wang"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
+	<a href="https://justauth.wiki"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy.</strong>
@ -17,7 +17,7 @@
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
 		<img src="https://img.shields.io/badge/Api%20Docs--1.15.6-latest-orange" ></img>
 	</a>
-	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
+	<a target="_blank" href="https://justauth.wiki" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
 	</a>
 	<a href="https://codecov.io/gh/zhangyd-c/JustAuth">
@ -71,7 +71,7 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
        </tr>
    </table>
-    <center><a href="https://docs.justauth.whnb.wang/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
+    <center><a href="https://justauth.wiki/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
 </center>

 -------------------------------------------------------------------------------
@ -81,7 +81,7 @@
 `JustAuth`, as you see, It is just a Java library of third-party authorized login, It's smaller and easier to use. JustAuth is the best third-party login tool written in JAVA.

 Source Code：[gitee](https://gitee.com/yadong.zhang/JustAuth) | [github](https://github.com/zhangyd-c/JustAuth)    
-Docs：[Reference Doc](https://docs.justauth.whnb.wang)
+Docs：[Reference Doc](https://justauth.wiki)

 ## Features

@ -162,11 +162,11 @@ I look forward to your joining us.

 ## Contributors

-[contributors](https://docs.justauth.whnb.wang/#/contributors)
+[contributors](https://justauth.wiki/#/contributors)

 ## Change Logs

-[CHANGELOGS](https://docs.justauth.whnb.wang/#/update)
+[CHANGELOGS](https://justauth.wiki/#/update)

 ## Recommend

--- a/README.md
+++ b/README.md
@ -1,5 +1,5 @@
 <p align="center">
-	<a href="https://docs.justauth.whnb.wang"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
+	<a href="https://justauth.wiki"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy.</strong>
@ -17,7 +17,7 @@
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
 		<img src="https://img.shields.io/badge/Api%20Docs-1.15.6-latest-orange" ></img>
 	</a>
-	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
+	<a target="_blank" href="https://justauth.wiki" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
 	</a>
 	<a href="https://codecov.io/gh/zhangyd-c/JustAuth">
@ -71,7 +71,7 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
        </tr>
    </table>
-    <center><a href="https://docs.justauth.whnb.wang/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
+    <center><a href="https://justauth.wiki/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
 </center>

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

 项目开源地址：[gitee](https://gitee.com/yadong.zhang/JustAuth) | [github](https://github.com/zhangyd-c/JustAuth)    
-项目文档：[参考文档](https://docs.justauth.whnb.wang)
+项目文档：[参考文档](https://justauth.wiki)

 ## 特点

@ -163,11 +163,11 @@ authRequest.login(callback);

 ## 贡献者名单

-[contributors](https://docs.justauth.whnb.wang/#/contributors)
+[contributors](https://justauth.wiki/#/contributors)

 ## 更新记录

-[CHANGELOGS](https://docs.justauth.whnb.wang/#/update)
+[CHANGELOGS](https://justauth.wiki/#/update)

 ## 致谢

--- a/docs/README.md
+++ b/docs/README.md
@ -1,5 +1,5 @@
 <p align="center">
-	<a href="https://docs.justauth.whnb.wang"><img src="./_media/cover.png" width="400"></a>
+	<a href="https://justauth.wiki"><img src="./_media/cover.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy!</strong>
@ -20,7 +20,7 @@
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
 		<img src="https://img.shields.io/badge/Api%20Docs-1.15.6-orange" ></img>
 	</a>
-	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
+	<a target="_blank" href="https://justauth.wiki" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
 	</a>
 	<a href="https://codecov.io/gh/zhangyd-c/JustAuth">
--- a/docs/_404.md
+++ b/docs/_404.md
@ -4,15 +4,15 @@

 ### 您可能对以下文章感兴趣：

- [OAuth的授权流程是什么样的？](https://docs.justauth.whnb.wang/#/oauth)
- [如何使用JustAuth？](https://docs.justauth.whnb.wang/#/how-to-use)
- [提问与回答？](https://docs.justauth.whnb.wang/#/Q&A)
- [如何集成Github？](https://docs.justauth.whnb.wang/#/oauth/github)
- [如何集成Gitee？](https://docs.justauth.whnb.wang/#/oauth/gitee)
- [如何集成支付宝？](https://docs.justauth.whnb.wang/#/oauth/alipay)
- [如何自定义state？](https://docs.justauth.whnb.wang/#/customize-the-state-cache)
- [如何自定义接入自己搭建的oauth平台？](https://docs.justauth.whnb.wang/#/customize-the-oauth)
- [有哪些配套项目？](https://docs.justauth.whnb.wang/#/supporting)
+- [OAuth的授权流程是什么样的？](https://justauth.wiki/#/oauth)
+- [如何使用JustAuth？](https://justauth.wiki/#/how-to-use)
+- [提问与回答？](https://justauth.wiki/#/Q&A)
+- [如何集成Github？](https://justauth.wiki/#/oauth/github)
+- [如何集成Gitee？](https://justauth.wiki/#/oauth/gitee)
+- [如何集成支付宝？](https://justauth.wiki/#/oauth/alipay)
+- [如何自定义state？](https://justauth.wiki/#/customize-the-state-cache)
+- [如何自定义接入自己搭建的oauth平台？](https://justauth.wiki/#/customize-the-oauth)
+- [有哪些配套项目？](https://justauth.wiki/#/supporting)

 ### 想使用JustAuth集成第三方OAuth登录？

--- a/docs/how-to-use.md
+++ b/docs/how-to-use.md
@ -85,7 +85,7 @@ AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
        .build());
 ```

-所有可用的`Request`列表请参考：[已集成的平台](https://docs.justauth.whnb.wang/#/README?id=已集成的平台)
+所有可用的`Request`列表请参考：[已集成的平台](https://justauth.wiki/#/README?id=已集成的平台)

 ### 获取授权链接

--- a/docs/update.md
+++ b/docs/update.md
@ -1,3 +1,21 @@
+## 1.15.6
+
+### 2020/06/30
+- 文档
+    - 新增 [百度登录](oauth/baidu.md)文档
+    - 新增 [钉钉登录](oauth/alipay.md)文档
+    - 新增 [开源中国登录](contributors.md)文档
+    - 新增 [领英登录](references.md)文档
+    - 新增 [Google 登录](references.md)文档
+    - 新增 [微信企业版登录](oauth/wechatEnterprise.md)文档
+    - 新增 [Facebook 登录](oauth/facebook.md)文档
+    - 完善 [JustAuth 使用者](users.md)文档
+    - 替换“帮助文档”域名，由[https://docs.justauth.whnb.wang](https://docs.justauth.whnb.wang)迁移到[https://justauth.wiki](https://justauth.wiki)
+- 新增
+    - 增加阿里云授权登录中刷新授权token的接口，by “QQ群用户需求”
+    - AuthConfig 增加忽略校验 state 的参数，详情参考：[Github#Issue#83](https://github.com/justauth/JustAuth/issues/83)
+    - 移除领英刷新token的接口。参考官网：`To refresh an access token, go through the authorization process again to fetch a new token.`
+
 ## 1.15.5
 ### 2020/06/24
 - BUG
@ -45,7 +63,7 @@ new AuthGoogleRequest(AuthConfig.builder()
 - 修复
    - 解决 Twitter 授权失败的BUG
 - 文档
-    - 完善 [https://docs.justauth.whnb.wang](https://docs.justauth.whnb.wang/) 的404引导页内容
+    - 完善 [https://justauth.wiki](https://justauth.wiki/) 的404引导页内容
    - 增加名词解释： `uuid`
    - 补充 [Q&A](Q&A.md)
    - 新增 [参考文档](references.md)，包含 OAuth 授权和第三方平台的API文档等内容
@ -125,9 +143,9 @@ System.setProperty("proxyHost", "127.0.0.1");
 - 新增
    - 增加微信、QQ、支付宝、微博授权登录的帮助文档
    - 合并[PR#57](https://github.com/justauth/JustAuth/pull/57)，增加微信公众号登录 by [@xkcoding](https://github.com/xkcoding)
-    - [帮助文档](https://docs.justauth.whnb.wang)中增加自定义的404页面
-    - [帮助文档](https://docs.justauth.whnb.wang)中增加Gittalk插件
-    - [帮助文档](https://docs.justauth.whnb.wang)中增加Java代码高亮的插件
+    - [帮助文档](https://justauth.wiki)中增加自定义的404页面
+    - [帮助文档](https://justauth.wiki)中增加Gittalk插件
+    - [帮助文档](https://justauth.wiki)中增加Java代码高亮的插件
    - 增加`AuthUserGender#getWechatRealGender`方法，兼容获取微信平台的用户性别
 - 修改
    - 修复抖音登录取值取错层级的问题（[issue#I15SIG@Gitee](https://gitee.com/yadong.zhang/JustAuth/issues/I15SIG)）
@ -136,7 +154,7 @@ System.setProperty("proxyHost", "127.0.0.1");
    - `AuthResponseStatus`枚举类中增加`ILLEGAL_STATUS`、`REQUIRED_REFRESH_TOKEN`两个枚举值
    - `AuthSource`接口中增加`getName`方法，用来对外提供实际`source`的字符串值
    - `AuthWeiboRequest`微博授权登录中实现`revoke`方法，支持手动回收授权
-    - [帮助文档](https://docs.justauth.whnb.wang)中修复[腾讯云登录]链接错误的问题
+    - [帮助文档](https://justauth.wiki)中修复[腾讯云登录]链接错误的问题
 - 升级
    - 升级相关依赖：lombok@v1.18.10，hutool@5.0.5，fastjson@1.2.62，alipay@4.8.10.ALL（[PR#11@Gitee](https://gitee.com/yadong.zhang/JustAuth/pulls/11)）

--- a/docs/using-state.md
+++ b/docs/using-state.md
@ -9,7 +9,7 @@
 3. 内置的缓存调度器自动清除已过期的`state`（JustAuth执行）

 ## 创建state（开发者）
-`state`在OAuth授权流程中是一个**非必要但很重要**的参数，就如[名词解释](https://docs.justauth.whnb.wang/#/explain?id=justauth中的关键词)中描述的：`state`是用来保持授权会话流程完整性，防止CSRF攻击的安全的随机的参数，**由开发者生成**。
+`state`在OAuth授权流程中是一个**非必要但很重要**的参数，就如[名词解释](https://justauth.wiki/#/explain?id=justauth中的关键词)中描述的：`state`是用来保持授权会话流程完整性，防止CSRF攻击的安全的随机的参数，**由开发者生成**。

 在JustAuth中提供了一个默认的创建state的方法，使用方式：