一、JWT的介绍
1、什么是JWT
Json web token(JWT)是为了网络应用环境间传递声明而执行的一种基于JSON的开发标准(RFC 7519),该token被设计为紧凑且安全的,特别适用于分布式站点的单点登陆(SSO)场景。JWT的声明一般被用来在身份提供者和服务提供者间传递被认证的用户身份信息,以便于从资源服务器获取资源,也可以增加一些额外的其它业务逻辑所必须的声明信息,该token也可直接被用于认证,也可被加密。
2、、基于token的鉴权机制
基于token的鉴权机制类似于http协议也是无状态的,它不需要在服务端去保留用户的认证信息或会话信息。这也就意味着机遇tokent认证机制的应用不需要去考虑用户在哪一台服务器登陆了,这就为应用的扩展提供了便利
流程是这样的
- 用户使用用户名密码请求服务器
- 服务器进行验证用户信息
- 服务器通过验证发送给用户一个token
- 客户端存储token,并在每次请求时附加这个token值
- 服务器验证token,并返回数据
这个token必须要在每次请求时发送给服务器,它应该保存在请求头中,另外,服务器要支持CORS(跨来源资源共享)策略,一般我们在服务端这么做就可以了 Access-Control-Allow-Origin:*
3、JWT的构成
JWT是由三部分构成,将这三段信息文本用链接构成了JWT字符串。就像这样
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJVc2VySWQiOjEyMywiVXNlck5hbWUiOiJhZG1pbiJ9.Qjw1epD5P6p4Yy2yju3-fkq28PddznqRj3ESfALQy_U
第一部分我们称它为头部(header)第二部分我们称其为载荷(payload,类似于飞机上承载的物品),第三部分是签证(signature)
header
JWT的头部承载的两部分信息:
- 声明类型,这里是jwt
- 声明加密的算法,通常直接使用HMAC SHA256
完整的头部就像下面这样的JSON
-
{
-
'typ':'JWT',
-
'alg':'HS256'
-
}
然后将头部进行base64加密(该加密是可以对称解密的),构成了第一部分
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9
plyload
载荷就是存放有效信息的地方。这个名字像是特指飞机上承载的货品,这些有效信息包含三个部分
- 标准中注册的声明
- 公共的声明
- 私有的声明
标注中注册的声明(建议不强制使用)
- iss:jwt签发者
- sub:jwt所面向的用户
- aud:接收jwt的一方
- exp:jwt的过期时间,这个过期时间必须大于签发时间
- nbf:定义在什么时间之前,该jwt都是不可用的
- iat:jwt的签发时间
- jti:jwt的唯一身份标识,主要用来作为一次性token,从而回避重放攻击
公共的声明:
公共的声明可以添加任何的信息,一般添加用户的相关信息或其它业务需要的必要信息,但不建议添加敏感信息,因为该部分在客户端可解密;
私有的声明
私有的声明是提供者和消费者功能定义的声明,一般不建议存放敏感信息,因为base64是对称解密的,意味着该部分信息可以归类为名文信息。
定义一个payload
-
{
-
"sub": "1234567890",
-
"name": "John Doe",
-
"admin": true
-
}
然后将其base64加密,得到jwt的一部分
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9
Signature
jwt的第三部分是一个签证信息,这个签证信息由三部分组成:
- header(base64后的)
- payload(base64后的)
- secred
这个部分需要base64加密后的header和base64加密后的payload使用“.”连接组成的字符串,然后通过header中声明的加密方式进行加secret组合加密,然后就构成了jwt的第三部分
-
var encodedString = base64UrlEncode(header) + '.' + base64UrlEncode(payload);
-
var signature = HMACSHA256(encodedString, 'secret'); // TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
将这三部分用“.”连接成一个完整的字符串,构成了最终的jwt:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
注意:secret是保存在服务器端的,jwt的签发也是在服务端的,secret就是用来进行jwt的签发和jwt的验证,所以它就是你服务端的私钥,在任何场景都不应该流露出去,一旦客户端得知这个secret,那就意味着客户端可以自我签发jwt了
应用
-
一般是在请求头里加入Authorization,并加上 Bearer 标注:
-
fetch('api/user/1', {
-
headers: {
-
'Authorization': 'Bearer ' + token
-
}
-
})
优点:
- 因为json的通用性,所以JWT是可以跨语言支持的,像C#,JavaScript,NodeJS,PHP等许多语言都可以使用
- 因为由了payload部分,所以JWT可以在自身存储一些其它业务逻辑所必要的非敏感信息
- 便于传输,jwt的构成非常简单,字节占用很小,所以它是非常便于传输的
- 它不需要在服务端保存会话信息,所以它易于应用的扩展
安全相关
- 不应该在jwt的payload部分存储敏感信息,因为该部分是客户端可解密的部分
- 保护好secret私钥。该私钥非常重要
- 如果可以,请使用https协议
来源于网上资料,
具体可查看 https://blog.csdn.net/u014799292/article/details/88365086
二、实战
首先 引入jar包
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
<version>0.9.0</version>
</dependency>
新建jwt的工具类
public class JwtTokenUtil {
public static final String TOKEN_HEADER = "Authorization";
public static final String TOKEN_PREFIX = "Bearer";
private static final String SECRET = "jwtsecrettest";
private static final String ISS = "leopard";
public static final long EXPIRATION = 3600L; //过期时间 一小时
public static final long EXPIRATION_REMEMBER = 604800L; //选择记住我之后的过期时间为7天
/*
* 生成token方法
* @param username
* @param isRemenberMe
*/
public static String createToken(String id, String username,boolean isRemenberMe) {
long expiration = isRemenberMe ? EXPIRATION_REMEMBER : EXPIRATION;
//String encryId = RCUtils.encry_string(id);
return Jwts.builder().signWith(SignatureAlgorithm.HS512, SECRET)
.setIssuer(ISS)
.setId(id)
.setSubject(username)
.setIssuedAt(new Date())
.setExpiration(new Date(System.currentTimeMillis() + expiration * 1000))
.compact();
}
/**
* 从token中获取用户名
* @param token
* @return
* @throws BusinessExpection
*/
public static String getUsername(String token) throws BusinessExpection{
return getTokenBody(token).getSubject();
}
/**
* 从token中获取ID,同时做解密处理
* @param token
* @return
* @throws BusinessExpection
*/
public static String getObjectId(String token) throws BusinessExpection{
return getTokenBody(token).getId();
}
/**
* 是否已过期
* @param token
* @throws 过期无法判断,只能通过捕获ExpiredJwtException异常
* @return
* @throws BusinessExpection
*/
@Deprecated
public static boolean isExpiration(String token) throws BusinessExpection{
return getTokenBody(token).getExpiration().before(new Date());
}
/*
* 获取token信息,同时也做校验处理
*
*/
public static Claims getTokenBody(String token) throws BusinessExpection {
try {
return Jwts.parser()
.setSigningKey(SECRET)
.parseClaimsJws(token)
.getBody();
}catch (ExpiredJwtException expired) {
// 过期
throw new BusinessExpection(EmBussinsError.TOKEN_EXPIRED);
}catch(SignatureException e) {
//无效
throw new BusinessExpection(EmBussinsError.INVALID_REQUEST);
}catch(MalformedJwtException malformedJwt) {
//无效
throw new BusinessExpection(EmBussinsError.INVALID_REQUEST);
}
}
}
在baseAction里 统一获得token 值
第一步在用户登录时,生成token 并返回。
@Controller
@RequestMapping("/admin")
public class AdminController extends BaseAction{
@RequestMapping("/login")
@ResponseBody
public ResultType login(HttpServletRequest request,HttpServletResponse response) {
String username = request.getParameter("username");
String pass = request.getParameter("pass");
String token = JwtTokenUtil.createToken("10", username, false);
response.setHeader(JwtTokenUtil.TOKEN_HEADER, JwtTokenUtil.TOKEN_PREFIX+token);
return ResultType.creat("sussess");
}
@RequestMapping("/adminLoginOut")
@ResponseBody
public ResultType adminLoginOut(HttpServletRequest request) throws BusinessExpection {
String userId = getUserid(request);
return ResultType.creat("success");
}
}
测试成功,再返回信息的header种得到加密后的token
接下里在测试 用户退出登录
当不携带token 时 就会报错
当然这个错误可以自己自定义在这里我毕竟是测试,所以写的都比较简单。测试功能主要是
当携带token时, 就ok了
当携带token时便操作成功了 并且token验证成功。