SpringBoot 如何使用 JWT 保护 Rest Api 接口

这篇文章将为大家详细讲解有关SpringBoot 如何使用 JWT 保护 Rest Api 接口，小编觉得挺实用的，因此分享给大家做个参考，希望大家阅读完这篇文章后可以有所收获。

SpringBoot 使用 JWT 保护 REST API 接口

简介

JSON Web 令牌 (JWT) 是一种用于在网络应用程序中安全传输信息的小型、自包含且加密的令牌。它通常用于验证用户身份和授权访问受保护的 API 端点。SpringBoot 是一个流行的 Java 框架，它提供了内建的支持来使用 JWT 保护 REST API 接口。

JWT 结构

JWT 由三个部分组成：

• 头部：包含 JWT 的元数据，如算法类型和令牌类型。
• 主体：包含有关用户的已声明信息，如用户名、角色和权限。
• 签名：使用头部中指定的算法对前两个部分进行签名。

使用 SpringBoot 实现 JWT

在 SpringBoot 中，可以使用以下步骤实现 JWT 保护：

1. 引入依赖关系

在 Maven 项目中，添加以下依赖项：

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

2. 创建 JWT 服务

创建一个服务类来生成和验证 JWT 令牌：

@Service
public class JwtService {

    private final String secretKey;

    public JwtService(String secretKey) {
        this.secretKey = secretKey;
    }

    public String generateToken(UserDetails userDetails) {
        // ...
    }

    public boolean validateToken(String token) {
        // ...
    }
}

3. 配置安全过滤器

在 WebSecurityConfigurerAdapter 类中，配置一个安全过滤器来拦截和验证 JWT 令牌：

@Override
protected void configure(HttpSecurity http) {
    http
        .csrf().disable()
        .authorizeRequests()
        .antMatchers("/protected/**").authenticated()
        .and()
        .addFilterBefore(new JwtAuthenticationFilter(jwtService), UsernamePasswordAuthenticationFilter.class);
}

4. 使用 JWT 令牌

在受保护的控制器方法中，使用 JWT 令牌进行身份验证和授权：

@GetMapping("/protected")
public ResponseEntity<String> protectedEndpoint() {
    // 从上下文中获取已认证的 Principal 对象
    Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
    // 从 Principal 对象中获取 JWT 令牌
    String token = authentication.getCredentials().toString();
    // 验证 JWT 令牌
    if (jwtService.validateToken(token)) {
        // 继续处理请求
    } else {
        // 返回未经授权的响应
        return ResponseEntity.status(HttpStatus.UNAUTHORIZED).build();
    }
}

优点

使用 JWT 保护 REST API 接口具有以下优点：

• 无状态： JWT 不存储在服务器端，因此简化了会话管理。
• 轻量级： JWT 非常小巧，不会对应用程序性能产生重大影响。
• 可扩展： JWT 可以扩展以包含有关用户的自定义信息。
• 安全： JWT 使用数字签名来确保令牌的完整性和真实性。

最佳实践

以下是一些使用 JWT 保护 REST API 接口的最佳实践：

• 使用强加密算法（例如 HS256 或 RS256）。
• 设置合理的 JWT 过期时间。
• 定期轮换 JWT 密钥。
• 在 HTTP 响应头中使用 Authorization: Bearer <token> 格式发送 JWT 令牌。

以上就是SpringBoot 如何使用 JWT 保护 Rest Api 接口的详细内容，更多请关注编程学习网其它相关文章！