JWT Token 认证

老谭TYH

已于 2022-11-04 15:27:49 修改

阅读量455

点赞数 1

分类专栏： JAVA 文章标签：服务器运维

于 2022-11-04 15:23:49 首次发布

原文链接：http://www.ruanyifeng.com/blog/2018/07/json_web_token-tutorial.html

版权

JAVA 专栏收录该内容

122 篇文章 4 订阅

订阅专栏

一、JWT 介绍

转：JSON Web Token 入门教程 - 阮一峰的网络日志

JWT是一种通用的规范，它定义了Token的生成方式。

1、JWT 的原理

JWT 的原理是，服务器认证以后，生成一个 JSON 对象，发回给用户，就像下面这样。


{
  "姓名": "张三",
  "角色": "管理员",
  "到期时间": "2018年7月1日0点0分"
}

以后，用户与服务端通信的时候，都要发回这个 JSON 对象。服务器完全只靠这个对象认定用户身份。为了防止用户篡改数据，服务器在生成这个对象的时候，会加上签名（详见后文）。

服务器就不保存任何 session 数据了，也就是说，服务器变成无状态了，从而比较容易实现扩展。

2、JWT 的数据结构

实际的 JWT 大概就像下面这样。

它是一个很长的字符串，中间用点（.）分隔成三个部分。注意，JWT 内部是没有换行的，这里只是为了便于展示，将它写成了几行。

JWT 的三个部分依次如下。

Header（头部）
Payload（负载）
Signature（签名）

写成一行，就是下面的样子。


Header.Payload.Signature

下面依次介绍这三个部分。

2.1 Header

Header 部分是一个 JSON 对象，描述 JWT 的元数据，通常是下面的样子。


{
  "alg": "HS256",
  "typ": "JWT"
}

上面代码中，alg属性表示签名的算法（algorithm），默认是 HMAC SHA256（写成 HS256）；typ属性表示这个令牌（token）的类型（type），JWT 令牌统一写为JWT。

最后，将上面的 JSON 对象使用 Base64URL 算法（详见后文）转成字符串。

2.2 Payload

Payload 部分也是一个 JSON 对象，用来存放实际需要传递的数据。JWT 规定了7个官方字段，供选用。

iss (issuer)：签发人
exp (expiration time)：过期时间
sub (subject)：主题
aud (audience)：受众
nbf (Not Before)：生效时间
iat (Issued At)：签发时间
jti (JWT ID)：编号

除了官方字段，你还可以在这个部分定义私有字段，下面就是一个例子。


{
  "sub": "1234567890",
  "name": "John Doe",
  "admin": true
}

注意，JWT 默认是不加密的，任何人都可以读到，所以不要把秘密信息放在这个部分。

这个 JSON 对象也要使用 Base64URL 算法转成字符串。

2.3 Signature

Signature 部分是对前两部分的签名，防止数据篡改。

将编码后的Header、Payload由“.”符号进行拼接，将拼接后的字符串使用加密算法进行加密

首先，需要指定一个密钥（secret）。这个密钥只有服务器才知道，不能泄露给用户。然后，使用 Header 里面指定的签名算法（默认是 HMAC SHA256），按照下面的公式产生签名。


HMACSHA256(
  base64UrlEncode(header) + "." +
  base64UrlEncode(payload),
  secret)

算出签名以后，把 Header、Payload、Signature 三个部分拼成一个字符串，每个部分之间用"点"（.）分隔，就可以返回给用户。

2.4 Base64URL

前面提到，Header 和 Payload 串型化的算法是 Base64URL。这个算法跟 Base64 算法基本类似，但有一些小的不同。

JWT 作为一个令牌（token），有些场合可能会放到 URL（比如 api.example.com/?token=xxx）。Base64 有三个字符+、/和=，在 URL 里面有特殊含义，所以要被替换掉：=被省略、+替换成-，/替换成_ 。这就是 Base64URL 算法。

{{base64Encode(Header)}}.{{base64Encode(Payload)}}.{{Signature}}

