JWT鉴权实战

淡淡的烟草味﹌ 2022-11-21 14:02 237阅读 0赞

# **目录** #

*  目标
 *  JWT简介
 *  JWT的优点
 *  JWT的数据结构
 *  JWT登录鉴权流程
 *  代码
 *  官网解析Token

--------------------

# 目标 #

1.  熟悉JWT鉴权流程，能通过代码实现项目上的鉴权（这里以登录作为案例讲解，拦截器实现略。）。

--------------------

# JWT简介 #

JWT即Json Web Token的缩写，在Web应用中，将数据以Json格式进行传输，通过加密、签名等算法保证数据传输的安全性。

--------------------

# JWT的优点 #

1.  共享会话：前端保存token，避免了为分布式系统做会话共享的操作；
2.  跨语言：Json格式的通用性决定了这一特性；
3.  减少数据访问：用户信息保存在token中，避免多次去数据库查询用户信息。

--------------------

# JWT的数据结构 #

![20201106003722315.png][]

1.  **头部（Base64编码）**：使用了哪一种签名算法和令牌。
2.  **有效载荷（Base64编码）**：可自定义内容，一般存放用户的非敏感（如：姓名、角色等）信息，而敏感信息（如：密码、手机号等）是不推荐存放的。
3.  **验证签名**：包含：头部（Base64编码）、有效载荷（Base64编码）、密钥，然后使用我们指定的签名算法加密。

--------------------

# JWT登录鉴权流程 #

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NzA2NTcw_size_16_color_FFFFFF_t_70][]

--------------------

# 代码 #

package com.ctx.jwt.auth;
    
    import com.auth0.jwt.JWT;
    import com.auth0.jwt.JWTCreator;
    import com.auth0.jwt.JWTVerifier;
    import com.auth0.jwt.algorithms.Algorithm;
    import com.auth0.jwt.exceptions.AlgorithmMismatchException;
    import com.auth0.jwt.exceptions.SignatureVerificationException;
    import com.auth0.jwt.exceptions.TokenExpiredException;
    import com.auth0.jwt.interfaces.DecodedJWT;
    
    import java.text.SimpleDateFormat;
    import java.util.Calendar;
    import java.util.Date;
    import java.util.HashMap;
    import java.util.Map;
    
    public class JWTUtils {
        //注意：密钥一定要复杂且保密。
        private static final String SIGN = "123456";
    
        public static void main(String[] args) {
            //生成token
            String jwt = JWTUtils.getJWT();
            System.out.println(jwt);
            //验证token
            Map<String, Object> map = JWTUtils.checkToken(jwt);
            System.out.println(map);
            //获取token信息
            Map<String, Object> tokenInfo = tokenInfo(jwt);
            System.out.println(tokenInfo);
        }
    
        //生成JWT（实际项目中放在登录成功后执行，并将其返回给前端。）
        public static String getJWT() {
            Map<String, String> map = new HashMap<>();
            map.put("loginName", "huangshang");
            map.put("studentName", "黄裳");
            //过期时间(我这里设置2秒后过期。方便调试看结果。)
            Calendar c = Calendar.getInstance();
            c.add(Calendar.SECOND, 2);
    
            //创建一个JWT
            JWTCreator.Builder builder = JWT.create();
            //有效载荷部分（我这里自定义有效载荷的内容(非敏感信息)是：登录名、学生姓名。）
            for (Object key : map.keySet()) {
                builder.withClaim((String) key, map.get(key));
            }
    
            //token过期时间（也可以不设置过期时间，这里根据登录业务明显需要。）
            builder.withExpiresAt(c.getTime());
            //算法签名部分（自定义算法和密钥，注意：密钥一定要复杂且保密。）
            String token = builder.sign(Algorithm.HMAC256(SIGN));
            return token;
        }
    
        //验证token
        public static Map<String, Object> checkToken(String token) {
            Map<String, Object> map = new HashMap<>();
            map.put("result", true);
            //创建验证对象
            JWTVerifier v = JWT.require(Algorithm.HMAC256(SIGN)).build();
            try {
                DecodedJWT decodedJWT = v.verify(token);
            } catch (TokenExpiredException e) {
                map.put("msg", "token过期");
                map.put("result", false);
            } catch (SignatureVerificationException e) {
                map.put("msg", "无效签名");
                map.put("result", false);
            } catch (AlgorithmMismatchException e) {
                map.put("msg", "算法不一致");
                map.put("result", false);
            } catch (Exception e) {
                map.put("msg", "无效的token");
                map.put("result", false);
            }
            return map;
        }
    
    
        //获取token信息
        public static Map<String, Object> tokenInfo(String token) {
            Map<String, Object> map = new HashMap<>();
            map.put("result", true);
            //创建验证对象
            JWTVerifier v = JWT.require(Algorithm.HMAC256(SIGN)).build();
            try {
                DecodedJWT decodedJWT = v.verify(token);
                String loginName = decodedJWT.getClaim("loginName").asString();
                String studentName = decodedJWT.getClaim("studentName").asString();
                String date = stampToDate(decodedJWT.getExpiresAt());
                map.put("loginName", loginName);
                map.put("studentName", studentName);
                map.put("date", date);
            } catch (TokenExpiredException e) {
                map.put("msg", "token过期");
                map.put("result", false);
            } catch (SignatureVerificationException e) {
                map.put("msg", "无效签名");
                map.put("result", false);
            } catch (AlgorithmMismatchException e) {
                map.put("msg", "算法不一致");
                map.put("result", false);
            } catch (Exception e) {
                map.put("msg", "无效的token");
                map.put("result", false);
            }
    
            return map;
        }
    
    
        public static String stampToDate(Date date) {
            SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            String dateString = simpleDateFormat.format(date);
            return dateString;
        }
    }

--------------------

# 官网解析Token #

点击进入[JWT官网][JWT]；

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NzA2NTcw_size_16_color_FFFFFF_t_70 1][]

[20201106003722315.png]: /images/20221120/6ae9bf813aa94c84928673ddd6836af3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NzA2NTcw_size_16_color_FFFFFF_t_70]: /images/20221120/17ae3b6e5e13490aa0439d788b6a184d.png
[JWT]: https://jwt.io/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzM5NzA2NTcw_size_16_color_FFFFFF_t_70 1]: /images/20221120/568478e77961444cb716a74e81ed863e.png