Jwt简单使用

我不是女神ヾ 2023-10-18 16:57 139阅读 0赞

### 在分布式项目中，经常需要处理session共享的问题，解决的方式有很多，比如采用session或者cookie，或者redis进行存储都是解决方案，今天给大家介绍另一种比较轻量级的解决方式，就是使用jwt生成token，服务端进行加解密来处理； ###

**首先要了解一下jwt的三个基本术语，**

**Header**

Header是由以下这个格式的Json通过Base64编码（编码不是加密，是可以通过反编码的方式获取到这个原来的Json，所以JWT中存放的一般是不敏感的信息）生成的字符串，Header中存放的内容是说明编码对象是一个JWT以及使用“SHA-256”的算法进行加密（加密用于生成Signature）

\{  
“typ”:“JWT”,  
“alg”:“HS256”  
\}

**Claim**

Claim是一个Json，Claim中存放的内容是JWT自身的标准属性，所有的标准属性都是可选的，可以自行添加，比如：JWT的签发者、JWT的接收者、JWT的持续时间等；同时Claim中也可以存放一些自定义的属性，这个自定义的属性就是在用户认证中用于标明用户身份的一个属性，比如用户存放在数据库中的id，为了安全起见，一般不会将用户名及密码这类敏感的信息存放在Claim中。将Claim通过Base64转码之后生成的一串字符串称作Payload。

\{  
“iss”:“Issuer —— 用于说明该JWT是由谁签发的”,  
“sub”:“Subject —— 用于说明该JWT面向的对象”,  
“aud”:“Audience —— 用于说明该JWT发送给的用户”,  
“exp”:“Expiration Time —— 数字类型，说明该JWT过期的时间”,  
“nbf”:“Not Before —— 数字类型，说明在该时间之前JWT不能被接受与处理”,  
“iat”:“Issued At —— 数字类型，说明该JWT何时被签发”,  
“jti”:“JWT ID —— 说明标明JWT的唯一ID”,  
“user-definde1”:“自定义属性举例”,  
“user-definde2”:“自定义属性举例”  
\}

**Signature**

Signature是由Header和Payload组合而成，将Header和Claim这两个Json分别使用Base64方式进行编码，生成字符串Header和Payload，然后将Header和Payload以Header.Payload的格式组合在一起形成一个字符串，然后使用上面定义好的加密算法和一个密匙（这个密匙存放在服务器上，用于进行验证）对这个字符串进行加密，形成一个新的字符串，这个字符串就是Signature。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70]

### JWT实现认证的原理 ###

服务器在生成一个JWT之后会将这个JWT会以Authorization : Bearer JWT 键值对的形式存放在cookies里面发送到客户端机器，在客户端再次访问收到JWT保护的资源URL链接的时候，服务器会获取到cookies中存放的JWT信息，首先将Header进行反编码获取到加密的算法，在通过存放在服务器上的密匙对Header.Payload 这个字符串进行加密，比对JWT中的Signature和实际加密出来的结果是否一致，如果一致那么说明该JWT是合法有效的，认证成功，否则认证失败。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70 1]

下面通过两个工具类来说明一下JWT的具体使用，首先需要导入jwt的jar包，

<dependency>
    	<groupId>io.jsonwebtoken</groupId>
    	<artifactId>jjwt</artifactId>
    	<version>0.9.1</version>
    </dependency>