将编码后的Header、编码后的Payload以及Signature由符号“.”进行拼接，形成最终的Token。

三、JWT 的使用方式

客户端收到服务器返回的 JWT，可以储存在 Cookie 里面，也可以储存在 localStorage。

此后，客户端每次与服务器通信，都要带上这个 JWT。你可以把它放在 Cookie 里面自动发送，但是这样不能跨域，所以更好的做法是放在 HTTP 请求的头信息Authorization字段里面。


Authorization: Bearer <token>

另一种做法是，跨域的时候，JWT 就放在 POST 请求的数据体里面。

四、JWT 的几个特点

（1）JWT 默认是不加密，但也是可以加密的。生成原始 Token 以后，可以用密钥再加密一次。

（2）JWT 不加密的情况下，不能将秘密数据写入 JWT。

（3）JWT 不仅可以用于认证，也可以用于交换信息。有效使用 JWT，可以降低服务器查询数据库的次数。

（4）JWT 的最大缺点是，由于服务器不保存 session 状态，因此无法在使用过程中废止某个 token，或者更改 token 的权限。也就是说，一旦 JWT 签发了，在到期之前就会始终有效，除非服务器部署额外的逻辑。

（5）JWT 本身包含了认证信息，一旦泄露，任何人都可以获得该令牌的所有权限。为了减少盗用，JWT 的有效期应该设置得比较短。对于一些比较重要的权限，使用时应该再次对用户进行认证。

（6）为了减少盗用，JWT 不应该使用 HTTP 协议明码传输，要使用 HTTPS 协议传输。

五、Token在用户验证中真正的使用

转：【JAVA】基于Token的用户验证_逛街的猫啊的博客-CSDN博客_java token验证

4.1 Token的第一次签发

当服务端收到登陆请求，需要在后台验证账户信息。若是验证通过，则生成Token，除了固定的信息外，还会放置一些与用户相关的信息，通常就是放置用户的ID。

将生成的Token返回前端，一般是将Token放置在response的header中。同时，浏览器在下一次请求也是将Token放置在请求头中。

4.2 Token的验证

客户端请求资源时，需要对客户端的用户进行验证。有些请求是不需要的验证用户（比如登陆请求，不需要验证用户，此时本就没有用户登陆），有些资源是需要验证的，所以需要对URL进行区分。

Teken的验证我选择在拦截器中实现（HandlerInterceptor），在这里对URL进行拦截。首先判断是否是需要验证的URL，然后对Token进行验证。对于Token的验证分为成功验证、无效验证、超时验证、刷新处理、主动失效处理。

4.3 Token验证方式的选择：

第一种验证方式：利用session

在服务器端，生成Token的同时将Token存入session。当收到客户端上传的Token时，将它与session中的进行比对，一致则合法，验证通过。否则，返回验证失败，前端跳转到登陆页面。

第二种验证方式：算法验证

当收到客户端上传的Token时，对Token的前两部分进行加密，比对加密结果是否与第三部分相同，相同则验证通过。否则，返回验证失败，前端跳转到登陆页面。

备注：为了项目的扩展性考虑，采用第二种方式进行验证。第一种方式依赖于Session，做负载均衡时，当请求被转发到另一台服务器时，由于Session中没有Token信息，会造成成验证不通过。

成功验证：

保证Token是正确的有两个因素：

第一：这个Token能够正确被Token识别，即这个Token的确是由自身的后台签发的；

第二：这个Toen没有过期。

一般的只要这个能够被后台使用自身的密钥+算法正确解密，即可认为这个Token是由自身签发。

Token的失效：

一般都会为Token添加有效时间区间，即在某个时间区间这个Token是有效的，过了这个时间点后，即认为这是一个不可信任的Token。

无效验证：

不能被正确解析的Token、以及超时的Token，既是验证不通过。

超时验证：

默认每一个Token都会为它添加有效时间，当超过生效时间，则认为此Token验不通过。
一般的，在生成Token时，会在Payload中设置过期时间，在拦截器中，根据这个时间验证是否超时。

