🔇 doc 文档迁移到 https://justauth.wiki

docs/Q&A.md

-## 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即可。~~
-```
-AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
-        .clientId("clientId")
-        .clientSecret("clientSecret")
-        .redirectUri("redirectUri")
-        .state("state") // 就是这儿
-        .build());
-```
-
-## 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~~
-- ~~`auth_code`: 支付宝授权登陆时不会返回code而是返回`auth_code`参数~~
-- ~~`state`: 访问AuthorizeUrl后回调时带的参数state，用于和请求AuthorizeUrl前的state比较，防止CSRF攻击~~
-
-~~1.8.0版本之后的api，可以直接用AuthCallback类作为回调方法的入参，比如：~~
-```
-@RequestMapping("/callback/{source}")
-public Object login(@PathVariable("source") String source, AuthCallback callback) {
-	System.out.println("进入callback：" + source + " callback params：" + JSONObject.toJSONString(callback));
-	AuthRequest authRequest = getAuthRequest(source);
-	AuthResponse response = authRequest.login(callback);
-	System.out.println(JSONObject.toJSONString(response));
-	return response;
-}
-```
- ~~_代码截取自_ ：https://github.com/justauth/JustAuth-demo~~
-
-## 4.~~升级到1.8.0后对于state参数有什么特殊要求吗？~~
-
-~~理论上没有，stata只是用来保持会话状态，因为http协议的无状态性，从授权到回调，无法感知具体是哪个用户触发的。所以可以使用state作为校验。注：state参数每次完整的授权链中只可用一次！（也是为了防止不必要的危险）~~
-
-~~作者建议state命名格式如下：~~
-- ~~授权登录：`{source}_{ip}_{random}`~~
-- ~~账号绑定：`{source}_{userId}_{ip}_{random}`~~
-
-~~其中`source`表示授权平台，可以直接去JustAuth中的source，`ip`为当前用户的ip（部分情况可能不适用），`random`为随机字符串，`userId`为当前登录用户的id。~~
-
-~~注：`authorize`和`login`（不是指回调传回的`state`，而是声明`request`时传入的`state`）中传的`state`务必保证一致~~
-
-## 5.升级到1.9.3+版本后编译失败
-
-主要明显的就是`IpUtils.getIp`和request的`.state`报错。
-
-这是因为从`v1.9.3`版本开始，对项目进行了一些优化，具体优化内容参考：[v1.9.3](https://gitee.com/yadong.zhang/JustAuth/releases/v1.9.3)和[v1.9.4](https://gitee.com/yadong.zhang/JustAuth/releases/v1.9.4)。
-
-新版本的使用方式，参考[JustAuth-demo](https://github.com/justauth/JustAuth-demo/blob/master/src/main/java/me/zhyd/justauth/RestAuthController.java)
-```
-@RequestMapping("/render/{source}")
-public void renderAuth(@PathVariable("source") String source, HttpServletResponse response) throws IOException {
-	AuthRequest authRequest = getAuthRequest(source);
-	String authorizeUrl = authRequest.authorize(AuthStateUtils.createState());
-	response.sendRedirect(authorizeUrl);
-}
-@RequestMapping("/callback/{source}")
-public Object login(@PathVariable("source") String source, AuthCallback callback) {
-	AuthRequest authRequest = getAuthRequest(source);
-	AuthResponse response = authRequest.login(callback);
-	return response;
-}
-```
-
-## 6.升级到最新版本后为什么支付宝登录不能用了？
-
-在升级到新版后，使用支付宝登录会提示`ClassNotFoundExcption`异常，这是因为从`1.9.4`版本开始，JustAuth将不在强依赖`alipay-sdk-java`，如果你需要用到Alipay的授权登陆，那么你还需要添加以下依赖：
-
-```
-<dependency>
-	<groupId>com.alipay.sdk</groupId>
-	<artifactId>alipay-sdk-java</artifactId>
-	<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)
-
-## 12. `AuthCallback`报错？
-
-在使用JustAuth 1.13.0时，遇到如下所示错误：
-![](./_media/authcallback_error.png)
-
-这是因为我没有做好代码审查和测试，所以才导致的问题。我检讨！深刻的检讨！
-
-请遇到该问题的朋友及时升级到最新版本（`1.13.1`修复该问题）
-
-ps: 我要去祭天了
-
-## 13. 为什么集成国外平台时，一直提示 `connect time out`？
-
-所有国外平台都无法直接通过java进行访问API，目前[simple-http](https://github.com/xkcoding/simple-http) Release版本，暂不支持添加代理，所以目前需要手动开启代理。
-
-代理开启的方式：
-```java
-System.setProperty("proxyPort", "10080");
-System.setProperty("proxyHost", "127.0.0.1");
-```
-以上代码可以在声明 `AuthRequest` 时创建，也可以全局执行。
-
-本地如果支持科学上网，就用自己本地的代理端口即可，如果不支持科学上网，可以去网上找一些免费的代理IP进行测试（请自行操作）。

docs/README.md

-<p align="center">
-	<a href="https://justauth.wiki"><img src="./_media/cover.png" width="400"></a>
-</p>
-<p align="center">
-	<strong>Login, so easy!</strong>
-</p>
-<p align="center">
-	<strong>史上最全的整合第三方登录的开源库</strong>
-</p>
-<p align="center">
-	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven%20Central--1.15.6-blue" ></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>
-	</a>
-	<a target="_blank" href="https://www.oracle.com/technetwork/java/javase/downloads/index.html">
-		<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%20Docs-1.15.6-orange" ></img>
-	</a>
-	<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">
-		<img src="https://codecov.io/gh/zhangyd-c/JustAuth/branch/master/graph/badge.svg" />
-	</a>
-	<a href='https://gitee.com/yadong.zhang/JustAuth/stargazers'>
-	  <img src='https://gitee.com/yadong.zhang/JustAuth/badge/star.svg?theme=white' alt='star'></img>
-	</a>
-	<a target="_blank" href='https://github.com/zhangyd-c/JustAuth'>
-		<img src="https://img.shields.io/github/stars/zhangyd-c/JustAuth.svg?style=social" alt="github star"></img>
-	</a>
-</p>
-<p align="center">
-	<strong>开源地址：</strong> <a target="_blank" href='https://gitee.com/yadong.zhang/JustAuth'>Gitee</a> | <a target="_blank" href='https://github.com/zhangyd-c/JustAuth'>Github</a>
-</p>
-<p align="center">
-    <strong>QQ群：</strong>230017570
-</p>
-<p align="center"> 
-    <strong>文档更新日期：</strong> {docsify-updated}
-</p>
-
-## 简介
-
-JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具类库**，它可以让我们脱离繁琐的第三方登录SDK，让登录变得**So easy!**
-
-## 特点
-
-废话不多说，就俩字：
-
-1. **全**：已集成十多家第三方平台（国内外常用的基本都已包含），仍然还在持续扩展中（[开发计划](https://gitee.com/yadong.zhang/JustAuth/issues/IUGRK)）！
-2. **简**：API就是奔着最简单去设计的，尽量让您用起来没有障碍感！
-
-## 项目关注度趋势
-
-[![Stargazers over time](https://starchart.cc/justauth/JustAuth.svg)](https://starchart.cc/justauth/JustAuth)
-
-<a href="https://www.producthunt.com/posts/justauth?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-justauth" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=196886&theme=dark" alt="JustAuth - Login, so easy! | Product Hunt Embed" style="width: 250px; height: 54px;" width="250px" height="54px" /></a>
-
-## 参与&贡献
-
-JustAuth的发展离不开朋友们的支持，时至今日，JustAuth已渐趋完善，但仍有很大的改善空间。欢迎各位朋友为JustAuth贡献一份力量。
-
-### 提供bug或建议
-
-- [Gitee](https://gitee.com/yadong.zhang/JustAuth/issues)
-- [Github](https://github.com/justauth/JustAuth/issues)
-
-如果你正在使用JustAuth，可以在这儿留下你的足迹，获得优先推送、曝光
-
-- [Gitee](https://gitee.com/yadong.zhang/JustAuth/issues/IZ2T7)
-- [Github](https://github.com/justauth/JustAuth/issues/17)
-
-### 贡献代码的步骤
-
-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](https://github.com/xkcoding/spring-boot-demo)
-- `mica` SpringBoot 微服务高效开发工具集: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)
-- `pig` 宇宙最强微服务认证授权脚手架(架构师必备): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)
-- `SpringBlade` 完整的线上解决方案（企业开发必备）: https://gitee.com/smallc/SpringBlade
-
-## 捐赠
-
-| 支付宝  | 微信  |
-| :------------: | :------------: |
-| <img src="https://gitee.com/yadong.zhang/static/raw/master/qrcode/zfb_code.png" width="200"/> | <img src="https://gitee.com/yadong.zhang/static/raw/master/qrcode/wx_code.png" width="200" /> |
-

docs/_404.md

-# :alien: 404:alien: 
-
-**非常感谢您对JustAuth的关注**，您现在查询的内容，作者**正在补充**中！
-
-### 您可能对以下文章感兴趣：
-
-- [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登录？
-
-- [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)
-- 更多文章，正在补充中...
-
-### 其他资料
-
-- [参考文档](references.md)
-
-### 如果还是没有您想要的内容，您可以：
-
-1. (建议) 提Issue： 【[github](https://github.com/justauth/JustAuth/issues)】 | 【[gitee](https://gitee.com/yadong.zhang/JustAuth/issues)】
-2. 点击本页面右下角【OPEN CHAT】开始在线聊天
-3. 本页面底部直接留言
-4. 关注公众号（公众号会不定期推送相关内容），扫下方二维码关注公众号：
-
-<img src="https://gitee.com/yadong.zhang/static/raw/master/wx/wechat_account.jpg" width="200" />
-
-4. 加微信群（群内有各个优秀开源项目的作者和技术大神），微信扫下方二维码后加我好友（**注：一定要备注JustAUth，无备注的一律不加**）：
-
-<img src="https://gitee.com/yadong.zhang/static/raw/master/wx/wx.png" width="170"/>
-
-5. 加QQ群：QQ搜索`230017570`（该QQ群为JustAuth官方技术讨论群，禁止群内打广告！）
\ No newline at end of file

docs/_coverpage.md

-
-![](_media/justauth@0,25x.png)
-# JustAuth <small>1.15.6</small>
-
-<strong>史上最全的整合第三方登录的开源库</strong>
-
-<strong>Login, so easy</strong>
-
-<p>已集成国内外十多家平台</p>
-<p>极简的API设计</p>
-
-
-[Gitee](https://gitee.com/yadong.zhang/JustAuth)
-[Github](https://github.com/zhangyd-c/JustAuth)
-[Get Started](#简介)
-

docs/_sidebar.md

-- [入门和使用](README.md)
-- [贡献者名单](contributors.md)
-- 快速开始
-  - [名词解释](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_open.md)
-  - [√ 微博登录](oauth/weibo.md)
-  - [√ 支付宝登录](oauth/alipay.md)
-  - [√ 酷家乐登录](oauth/kujiale.md)
-  - [√ 推特登录](oauth/twitter.md)
-  - [√ Coding登录](oauth/coding.md)
-  - [√ 阿里云登录](oauth/aliyun.md)
-  - [√ 百度登录](oauth/baidu.md)
-  - [√ 钉钉登录](oauth/dingtalk.md)
-  - [√ 开源中国登录](oauth/oschina.md)
-  - [√ Google登录](oauth/google.md)
-  - [√ Facebook登录](oauth/facebook.md)
-  - [√ 领英登录](oauth/linkedin.md)
-  - [微信企业版登录](oauth/wechatEnterprise.md)
-  - [微信公众平台登录](oauth/wechat_mp.md)
-  - [淘宝登录](oauth/taobao.md)
-  - [抖音登录](oauth/douyin.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)
-  - [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)
-- 扩展内容
-  - [JustAuth与现有用户系统整合](extended/justauth_integrated_with_the_existing_account_system.md)
-- [Who is using](users.md)
-- [致谢](thx.md)
-- [参考文档](references.md)
-- [更新记录](update.md)

docs/back/baidu.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/coding.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/csdn.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/dingtalk.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/douyin.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/eleme.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/facebook.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/gitlab.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/google.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/huawei.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/linkedin.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/meituan.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/mi.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/microsoft.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/oschina.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/pinterest.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/renren.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/stackoverflow.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/taobao.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/teambition.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/tencentCloud.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/toutiao.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/wechatEnterprise.md

-（敬请期待...）
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/back/wechat_mp.md

-（敬请期待...）
-
-### 声明：
-此文档适用于**微信公众平台**！
-
-## 1. 申请应用
-
-## 2. 集成JustAuth
-
-## 3. 授权结果
\ No newline at end of file

docs/contributors.md

-# 项目贡献者名单
-
-> 排序不分先后
-
-- <img src="https://avatar.gitee.com/uploads/99/784199_yadong.zhang.png!avatar100?1462325358" width="20"> · yadong.zhang :  <a href="https://github.com/zhangyd-c" target="_blank">[Github]</a> | <a href="https://gitee.com/yadong.zhang" target="_blank">[Gitee]</a> | <a href="https://www.zhyd.me" target="_blank">[个人网站]</a>
-- <img src="https://avatars0.githubusercontent.com/u/10429917?s=460&v=4" width="20"> · yangkai.shen :  <a href="https://github.com/xkcoding" target="_blank">[Github]</a> | <a href="https://xkcoding.com" target="_blank">[个人网站]</a>    
-  - 集成微信登录、QQ登录、Google登录、微软登录、小米登录、企业微信登录
-  - 优化代码、架构，增加自定义缓存
-  - 提供jFinal版demo
-  - 提供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登录、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>    
-  - 修复钉钉登录的部分问题
-  - 优化微博登录
-- <img src="https://avatars1.githubusercontent.com/u/47110161?s=88&v=4" width="20"> · dyc12ii :  <a href="https://github.com/dyc12ii" target="_blank">[Gitee]</a>
-  - 升级fastjson版本至1.2.58
-- <img src="https://gitee.com/uploads/22/4981222_harryleexyz.png?1556524275" width="20"> · harrylee :  <a href="https://gitee.com/harryleexyz" target="_blank">[Gitee]</a>
-  - 升级fastjson依赖到1.2.60
-  - 集成京东登录
-- <img src="https://avatars3.githubusercontent.com/u/32814990?s=460&v=4" width="20"> · Veigar :  <a href="https://github.com/wuweiqi1993" target="_blank">[Github]</a>
-  -  集成酷家乐登录
-- <img src="https://avatar.gitee.com/uploads/24/1280924_TopCoderMyDream.png!avatar200?1523763232" width="20"> · 蛋蛋 :  <a href="https://gitee.com/TopCoderMyDream" target="_blank">[Gitee]</a> | <a href="https://github.com/EggsBlue" target="_blank">[Github]</a>
-  -  提供NutzBoot版的demo项目
-- <img src="https://avatars0.githubusercontent.com/u/35978114?s=180&v=4" width="20"> · Braavos96 :  <a href="https://github.com/Braavos96" target="_blank">[Github]</a>
-  -  添加测试用例：UrlBuilder 、GlobalAuthUtil 
-- <img src="https://avatars0.githubusercontent.com/u/283483?s=180&v=4" width="20"> · Chris Smowton :  <a href="https://github.com/smowton" target="_blank">[Github]</a>
-  -  添加测试用例：StringUtils
-- <img src="https://avatars1.githubusercontent.com/u/31759178?s=88&v=4" width="20"> · githubeacon :  <a href="https://github.com/githubeacon" target="_blank">[Github]</a>
-  -  增加飞书授权登录
-- <img src="https://avatars3.githubusercontent.com/u/20242284?s=88&u=2aeb7576bd61392e9fd94227d2b3048a9aea6f73&v=4" width="20"> · runningzyp :  <a href="https://github.com/runningzyp" target="_blank">[Github]</a>
-  -  修改文案错误
-- <img src="./_media/contributor/f4af112a.png" width="20"> · Spet :  <a href="https://github.com/snippet0809" target="_blank">[Github]</a>
-  -  集成阿里云授权登录
-- 千年等一回，我只为等你...
-
-ps: 如有遗漏，请告知

docs/customize-the-oauth.md

-# 自定义第三方平台的OAuth
-
-[JustAuth](https://github.com/justauth/JustAuth)发展到现在，基本上已经涵盖了国内外大多数知名的网站。[JustAuth](https://github.com/justauth/JustAuth)也一直以它的**全**和**简**，备受各位朋友的厚爱、支持。
-
-但现在OAuth技术越来越成熟，越来越多的个人站长或者企业都开始搭建自己的OAuth授权平台，那么针对这种情况，[JustAuth](https://github.com/justauth/JustAuth)并不能做到面面俱到，无法去集成所有支持OAuth的网站（这也是不现实的）。
-
-既然考虑到有这种需求，那么就要想办法解决，想办法填补漏洞，不为了自己，也为了陪伴[JustAuth](https://github.com/justauth/JustAuth)一路走来的所有朋友们。
-
-[JustAuth](https://github.com/justauth/JustAuth)开发团队也在[v1.12.0](https://github.com/justauth/JustAuth/releases/tag/v1.12.0)版本中新加入了一大特性，就是可以支持任意支持OAuth的网站通过JustAuth实现便捷的OAuth登录！
-
-下面我们会通过一个小例子，讲解如何使用JustAuth集成自己搭建的GitLab服务。
-
-> 注：本节将会使用[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo项目进行演示
-
-## 搭建Gitlab服务
-
-请自行解决，如果已有搭建好的Gitlab私服，请直接进入下面的步骤
-
-## 创建应用
-
-![gitlab私服创建应用](./_media/custom/gitlab.png)
-![gitlab私服应用详情](./_media/custom/gitlab2.png)
-
-## 实现AuthSource接口
-
-`AuthSource.java`是为了提供OAuth平台的API地址的统一接口，提供以下方法供实现：
-- `AuthSource#authorize()`: 获取授权url. 必须实现
-- `AuthSource#accessToken()`: 获取accessToken的url. 必须实现
-- `AuthSource#userInfo()`: 获取用户信息的url. 必须实现
-- `AuthSource#revoke()`: 获取取消授权的url. 非必须实现接口（部分平台不支持）
-- `AuthSource#refresh()`: 获取刷新授权的url. 非必须实现接口（部分平台不支持）
-
-**注：**
-- 当通过JustAuth扩展实现第三方授权时，请参考`AuthDefaultSource`自行创建对应的枚举类并实现`AuthSource`接口
-- 如果不是使用的枚举类，那么在授权成功后获取用户信息时，需要**单独处理source字段**的赋值
-- 如果扩展了对应枚举类时，在`me.zhyd.oauth.request.AuthRequest#login(AuthCallback)`中可以通过`xx.toString()`获取对应的source
-
-```java
-package me.zhyd.justauth;
-
-import me.zhyd.oauth.config.AuthSource;
-
-/**
- * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
- * @version 1.0
- * @website https://www.zhyd.me
- * @date 2019/10/26 16:54
- * @since 1.8
- */
-public enum AuthCustomSource implements AuthSource {
-
-    /**
-     * 自己搭建的gitlab私服
-     */
-    MYGITLAB {
-        /**
-         * 授权的api
-         *
-         * @return url
-         */
-        @Override
-        public String authorize() {
-            return "http://gitlab.xxx.com/oauth/authorize";
-        }
-
-        /**
-         * 获取accessToken的api
-         *
-         * @return url
-         */
-        @Override
-        public String accessToken() {
-            return "http://gitlab.xxx.com/oauth/token";
-        }
-
-        /**
-         * 获取用户信息的api
-         *
-         * @return url
-         */
-        @Override
-        public String userInfo() {
-            return "http://gitlab.xxx.com/api/v4/user";
-        }
-    }
-}
-```
-
-## 创建自定义的Request
-
-```java
-package me.zhyd.justauth;
-
-import cn.hutool.http.HttpResponse;
-import com.alibaba.fastjson.JSONObject;
-import me.zhyd.oauth.cache.AuthStateCache;
-import me.zhyd.oauth.config.AuthConfig;
-import me.zhyd.oauth.enums.AuthUserGender;
-import me.zhyd.oauth.exception.AuthException;
-import me.zhyd.oauth.model.AuthCallback;
-import me.zhyd.oauth.model.AuthToken;
-import me.zhyd.oauth.model.AuthUser;
-import me.zhyd.oauth.request.AuthDefaultRequest;
-import me.zhyd.oauth.utils.UrlBuilder;
-
-/**
- * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
- * @version 1.0
- * @website https://www.zhyd.me
- * @date 2019/10/26 17:00
- * @since 1.8
- */
-public class AuthMyGitlabRequest extends AuthDefaultRequest {
-
-
-    public AuthMyGitlabRequest(AuthConfig config) {
-        super(config, AuthCustomSource.MYGITLAB);
-    }
-
-    public AuthMyGitlabRequest(AuthConfig config, AuthStateCache authStateCache) {
-        super(config, AuthCustomSource.MYGITLAB, authStateCache);
-    }
-
-    @Override
-    protected AuthToken getAccessToken(AuthCallback authCallback) {
-        HttpResponse response = doPostAuthorizationCode(authCallback.getCode());
-        JSONObject object = JSONObject.parseObject(response.body());
-
-        this.checkResponse(object);
-
-        return AuthToken.builder()
-                .accessToken(object.getString("access_token"))
-                .refreshToken(object.getString("refresh_token"))
-                .idToken(object.getString("id_token"))
-                .tokenType(object.getString("token_type"))
-                .scope(object.getString("scope"))
-                .build();
-    }
-
-    @Override
-    protected AuthUser getUserInfo(AuthToken authToken) {
-        HttpResponse response = doGetUserInfo(authToken);
-        JSONObject object = JSONObject.parseObject(response.body());
-
-        this.checkResponse(object);
-
-        return AuthUser.builder()
-                .uuid(object.getString("id"))
-                .username(object.getString("username"))
-                .nickname(object.getString("name"))
-                .avatar(object.getString("avatar_url"))
-                .blog(object.getString("web_url"))
-                .company(object.getString("organization"))
-                .location(object.getString("location"))
-                .email(object.getString("email"))
-                .remark(object.getString("bio"))
-                .gender(AuthUserGender.UNKNOWN)
-                .token(authToken)
-                .source(source.toString())
-                .build();
-    }
-
-    private void checkResponse(JSONObject object) {
-        // oauth/token 验证异常
-        if (object.containsKey("error")) {
-            throw new AuthException(object.getString("error_description"));
-        }
-        // user 验证异常
-        if (object.containsKey("message")) {
-            throw new AuthException(object.getString("message"));
-        }
-    }
-
-    /**
-     * 返回带{@code state}参数的授权url，授权回调时会带上这个{@code state}
-     *
-     * @param state state 验证授权流程的参数，可以防止csrf
-     * @return 返回授权地址
-     * @since 1.11.0
-     */
-    @Override
-    public String authorize(String state) {
-        return UrlBuilder.fromBaseUrl(super.authorize(state))
-                .queryParam("scope", "read_user+openid")
-                .build();
-    }
-}
-```
-
-## 测试效果
-
-创建`AuthMyGitlabRequest`
-```java
-AuthRequest authRequest = new AuthMyGitlabRequest(AuthConfig.builder()
-    .clientId("63398e403231d4aa7e856cf5413620d536a876cb94e8d10ced0d3191b5d1d246")
-    .clientSecret("65b0eba68fff019e682e6755882a24dfdbf0a61be55de119cb8970320186c8eb")
-    .redirectUri("http://127.0.0.1:8443/oauth/callback/mygitlab")
-    .build());
-```
-
-> 注：完整代码都在[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo项目中，本节只讲解关键代码
-
-登录后的效果为
-
-![gitlab私服验证授权](./_media/custom/gitlab3.png)
-![gitlab私服登录完成](./_media/custom/gitlab4.png)
-
-
-

docs/customize-the-state-cache.md

-# 自定义state缓存
-> starter 内置了2种缓存实现，一种是上一节演示的默认实现，另一种是用户自定义的扩展实现。
-本节将会使用[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo进行演示扩展Redis缓存的方式，当然了，你也可以自定义实现你自己的缓存。
-
-## 添加 Redis 依赖
-```xml
-<dependency>
-    <groupId>org.springframework.boot</groupId>
-    <artifactId>spring-boot-starter-data-redis</artifactId>
-</dependency>
-```
-
-### 添加redis配置
-
-```xml
-# 集成redis实现自定义的state缓存
-spring.redis.database=0
-spring.redis.host=localhost
-spring.redis.port=6379
-spring.redis.password=xxxx
-```
-### 实现state缓存接口
-
-```java
-package me.zhyd.justauth;
-
-import me.zhyd.oauth.cache.AuthCacheConfig;
-import me.zhyd.oauth.cache.AuthStateCache;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.data.redis.core.RedisTemplate;
-import org.springframework.data.redis.core.ValueOperations;
-import org.springframework.stereotype.Component;
-
-import javax.annotation.PostConstruct;
-import java.util.concurrent.TimeUnit;
-
-/**
- * 扩展Redis版的state缓存
- *
- * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
- * @version 1.0
- * @date 2019/10/24 13:38
- * @since 1.8
- */
-@Component
-public class AuthStateRedisCache implements AuthStateCache {
-
-    @Autowired
-    private RedisTemplate<String, String> redisTemplate;
-
-    private ValueOperations<String, String> valueOperations;
-
-    @PostConstruct
-    public void init() {
-        valueOperations = redisTemplate.opsForValue();
-    }
-
-    /**
-     * 存入缓存，默认3分钟
-     *
-     * @param key   缓存key
-     * @param value 缓存内容
-     */
-    @Override
-    public void cache(String key, String value) {
-        valueOperations.set(key, value, AuthCacheConfig.timeout, TimeUnit.MILLISECONDS);
-    }
-
-    /**
-     * 存入缓存
-     *
-     * @param key     缓存key
-     * @param value   缓存内容
-     * @param timeout 指定缓存过期时间（毫秒）
-     */
-    @Override
-    public void cache(String key, String value, long timeout) {
-        valueOperations.set(key, value, timeout, TimeUnit.MILLISECONDS);
-    }
-
-    /**
-     * 获取缓存内容
-     *
-     * @param key 缓存key
-     * @return 缓存内容
-     */
-    @Override
-    public String get(String key) {
-        return valueOperations.get(key);
-    }
-
-    /**
-     * 是否存在key，如果对应key的value值已过期，也返回false
-     *
-     * @param key 缓存key
-     * @return true：存在key，并且value没过期；false：key不存在或者已过期
-     */
-    @Override
-    public boolean containsKey(String key) {
-        return redisTemplate.hasKey(key);
-    }
-}
-```
-
-### 获取Request
-
-本节以Gitee为例
-
-```java
-// 1. 注入新添加的cache
-@Autowired
-private AuthStateRedisCache stateRedisCache;
-
-// 2. 创建request时传入stateRedisCache
-AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
-      .clientId("clientId")
-      .clientSecret("clientSecret")
-      .redirectUri("redirectUri")
-      .build(), stateRedisCache);// 此处传入自定义实现的类
-```
-
-
-到此已经完成了通过redis**扩展实现state缓存**的功能。当然，只要你愿意，你可以使用**任何一种**缓存技术去实现这个功能，并不局限于redis。