1、使用JWT进行用户登录
用于本项目使用的是多微服务架构,所以在用户进行登录的时候,微服务与微服务之间是没有联系的,那么怎么才能在用户进行登录之后,让其他的微服务知道这个用户登录了呢,这里就可使用jwt。
我们之前已经搭建过了网关,使用网关在网关系统中比较适合进行权限校验。
上图的执行过程:
- 用户访问顶订单系统/api/order
- 网关判断没有权限,返回让用户去登录
- 用户访问登录页面/api/user/login 网关进行判断,如果是登录请求则进行放行
- 用户微服务执行登录动作
- 登录成功 残生一个令牌 返回给用户
- 携带令牌继续访问
- 网关进行解析
1.1 什么是JWT
JSON Web Token(JWT)是一个非常轻巧的规范。这个规范允许我们使用JWT在用户和服务器之间传递安全可靠的信息。
1.2 jwt的构成
一个JWT实际上就是一个字符串,它由三部分组成,头部、载荷与签名。
头部(Header)
头部用于描述关于该JWT的最基本的信息,例如其类型以及签名所用的算法等。这也可以被表示成一个JSON对象。
{"typ":"JWT","alg":"HS256"}
在头部指明了签名算法是HS256算法。 我们进行BASE64编码http://base64.xpcha.com/,编码后的字符串如下:
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9
小知识:Base64是一种基于64个可打印字符来表示二进制数据的表示方法。由于2的6次方等于64,所以每6个比特为一个单元,对应某个可打印字符。三个字节有24个比特,对应于4个Base64单元,即3个字节需要用4个可打印字符来表示。JDK 中提供了非常方便的 BASE64Encoder 和 BASE64Decoder,用它们可以非常方便的完成基于 BASE64 的编码和解码
载荷(playload)
载荷就是存放有效信息的地方。这个名字像是特指飞机上承载的货品,这些有效信息包含三个部分
(1)标准中注册的声明(建议但不强制使用)
iss: jwt签发者
sub: jwt所面向的用户
aud: 接收jwt的一方
exp: jwt的过期时间,这个过期时间必须要大于签发时间
nbf: 定义在什么时间之前,该jwt都是不可用的.
iat: jwt的签发时间
jti: jwt的唯一身份标识,主要用来作为一次性token,从而回避重放攻击。
(2)公共的声明
公共的声明可以添加任何的信息,一般添加用户的相关信息或其他业务需要的必要信息.但不建议添加敏感信息,因为该部分在客户端可解密.
(3)私有的声明
私有声明是提供者和消费者所共同定义的声明,一般不建议存放敏感信息,因为base64是对称解密的,意味着该部分信息可以归类为明文信息。
这个指的就是自定义的claim。比如下面面结构举例中的admin和name都属于自定的claim。这些claim跟JWT标准规定的claim区别在于:JWT规定的claim,JWT的接收方在拿到JWT之后,都知道怎么对这些标准的claim进行验证(还不知道是否能够验证);而private claims不会验证,除非明确告诉接收方要对这些claim进行验证以及规则才行。
定义一个payload:
{"sub":"1234567890","name":"John Doe","admin":true}
然后将其进行base64加密,得到Jwt的第二部分。
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9
签证(signature)
jwt的第三部分是一个签证信息,这个签证信息由三部分组成:
header (base64后的)
payload (base64后的)
secret
这个部分需要base64加密后的header和base64加密后的payload使用.连接组成的字符串,然后通过header中声明的加密方式进行加盐secret组合加密,然后就构成了jwt的第三部分。
TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
将这三部分用.连接成一个完整的字符串,构成了最终的jwt:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
注意:secret是保存在服务器端的,jwt的签发生成也是在服务器端的,secret就是用来进行jwt的签发和jwt的验证,所以,它就是你服务端的私钥,在任何场景都不应该流露出去。一旦客户端得知这个secret, 那就意味着客户端是可以自我签发jwt了。
1.3 测试
(1)依赖引入
<!--鉴权-->
<dependency>
<groupId>io.jsonwebtoken</groupId>
<artifactId>jjwt</artifactId>
<version>0.9.0</version>
</dependency>
(2)创建token
@Test
public void createToken(){
// 1. 这是头部 默认不需要设置
JwtBuilder builder = Jwts.builder();
// 2. 设置载荷
builder
.setId("唯一的表示")
.setSubject("主题")
.setIssuer("yxinmiracle") // 签发者
.setIssuedAt(new Date()) // 设置签发日期 可要可不要
// 3. 设置签名
.signWith(SignatureAlgorithm.HS256,"yxinmiracle");
// 自定义Claims
Map<String, Object> map = new HashMap<>();
map.put("key1","value1");
map.put("key2","value2");
builder.addClaims(map);
// 4. 执行动作
String token = builder.compact();
System.out.println(token);
//eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiLllK_kuIDnmoTooajnpLoiLCJzdWIiOiLkuLvpopgiLCJpc3MiOiJ5eGlubWlyYWNsZSIsImlhdCI6MTYyOTAyMzc1MH0.cuOCbsdQpP9zuLadT-4F_kgA2Wpu6qJk72TDQKDFt7U
}
(3)解析token
@Test
public void parseToken(){
String token = "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiLllK_kuIDnmoTooajnpLoiLCJzdWIiOiLkuLvpopgiLCJpc3MiOiJ5eGlubWlyYWNsZSIsImlhdCI6MTYyOTAyNDU2OSwia2V5MSI6InZhbHVlMSIsImtleTIiOiJ2YWx1ZTIifQ.vCjCx3hn0eU1dNKNOzsByBPmkEAz0yMsEBr_0B36NaI";
// 解析
JwtParser parser = Jwts.parser();
// 设置签名的秘钥
Jws<Claims> yxinmiracle = parser
.setSigningKey("yxinmiracle")
.parseClaimsJws(token);
// 获取载荷信息
Claims body = yxinmiracle.getBody();
JwsHeader header = yxinmiracle.getHeader();
System.out.println(body); // {jti=唯一的表示, sub=主题, iss=yxinmiracle, iat=1629023750}
System.out.println(header); // {alg=HS256}
}
1.4 编写工具类
package com.yxinmiracle.util;
import io.jsonwebtoken.Claims;
import io.jsonwebtoken.JwtBuilder;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import javax.crypto.SecretKey;
import javax.crypto.spec.SecretKeySpec;
import java.util.Base64;
import java.util.Date;
/**
* @version 1.0
* @author: YxinMiracle
* @date: 2021-08-15 18:51
*/
public class JwtUtil {
//有效期为
public static final Long JWT_TTL = 3600000L;// 60 * 60 *1000 一个小时
//Jwt令牌信息
public static final String JWT_KEY = "yxinmiracle";
public static String createJWT(String id, String subject, Long ttlMillis) {
//指定算法
SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256;
//当前系统时间
long nowMillis = System.currentTimeMillis();
//令牌签发时间
Date now = new Date(nowMillis);
//如果令牌有效期为null,则默认设置有效期1小时
if(ttlMillis==null){
ttlMillis=JwtUtil.JWT_TTL;
}
//令牌过期时间设置
long expMillis = nowMillis + ttlMillis;
Date expDate = new Date(expMillis);
//生成秘钥
SecretKey secretKey = generalKey();
//封装Jwt令牌信息
JwtBuilder builder = Jwts.builder()
.setId(id) //唯一的ID
.setSubject(subject) // 主题 可以是JSON数据
.setIssuer("admin") // 签发者
.setIssuedAt(now) // 签发时间
.signWith(signatureAlgorithm, secretKey) // 签名算法以及密匙
.setExpiration(expDate); // 设置过期时间
return builder.compact();
}
/**
* 生成加密 secretKey
* @return
*/
public static SecretKey generalKey() {
byte[] encodedKey = Base64.getEncoder().encode(JwtUtil.JWT_KEY.getBytes());
SecretKey key = new SecretKeySpec(encodedKey, 0, encodedKey.length, "AES");
return key;
}
/**
* 解析令牌数据
* @param jwt
* @return
* @throws Exception
*/
public static Claims parseJWT(String jwt) throws Exception {
SecretKey secretKey = generalKey();
return Jwts.parser()
.setSigningKey(secretKey)
.parseClaimsJws(jwt)
.getBody();
}
}
login:
// 生成令牌返回给用户
Map<String,Object> info = new HashMap<>();
info.put("username",username);
info.put("role","ROLE_ADMIN");
String token = JwtUtil.createJWT(UUID.randomUUID().toString(), JSON.toJSONString(info), null);
return new Result(true, StatusCode.ERROR,"登录成功",token);