/**
     * jwt工具类封装
     * @author asus
     *
     */
    public class JwtUtils {
    	
    	public static final String SUBJECT = "congge";
    	
    	/**
    	 * 设置token的过期时间
    	 */
    	public static final long EXPIRITION = 1000 * 24 * 60 * 60 * 7;
    	
    	/**
    	 * 秘钥，不同的环境应该配置不同的秘钥，注意保存好，不要泄露
    	 */
    	public static final String APPSECRET_KEY = "congge_secret";
    	
    	/**
    	 * 加密生成token
    	 * @param user
    	 * @return
    	 */
    	public static String generateJsonWebToken(Users user){
    		
    		if(user.getId() == null || user.getUsername()==null||user.getFaceImage()==null){
    			return null;
    		}
    		
    		String token = Jwts.builder().setSubject(SUBJECT)
    			.claim("id", user.getId())
    			.claim("name",user.getUsername())
    			.claim("img", user.getFaceImage())
    			.setIssuedAt(new Date())
    			.setExpiration(new Date(System.currentTimeMillis() + EXPIRITION ))
    			.signWith(SignatureAlgorithm.HS256, APPSECRET_KEY).compact();
    		return token;
    	}
    	
    	/**
    	 * 解密token获取用户信息
    	 * @param token
    	 * @return
    	 */
    	public static Claims checkJWT(String token){
    		try {
    			final Claims claims = Jwts.parser().setSigningKey(APPSECRET_KEY).parseClaimsJws(token).getBody();
    			return claims;
    		} catch (Exception e) {
    			e.printStackTrace();
    			return null;
    		}
    		
    	}
    	
    	/**
    	 * eyJhbGciOiJIUzI1NiJ9.
    	 * eyJzdWIiOiJjb25nZ2UiLCJpZCI6IjExMDExIiwibmFtZSI6Im51b3dlaXNpa2kiLCJpbWciOiJ3d3cudW9rby5jb20vMS5wbmciLCJpYXQiOjE1NTQ5OTI1NzksImV4cCI6MTU1NTU5NzM3OX0.
    	 * 6DJ9En-UBcTiMRldZeevJq3e1NxJgOWryUyim4_-tEE
    
    	 * @param args
    	 */
    	
    	public static void main(String[] args) {
    		
    		Users user = new Users();
    		user.setId("11011");
    		user.setUsername("nuoweisiki");
    		user.setFaceImage("www.uoko.com/1.png");
    		String token = generateJsonWebToken(user);
    		
    		System.out.println(token);
    		
    		System.out.println("解密 ====================");
    		
    		Claims claims = checkJWT(token);
    		if(claims != null){
    			String id = claims.get("id").toString();
    			String name = claims.get("name").toString();
    			String img = claims.get("img").toString();
    			
    			System.out.println("id:" + id);
    			System.out.println("name:" + name);
    			System.out.println("img:" + img);
    		}
    		
    	}
    	
    }

运行一下这段程序，可以看到如下结果，可以看出来，我们加密的用户信息是可以成功解密出来的，利用这个特性，可以将用户一些不敏感的信息通过jwt加解密的方式在客户端和服务端之间进行传递，就算是在分布式环境下，大家用的是同一套代码，加解密规则一样，因此对于同一个用户是可以很方便的进行操作，  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70 2]

那么实际业务中该如何使用呢？我认为可以存在这一一个场景，用户登录成功后，后端通过jwt产生一个token返回给客户端，客户端进行存储，以后每次访问相关资源时候，后端会有一个拦截器进行拦截，按照定义好的解密规则解密出用户信息，解密成功并且存在，则允许进行后续的操作，下面是一段模拟代码，有兴趣的小伙伴可以参考，

public class JwtInterceptor implements HandlerInterceptor{
    	
    	/**
    	 * 模拟拦截用户请求的url，并从url中读取前端传来的token，如果校验通过，则允许进行后续其他的操作
    	 */
    	@Override
    	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
    			throws Exception {
    		String token = request.getHeader("authorization");
    		Claims claims = JwtUtils.checkJWT(token);
    		String userId = claims.get("id").toString();
    		String userName = claims.get("name").toString();
    		String img = claims.get("img").toString();
    		UserService userService = SpringContextUtil.getBean("usersService");
    		Users user = userService.findById(userId);
    		if(user != null){
    			return true;
    		}else{	
    			//生成token的动作是不是应该在用户登录成功的时候产生呢？
    			return false;
    		}
    	}
    	
    }

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20190411224925549.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20190411225003829.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20190411225444136.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3poYW5nY29uZ3lpNDIw,size_16,color_FFFFFF,t_70