OAuth2默认的AccessToken是由DefaultAccessTokenConverter生成，是具有唯一性的UUID随机字符串，我们如果想要使用JWT来格式化AccessToken就需要使用JwtAccessTokenConverter来进行格式化，当然如果你有自己独特的业务可以自己实现AccessTokenConverter接口，并将实现类交付给IOC托管即可。
ApiBoot内部集成了DefaultAccessTokenConverter（默认）、JwtAccessTokenConverter，只需要一个配置就可以实现相互转换。
博客原文地址：https://blog.yuqiyu.com/apiboot-security-oauth-use-jwt.html
相关文档
- ApiBoot OAuth2官方文档：http://apiboot.minbox.io/zh-cn/docs/api-boot-oauth.html
- ApiBoot 开源源码：minbox-projects/api-boot
ApiBoot Security OAuth组件系列文章
- ApiBoot实现零代码整合Spring Security & OAuth2
- ApiBoot零代码整合Spring Security的JDBC方式获取AccessToken
- 见过这么简单的方式整合Spring Security & OAuth2的自定义查询用户吗？
- Spring Security & OAuth2实现短信验证码方式获取AccessToken
- 原来Spring Security整合OAuth2后开放权限拦截路径还能这么玩？
- 我以为OAuth2整合JWT是很困难的事情，直到我使用了ApiBoot，一切都变了！
- 来看看OAuth2怎么设置AccessToken有效期时间时长
- OAuth2使用Redis来存储客户端信息以及AccessToken
JWT加密秘钥
对JWT了解的同学应该知道，它内部不可逆的部分采用的是RSA加密，在加密过程中需要一个秘钥，在JwtAccessTokenConverter实现类中采用了6位随机字符串作为秘钥，相关源码如下：
/**
* Helper that translates between JWT encoded token values and OAuth authentication
* information (in both directions). Also acts as a {@link TokenEnhancer} when tokens are
* granted.
*
* @see TokenEnhancer
* @see AccessTokenConverter
*
* @author Dave Syer
* @author Luke Taylor
*/
public class JwtAccessTokenConverter implements TokenEnhancer, AccessTokenConverter, InitializingBean {
.....
private String verifierKey = new RandomValueStringGenerator().generate();
private Signer signer = new MacSigner(verifierKey);
private String signingKey = verifierKey;
}
这种形式虽然在某一些层面上是唯一的，实在感觉不太严谨，所以ApiBoot添加一个配置，可以自定义这个加密秘钥signingKey字段。
创建示例项目
为了本章的演示效果，我们使用IDEA来创建一个SpringBoot项目，pom.xml文件内相关的依赖如下所示：
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.minbox.framework</groupId>
<artifactId>api-boot-starter-security-oauth-jwt</artifactId>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.minbox.framework</groupId>
<artifactId>api-boot-dependencies</artifactId>
<version>2.2.0.RELEASE</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
依赖添加完成后下面我们配置下测试的用户以及客户端信息。
配置内存用户
我们在获取AccessToken时使用的password授权类型，所以我们需要在application.yml文件内配置登录用户所使用的用户名、密码，如下所示：
api:
boot:
security:
users:
- username: yuqiyu
password: 123456
本章为了演示
JWT格式化AccessToken，验证的用户采用内存方式配置，了解详情。
开启JWT转换
ApiBoot OAuth2默认使用DefaultAccessTokenConverter实现类来格式化AccessToken，如果我们想要切换到JwtAccessTokenConverter，需要在application.yml添加一个配置，如下所示：
api:
boot:
oauth:
# 启用JWT，用于格式化AccessToken
jwt:
enable: true
配置加密秘钥
在本文开头说到了JwtAccessTokenConverter实现类内采用的是6位随机字符串的方式来作为RSA加密的秘钥，ApiBoot OAuth2提供了参数配置可以进行自定义，如下所示：
api:
boot:
oauth:
jwt:
# 加密秘钥
sign-key: 恒宇少年
秘钥格式不限，如：
特殊字符串、汉字、数字、字母....
运行测试
见证奇迹的时刻到了，我们通过IDEA的XxxApplication方式来启动本章项目，尝试使用CURL方式获取AccessToken如下所示：
➜ ~ curl ApiBoot:ApiBootSecret@localhost:9090/oauth/token -d 'grant_type=password&username=yuqiyu&password=123456'
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOlsiYXBpIl0sInVzZXJfbmFtZSI6Inl1cWl5dSIsInNjb3BlIjpbImFwaSJdLCJleHAiOjE1NzU5NTMwNDgsImF1dGhvcml0aWVzIjpbIlJPTEVfYXBpIl0sImp0aSI6ImQxMDNmNDYwLTk3YzMtNGNiZS05OWM4LWYzZjU2MmRhMDZhOCIsImNsaWVudF9pZCI6IkFwaUJvb3QifQ.HMHRBCIGPZNlkJPCnXaktMWxXEW-5roo7tdQR1JpCyY",
"token_type": "bearer",
"refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOlsiYXBpIl0sInVzZXJfbmFtZSI6Inl1cWl5dSIsInNjb3BlIjpbImFwaSJdLCJhdGkiOiJkMTAzZjQ2MC05N2MzLTRjYmUtOTljOC1mM2Y1NjJkYTA2YTgiLCJleHAiOjE1Nzg1Mzc4NDgsImF1dGhvcml0aWVzIjpbIlJPTEVfYXBpIl0sImp0aSI6ImY1NDMxZTMzLWE1YzMtNGVmNC1hZDM0LTk1MGQ3ODliYTRiZCIsImNsaWVudF9pZCI6IkFwaUJvb3QifQ.TfJ5vThvaibV2kVo2obHqnYzmYm-GsdtRLoB3RJbkrg",
"expires_in": 6925,
"scope": "api",
"jti": "d103f460-97c3-4cbe-99c8-f3f562da06a8"
}
ApiBoot OAuth有默认的客户端配置信息为ApiBoot、ApiBootSecret，为了方便演示，这里没做修改，如需修改请查看ApiBoot OAuth文档，如果你感觉控制台打印的json不美观，阅读性太差，可以使用在线格式化JSON工具.
敲黑板，划重点
使用ApiBoot来格式化OAuth2的AccessToken是不是特别简单？省去了我们自己去创建JwtAccessTokenConverter实例，然后还需要将实例放入IOC繁琐的步骤，更多使用详解敬请期待~~
代码示例
如果您喜欢本篇文章请为源码仓库点个Star，谢谢！！！
本篇文章示例源码可以通过以下途径获取，目录为apiboot-security-oauth-use-jwt：
签到送书活动进行中
自律改变人生，恒宇少年回馈粉丝，给大家的福利，请访问https://blog.yuqiyu.com/welfare/了解详情。
