身份认证与应用安全 / 系统课时

登录成功后签发访问令牌

登录成功后签发访问令牌

本节解决认证通过后如何生成 Access Token 并返回给前端的问题。完成后,你将能把用户标识、签发时间和过期时间写入 JWT,并把令牌封装进统一登录响应,同时避免把敏感或频繁变化的数据塞进 Token。

学习目标

  • 在用户名密码认证成功后签发带有效期的 JWT Access Token
  • 正确选择 sub、iat、exp 等核心声明
  • 通过统一登录响应向前端返回令牌类型和有效期

把签发放在认证成功之后

JWT 的签发动作应发生在服务器已经确认用户身份之后。典型登录链路是:接收用户名密码、查询用户、校验密码和账号状态,全部通过后才调用令牌服务。Token 不是密码校验工具,而是认证成功后由服务器签发的后续访问凭证。

登录成功后签发 Access Token 的流程

在 JWT 中,最适合充当用户身份主键的是标准声明 sub。iat 表示签发时间,exp 表示过期时间。对于访问令牌,通常只携带请求鉴权真正需要的数据,不应放入密码、手机号等敏感信息,也不宜复制完整用户资料。

声明 用途 示例
sub 标识当前用户 1001
iat 记录签发时间 当前时间
exp 限制令牌有效期 当前时间加 15 分钟

如果把角色、权限等频繁变化的数据写进 JWT,需要接受一个事实:服务端修改权限后,旧 Token 中的数据不会自动更新,只能等待令牌过期或额外实现撤销机制。

完成一个可执行签发示例

下面示例使用 JJWT 0.12.x API,假定 Spring Boot 工程已经引入对应的 jjwt-api、jjwt-impl 和 jjwt-jackson 依赖。示例密钥仅用于本地演示,HS256 至少需要 256 位密钥,生产环境应从环境变量或 Secret 管理系统读取。

java
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.security.Keys;

import javax.crypto.SecretKey;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.time.Instant;
import java.util.Date;

public class JwtIssueDemo {
    private static final SecretKey KEY = Keys.hmacShaKeyFor(
            "0123456789abcdef0123456789abcdef"
                    .getBytes(StandardCharsets.UTF_8));

    public static String issueAccessToken(String userId, Duration ttl) {
        Instant now = Instant.now();

        return Jwts.builder()
                .subject(userId)
                .issuedAt(Date.from(now))
                .expiration(Date.from(now.plus(ttl)))
                .signWith(KEY)
                .compact();
    }

    public record LoginResponse(
            String accessToken,
            String tokenType,
            long expiresIn) {
    }

    public static void main(String[] args) {
        Duration ttl = Duration.ofMinutes(15);
        String token = issueAccessToken("1001", ttl);

        LoginResponse response = new LoginResponse(
                token,
                "Bearer",
                ttl.toSeconds());

        System.out.println("tokenType=" + response.tokenType());
        System.out.println("expiresIn=" + response.expiresIn());
        System.out.println("accessToken="
                + (response.accessToken().startsWith("eyJ") ? "<TOKEN>" : "invalid"));
    }
}

预期输出(实际 JWT 字符串会随签发时间和签名变化):

text
tokenType=Bearer
expiresIn=900
accessToken=<TOKEN>

这里的 expiresIn 使用秒数,便于前端计算令牌剩余时间;真正决定服务端是否接受 Token 的仍然是 JWT 内部的 exp。两者应来自同一个 TTL 配置,避免登录响应显示 15 分钟、实际 Token 却签发成其他时长。

返回统一登录响应

认证控制器在用户校验成功后,只需要调用类似 issueAccessToken(userId, ttl) 的方法,再返回 LoginResponse。前端拿到结果后通常把令牌用于后续请求的 Authorization: Bearer <TOKEN> 请求头,而不是再次发送用户名和密码。

Access Token 的有效期应根据风险和用户体验确定,15 分钟只是演示值。无论选择多长时间,都应保证签发端和校验端使用一致的密钥、算法和时间策略,并让客户端把令牌当作不透明凭证,而不是自行修改其中的声明。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

登录成功后签发访问令牌

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通