4.4 刷新处理：

因为业务的需要，不能要求每次Token超时后，用户再次登陆。所以，需要在用户无感知情况下自动刷新Token，避免用户再次发起登陆请求。

第一种方式：通过算法计算

将过期周期认为是2T，当在T-2T时间区间时，认为此时需要刷新Token。当此Token验证通过，则在后台生成新的Token，随着header返回到前端，前端自己去刷新Token。

这种方式有个缺点，即只要不是超时的Token_A，依然可以正常的请求后台资源。即，假如在T-2T时间区间刷新Token，产生了新的Token_B，此时Token_A依然是有效的Token。

第二种方式：配合内存、数据库刷新Token

预先将生成的Token存储在内存、或数据库中，在拦截器中验证时，多加一个验证，即前端上报的Token必须与内存或数据库中Token保持一致，否则验证不通过。

备注：第一种方式虽然会造成旧的Token可以一直使用，但是有利于分布式部署。另外存在数据库可是也可以，对分布式没有影响（使用同一个数据库的话）。但是当存储在内存当中（比如Session）时，对分布式就不太友好了。

4.5 主动失效：

一般管理系统都会有用户注销功能，这时，需要主动让Token失效。这时需要配合内存、数据库实现，即在内存、数据库中保存一份最新的、有效的Token，当注销时，将存储的Token清空。同时在拦截器验证时，发现内存、数据库的Token是空值时，则验证不通过。

六、JWT工具

引包

<dependency>
<groupId>com.auth0</groupId>
<artifactId>java-jwt</artifactId>
<version>3.8.2</version>
</dependency>

public class JWTUtils {
    //设置过期时间
    private static final long EXPIRE_TIME = 30 * 60 * 1000; //半小时
    //token秘钥
    private static final String TOKEN_SECRET = "xxxxxxxxxx";

    public static String sign(String userName, String passWord) {
        String token = "";
        try {
            //过期时间
            Date date = new Date(System.currentTimeMillis() + EXPIRE_TIME);
            //秘钥及加密算法
            Algorithm algorithm = Algorithm.HMAC256(TOKEN_SECRET);
            //设置头部信息
            Map<String, Object> header = new HashMap<>(2);
            header.put("typ", "JWT");
            header.put("alg", "HS256");
            //携带username,password信息，生成签名
            return "Bearer " + JWT.create()
                    .withHeader(header)
                    .withClaim("userName", userName)
//                    .withClaim("passWord", passWord)
                    .withExpiresAt(date)
                    .withIssuer("xxx")
                    .withIssuedAt(new Date())
                    .withSubject("xxxx")
                    .sign(algorithm);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }

    /**
     * @desc   验证token，通过返回true
     * @params [token]需要校验的串
     **/
    public static boolean verify(String token){
        try {
            token = safeToken(token);
            Algorithm algorithm = Algorithm.HMAC256(TOKEN_SECRET);
            JWTVerifier verifier = JWT.require(algorithm).build();
            DecodedJWT jwt = verifier.verify(token);
            return true;
        }catch (Exception e){
            e.printStackTrace();
            return false;
        }
    }

    /**
     * @desc 判断token是否过期
     */
    public static boolean isJwtExpired(String token){
        try {
            token = safeToken(token);
            DecodedJWT decodeToken = JWT.decode(token);
            return decodeToken.getExpiresAt().before(new Date());
        } catch(Exception e){
            return true;
        }
    }

    /**
     * @desc   解密token，返回一个map
     * @params [token]需要校验的串
     **/
    public static String getUserName(String token){
        token = safeToken(token);
        DecodedJWT decodeToken = JWT.decode(token);
        return decodeToken.getClaim("userName").asString();
    }

    public static String getPassWord(String token){
        token = safeToken(token);
        DecodedJWT decodeToken = JWT.decode(token);
        return decodeToken.getClaim("passWord").asString();
    }

    public static String safeToken(String token){
        return token.replace("Bearer ","").replace("Bearer%20", "");
    }
}