📝 补充文档：自定义state缓存、自定义实现oauth等

justauth · Oct 26, 2019 · 4e0fe3b · 4e0fe3b
1 parent 9f34138
commit 4e0fe3b
Show file tree

Hide file tree

Showing 61 changed files with 998 additions and 32 deletions.
diff --git a/.gitee/PULL_REQUEST_TEMPLATE.zh-CN.md b/.gitee/PULL_REQUEST_TEMPLATE.zh-CN.md
@@ -18,9 +18,12 @@
 - [ ] 否，还没做测试，需要作者自测
 
 注：测试demo可以使用：
-- [Springboot版](https://github.com/justauth/JustAuth-demo)
+- [simple版](https://github.com/justauth/JustAuth-demo)
 - [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo)
 - [ActFramework版](https://github.com/xkcoding/act-justauth-demo)
+- [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo)
+- [Blade版](https://github.com/justauth/blade-justauth-demo)
+
 
 
 
diff --git a/README.en-US.md b/README.en-US.md
@@ -6,7 +6,7 @@
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.12.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven Central-1.13.0-blue.svg" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -15,7 +15,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.12.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api Docs-1.13.0-orange.svg" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -68,6 +68,7 @@
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20"></td>
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20"></td>
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
         </tr>
     </table>
     <table>
@@ -100,7 +101,7 @@ These artifacts are available from Maven Central:
 <dependency>
     <groupId>me.zhyd.oauth</groupId>
     <artifactId>JustAuth</artifactId>
-    <version>${latest.version}</version>
+    <version>1.13.0</version>
 </dependency>
 ```
 - Using JustAuth
@@ -162,7 +163,7 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20">  |  [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20">  |  [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
-|  <img src="" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |
 
 

diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.12.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven Central-1.13.0-blue.svg" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -15,7 +15,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.12.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api Docs-1.13.0-orange.svg" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -68,6 +68,7 @@
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20"></td>
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20"></td>
             <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
         </tr>
     </table>
     <table>
@@ -100,7 +101,7 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具
 <dependency>
     <groupId>me.zhyd.oauth</groupId>
     <artifactId>JustAuth</artifactId>
-    <version>1.12.0</version>
+    <version>1.13.0</version>
 </dependency>
 ```
 - 调用api
@@ -119,7 +120,7 @@ authRequest.login(callback);
 ```
 
 **配套Demo**：
-- [Springboot版](https://github.com/justauth/JustAuth-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)
 - [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo): NutzBoot集成JustAuth的demo  by [蛋蛋](https://github.com/EggsBlue)
@@ -168,7 +169,7 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20">  |  [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20">  |  [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
-|  <img src="" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |
 
 _请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经下线。如果以前申请过的应用，可以继续使用，但是不再支持申请新的应用。so, 本项目中的CSDN登录只能针对少部分用户使用了_

diff --git a/docs/Q&A.md b/docs/Q&A.md
@@ -1,4 +1,25 @@
-## ~~升级到1.8.0后如何启用state？~~
+## 1.项目编译报错
+ **问题描述** 
+
+在使用JustAuth时，`AuthConfig.builder()`报错，提示没有`builder()`方法
+
+ **解决方案：** 
+
+安装完lombok插件即可
+
+[eclipse安装lombok](https://www.zhyd.me/article/61)    
+
+ **idea安装lombok：** file->settings->plugins->Browse Repositories->输入`lombok`，点击搜索->选中lombok点击install->安装完成后重启idea
+
+ **进阶版问题：** 
+idea中安装完lombok并重启idea之后，启动项目仍然报错：
+![输入图片说明](https://gitee.com/uploads/images/2018/0522/153610_ffe84828_784199.png "1.png")
+ **解决办法** 
+![输入图片说明](https://gitee.com/uploads/images/2018/0522/153715_75193de5_784199.jpeg "2.jpg")
+默认是eclipse  选择javac就可以了   
+
+
+## 2.~~升级到1.8.0后如何启用state？~~
 
 ~~在原api使用方法的基础上，为config追加一个state即可。~~
 ```
@@ -10,7 +31,7 @@ AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
         .build());
 ```
 
-## ~~升级到1.8.0后login方法报错？~~
+## 3.~~升级到1.8.0后login方法报错？~~
 
 ~~这是因为1.8.0版本中新增了[AuthCallback](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/model/AuthCallback.java)类，这个类封装了所有可能的回调参数。目前包含以下三个参数：~~
 - ~~`code`: 访问AuthorizeUrl后回调时带的参数code，用来换取token~~
@@ -30,7 +51,7 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 ```
  ~~_代码截取自_ ：https://github.com/justauth/JustAuth-demo~~
 
-## ~~升级到1.8.0后对于state参数有什么特殊要求吗？~~
+## 4.~~升级到1.8.0后对于state参数有什么特殊要求吗？~~
 
 ~~理论上没有，stata只是用来保持会话状态，因为http协议的无状态性，从授权到回调，无法感知具体是哪个用户触发的。所以可以使用state作为校验。注：state参数每次完整的授权链中只可用一次！（也是为了防止不必要的危险）~~
 
@@ -42,7 +63,7 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 
 ~~注：`authorize`和`login`（不是指回调传回的`state`，而是声明`request`时传入的`state`）中传的`state`务必保证一致~~
 
-## 升级到1.9.3+版本后编译失败
+## 5.升级到1.9.3+版本后编译失败
 
 主要明显的就是`IpUtils.getIp`和request的`.state`报错。
 
@@ -64,7 +85,7 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 }
 ```
 
-## 升级到最新版本后为什么支付宝登录不能用了？
+## 6.升级到最新版本后为什么支付宝登录不能用了？
 
 在升级到新版后，使用支付宝登录会提示`ClassNotFoundExcption`异常，这是因为从`1.9.4`版本开始，JustAuth将不在强依赖`alipay-sdk-java`，如果你需要用到Alipay的授权登陆，那么你还需要添加以下依赖：
 
@@ -75,3 +96,45 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 	<version>3.7.4.ALL</version>
 </dependency>
 ```
+
+## 7.“Scope参数错误或者Scope没有权限”是怎么回事？
+
+微信开放平台授权登录提示“Scope参数错误或者Scope没有权限”
+
+![Scope参数错误或者Scope没有权限](./_media/scope_error.png)
+
+解决办法：请检查微信开放平台的应用是否有“微信登录”接口的权限。
+
+![“微信登录”接口](./_media/scope_error2.png)
+
+“接口状态”必须为“已获得”！
+
+## 8.微信登录时能在微信端提示登录成功吗？
+
+不可以，这是**微信公众平台**的功能，截至到目前（JustAuth v1.12.0）为止，暂不支持**微信公众平台**的授权登录
+
+## 9.微信登录时能不需要手机确认吗？扫码后就自动登录
+
+不可以，微信开放平台不支持这种操作。可以把微信扫码登录理解成qq用账号密码登录，扫完码后不手动点确认，微信怎么知道用户是否同意了授权？    
+当然，**微信公众平台**的授权流程可以越过这个限制，只要关注了公众号，后续扫码成功后就会自动登录，但是这是**微信公众平台**的功能，截至到目前（JustAuth v1.12.0）为止，暂不支持**微信公众平台**的授权登录
+
+## 10.本地如何测那些*不支持本地地址回调*的授权登录？
+
+推荐几种方案：
+1. 改`hosts`，然后将测试程序的端口改为`80`
+2. 使用`Nginx`/`Apache`做代理
+3. FRP内网穿透，参考地址：[使用内网穿透的方式集成第三方登录](https://xkcoding.com/2019/05/22/spring-boot-login-with-oauth.html)
+
+## 11.如何获取QQ登录的`unionId`？
+
+在AuthConfig中设备`unionId`为`true`
+
+```java
+AuthRequest authRequest = new AuthQqRequest(AuthConfig.builder()
+        .clientId("clientId")
+        .clientSecret("clientSecret")
+        .redirectUri("redirectUri")
+        .unionId(true)
+        .build());
+```
+> 注：使用unionId要求开发者必须已在qq开放平台申请了获取unionId的权限，否则可能会发生错误！切记！参考链接：[unionid介绍](http://wiki.connect.qq.com/unionid%E4%BB%8B%E7%BB%8D)
diff --git a/docs/README.md b/docs/README.md
@@ -9,7 +9,7 @@
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.12.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven Central-1.13.0-blue.svg" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -18,7 +18,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.12.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api Docs-1.13.0-orange.svg" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -91,6 +91,7 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20">  |  [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20">  |  [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |
 
 

diff --git a/docs/_coverpage.md b/docs/_coverpage.md
@@ -1,6 +1,6 @@
 
 ![](_media/logo.png)
-# JustAuth <small>1.12.0</small>
+# JustAuth <small>1.13.0</small>
 
 <strong>史上最全的整合第三方登录的开源库</strong>
 

diff --git a/docs/_media/custom/gitlab.png b/docs/_media/custom/gitlab.png
diff --git a/docs/_media/custom/gitlab2.png b/docs/_media/custom/gitlab2.png
diff --git a/docs/_media/custom/gitlab3.png b/docs/_media/custom/gitlab3.png
diff --git a/docs/_media/custom/gitlab4.png b/docs/_media/custom/gitlab4.png
diff --git a/docs/_media/oauth/gitee_01.png b/docs/_media/oauth/gitee_01.png
diff --git a/docs/_media/oauth/gitee_02.png b/docs/_media/oauth/gitee_02.png
diff --git a/docs/_media/oauth/gitee_03.png b/docs/_media/oauth/gitee_03.png
diff --git a/docs/_media/oauth/gitee_04.png b/docs/_media/oauth/gitee_04.png
diff --git a/docs/_media/oauth/kujiale_1.png b/docs/_media/oauth/kujiale_1.png
diff --git a/docs/_media/oauth/kujiale_2.png b/docs/_media/oauth/kujiale_2.png
diff --git a/docs/_media/oauth/kujiale_3.png b/docs/_media/oauth/kujiale_3.png
diff --git a/docs/_media/oauth/kujiale_4.png b/docs/_media/oauth/kujiale_4.png
diff --git a/docs/_media/oauth/kujiale_5.png b/docs/_media/oauth/kujiale_5.png
diff --git a/docs/_media/oauth/kujiale_6.png b/docs/_media/oauth/kujiale_6.png
diff --git a/docs/_media/scope_error.png b/docs/_media/scope_error.png
diff --git a/docs/_media/scope_error2.png b/docs/_media/scope_error2.png
diff --git a/docs/_sidebar.md b/docs/_sidebar.md
@@ -4,11 +4,43 @@
   - [名词解释](explain.md)
   - [OAuth流程](oauth.md)
   - [如何使用](how-to-use.md)
-- 其他特性
+- [Q&A](Q&A.md)
+- 集成第三方
+  - [Gitee登录](oauth/gitee.md)
+  - [Github登录](oauth/github.md)
+  - [qq登录](oauth/qq.md)
+  - [微信登录](oauth/wechat.md)
+  - [微博登录](oauth/weibo.md)
+  - [支付宝登录](oauth/alipay.md)
+  - [百度登录](oauth/baidu.md)
+  - [Coding登录](oauth/coding.md)
+  - [钉钉登录](oauth/dingtalk.md)
+  - [开源中国登录](oauth/oschina.md)
+  - [淘宝登录](oauth/taobao.md)
+  - [腾讯云登录](oauth/tenchentCloud.md)
+  - [Google登录](oauth/google.md)
+  - [Facebook登录](oauth/facebook.md)
+  - [抖音登录](oauth/douyin.md)
+  - [领英登录](oauth/linkedin.md)
+  - [微软登录](oauth/microsoft.md)
+  - [小米登录](oauth/mi.md)
+  - [头条登录](oauth/toutiao.md)
+  - [Teambition登录](oauth/teambition.md)
+  - [人人登录](oauth/renren.md)
+  - [Pinterest登录](oauth/pinterest.md)
+  - [Stackoverflow登录](oauth/stackoverflow.md)
+  - [华为登录](oauth/huawei.md)
+  - [微信企业版登录](oauth/wechatEnterprise.md)
+  - [酷家乐登录](oauth/kujiale.md)
+  - [Gitlab登录](oauth/gitlab.md)
+  - [美团登录](oauth/meituan.md)
+  - [饿了么登录](oauth/eleme.md)
+  - [CSDN登录](oauth/csdn.md)
+- 高级特性
   - [使用State](using-state.md)
   - [自定义state缓存](customize-the-state-cache.md)
+  - [自定义第三方平台的OAuth](customize-the-oauth.md)
 - [配套项目](supporting.md)
-- [Q&A](Q&A.md)
 - [Who is using](users.md)
 - [致谢](thx.md)
 - [更新记录](update.md)
diff --git a/docs/contributors.md b/docs/contributors.md
@@ -10,7 +10,7 @@
   - 提供ActFramework版demo
   - 提供SpringBoot快速集成的justauth-spring-boot-starter
 - <img src="https://avatars2.githubusercontent.com/u/2988765?s=115&v=4" width="20"> · pengisgood :  <a href="https://github.com/pengisgood" target="_blank">[Github]</a> | <a href="https://pengisgood.github.io" target="_blank">[个人网站]</a>
-  - 集成人人登录、Pinterest登录、StackOverflow登录
+  - 集成人人登录、Pinterest登录、StackOverflow登录、Twitter登录
 - <img src="https://avatar.gitee.com/uploads/51/1651_dolphinboy.png!avatar100?1479346570" width="20"> · skqing :  <a href="https://gitee.com/skqing" target="_blank">[Gitee]</a> | <a href="https://my.oschina.net/dolphinboy" target="_blank">[个人网站]</a>    
   - 修复钉钉登录的部分问题
   - 优化微博登录