文章目录
【后端&网络目录贴】
1. 介绍
1.1 什么是JWT
而JWT就是上述流程当中token的一种具体实现方式,其全称是JSON Web Token,官网地址:
https://jwt.io/
通俗地说,JWT的本质就是一个字符串,它是将用户信息保存到一个Json字符串中,然后进行编码后得到一个JWT token,并且这个JWT token带有签名信息
,接收后可以校验是否被篡改,所以可以用于在各方之间安全地将信息作为Json对象传输。
1.2 JWT的认证流程如下
- 首先,前端通过Web表单将自己的用户名和密码发送到后端的接口,这个过程一般是一个POST请求。建议的方式是通过SSL加密的传输(HTTPS),从而避免敏感信息被嗅探
- 后端核对用户名和密码成功后,将包含用户信息的数据作为JWT的
Payload
,将其与JWT Header
分别进行Base64编码拼接后签名,形成一个JWT Token,形成的JWT Token就是一个如同lll.zzz.xxx
的字符串- 后端将JWT Token字符串作为登录成功的结果返回给前端。前端可以将返回的结果保存在浏览器中,退出登录时删除保存的JWT Token即可
- 前端在每次请求时将JWT Token放入HTTP请求头中的
Authorization
属性中(解决XSS和XSRF问题)- 后端检查前端传过来的JWT Token,验证其有效性,比如检查签名是否正确、是否过期、token的接收方是否是自己等等
- 验证通过后,后端解析出JWT Token中包含的用户信息,进行其他逻辑操作(一般是根据用户信息得到权限等),返回结果
1.3 JWT认证的优势
对比传统的session认证方式,JWT的优势是:
- 简洁:JWT Token数据量小,传输速度也很快
- 因为JWT Token是以JSON加密形式保存在客户端的,所以JWT是跨语言的,原则上任何web形式都支持
- 不需要在服务端保存会话信息,也就是说不依赖于cookie和session,所以没有了传统session认证的弊端,特别适用于分布式微服务
- 单点登录友好:使用Session进行身份认证的话,由于cookie无法跨域,难以实现单点登录。但是,使用token进行认证的话, token可以被保存在客户端的任意位置的内存中,不一定是cookie,所以不依赖cookie,不会存在这些问题
- 适合移动端应用:使用Session进行身份认证的话,需要保存一份信息在服务器端,而且这种方式会依赖到Cookie(需要 Cookie 保存 SessionId),所以不适合移动端
因为这些优势,目前无论
单体应用
还是分布式应用
,都更加推荐用JWT token的方式进行用户认证
1.4 JWT结构
JWT由3部分组成:
标头(Header)
、有效载荷(Payload)
和签名(Signature)
。在传输的时候,会将JWT的3部分分别进行Base64编码
后用.进行连接形成最终传输的字符串
1.4.1 Header
JWT头
是一个描述JWT元数据的JSON对象,alg属性表示签名使用的算法,默认为HMAC SHA256(写为HS256)
;typ属性表示令牌的类型,JWT令牌统一写为JWT。最后,使用Base64 URL算法将上述JSON对象转换为字符串保存
{
"alg": "HS256",
"typ": "JWT"
}
1.4.2 Payload
有效载荷
部分,是JWT的主体内容部分,也是一个JSON对象
,包含需要传递的数据。 JWT指定七个默认字段供选择
iss:发行人
exp:到期时间
sub:主题
aud:用户
nbf:在此之前不可用
iat:发布时间
jti:JWT ID用于标识该JWT
这些预定义的字段并不要求强制使用。除以上默认字段外,我们还可以自定义私有字段,
一般会把包含用户信息的数据放到payload中
,如下例:
{
"sub": "1234567890",
"name": "Helen",
"admin": true
}
请注意,默认情况下JWT是
未加密
的,因为只是采用base64算法
,拿到JWT字符串后可以转换回原本的JSON数据,任何人都可以解读其内容,因此不要构建隐私信息字段,比如用户的密码一定不能保存到JWT中,以防止信息泄露。JWT只是适合在网络中传输一些非敏感的信息
1.4.3 Signature
签名哈希
部分是对上面两部分数据签名,需要使用base64编码后的header和payload数据,通过指定的算法生成哈希,以确保数据不会被篡改
。首先,需要指定一个密钥(secret)。该密码仅仅为保存在服务器中,并且不能向用户公开。然后,使用header中指定的签名算法(默认情况下为HMAC SHA256
)根据以下公式生成签名
HMACSHA256(base64UrlEncode(header)+"."+base64UrlEncode(payload),secret)
在计算出签名哈希后,JWT头,有效载荷和签名哈希的三个部分组合成一个字符串,每个部分用.分隔,就构成整个JWT对象
注意JWT每部分的作用,在服务端接收到客户端发送过来的JWT token之后:
header和payload可以直接利用base64解码出原文,从header中获取哈希签名的算法,从payload中获取有效数据
signature
由于使用了不可逆的加密算法,无法解码出原文,它的作用是校验token有没有被篡改。服务端获取header中的加密算法之后,利用该算法加上secretKey
对header
、payload
进行加密,比对加密后的数据和客户端发送过来的是否一致。注意secretKey只能保存在服务端,而且对于不同的加密算法其含义有所不同,一般对于MD5类型的摘要加密算法,secretKey实际上代表的是盐值
1.5 JWT的种类
其实JWT(JSON Web Token)指的是一种规范,这种规范允许我们使用JWT在两个组织之间传递安全可靠的信息,JWT的具体实现可以分为以下几种:
nonsecure JWT
:未经过签名,不安全的JWT
JWS
:经过签名的JWT
JWE
:payload
部分经过加密的JWT
1.5.1 nonsecure JWT
未经过签名,不安全的JWT。其
header
部分没有指定签名算法,并且也没有Signature
部分,签名本身不会进行Base64编码
{ "alg": "none", "typ": "JWT" }
1.5.2 JWS
JWS ,也就是JWT Signature,其结构就是在之前nonsecure JWT的基础上,在头部声明签名算法,并在最后添加上签名。
创建签名,是保证jwt不能被他人随意篡改
。我们通常使用的JWT一般都是JWS
为了完成签名,除了用到header信息和payload信息外,还需要算法的密钥,也就是secretKey。加密的算法一般有2类
- 对称加密:
secretKey
指加密密钥,可以生成签名与验签- 非对称加密:
secretKey
指私钥,只用来生成签名,不能用来验签(验签用的是公钥
)JWT的密钥或者密钥对,一般统一称为JSON Web Key,也就是JWK
到目前为止,jwt的签名算法有三种:
- HMAC【哈希消息验证码(对称)】:HS256/HS384/HS512
- RSASSA【RSA签名算法(非对称)】(RS256/RS384/RS512)
- ECDSA【椭圆曲线数据签名算法(非对称)】(ES256/ES384/ES512)
官网推荐了6个Java使用JWT的开源库,其中比较推荐使用的是
java-jwt
和jjwt-root![
](https://img-blog.csdnimg.cn/direct/80f3223d39d04800b48d277c2214089b.png)
2. 使用
<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>4.4.0</version>
</dependency>
2.1 加密
@Test
public void testGenerateToken() {
// 指定token过期时间为10秒
Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.SECOND, 10);
String token = JWT.create()
.withHeader(new HashMap<>()) // Header
.withClaim("userId", 21) // Payload
.withClaim("userName", "baobao123")
.withExpiresAt(calendar.getTime()) // 过期时间
.sign(Algorithm.HMAC256("!34ADAS")); // 签名用的secret
System.out.println(token);
}
2.2 解密
@Test
public void testResolveToken() throws UnsupportedEncodingException {
// 创建解析对象,使用的算法和secret要与创建token时保持一致
// JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256("!34ADAS")).build();
JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256("91c47edeb11281a9")).build();
// 解析指定的token
DecodedJWT decodedJWT = jwtVerifier.verify("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwaG9uZV9ubyI6IjE1OTM1MTUwNzcxIiwidXNlcl9pZCI6IjE1OTM1MTUwNzcxIiwiZXhwIjoxNzE1MjI2MzEyfQ.OO43ZMm7tm6v3G4sS-gU0AGVESFHRUYOS3ngjoBh7mw");
// 获取解析后的token中的payload信息
Claim userId = decodedJWT.getClaim("phone_no");
Claim userName = decodedJWT.getClaim("user_id");
System.out.println(userId.asInt());
System.out.println(userName.asString());
// 输出超时时间
System.out.println(decodedJWT.getExpiresAt());
String payload = decodedJWT.getPayload();
byte[] decode1 = Base64.getDecoder().decode(payload.getBytes("UTF-8"));
System.out.println(new String(decode1));
}
2.3 对称加密工具类
//对称加密
public class JWTUtils {
// 签名密钥
private static final String SECRET = "91c47edeb11281a9";
/**
* 生成token
* @param payload token携带的信息
* @return token字符串
*/
public static String getToken(Map<String,String> payload){
// 指定token过期时间为7天
Calendar calendar = Calendar.getInstance();
calendar.add(Calendar.DATE, 7);
JWTCreator.Builder builder = JWT.create();
// 构建payload
payload.forEach((k,v) -> builder.withClaim(k,v));
// 指定过期时间和签名算法
String token = builder.withExpiresAt(calendar.getTime()).sign(Algorithm.HMAC256(SECRET));
return token;
}
/**
* 解析token
* @param token token字符串
* @return 解析后的token
*/
public static DecodedJWT decode(String token){
JWTVerifier jwtVerifier = JWT.require(Algorithm.HMAC256(SECRET)).build();
DecodedJWT decodedJWT = jwtVerifier.verify(token);
return decodedJWT;
}
}