正文

新手必看：轻松掌握Boot集成Shiro，安全认证一步到位

/0 浏览量
0904

在当今互联网时代，安全认证是每个应用程序不可或缺的部分。Apache Shiro 是一个强大的安全框架，它提供了身份验证、授权、会话管理和加密等功能。而 Spring Boot 则是一个简化 Spring 应用的开发过程的开源框架。将 Shiro 与 Spring Boot 集成，可以轻松实现安全认证功能。本文将为您详细介绍如何轻松掌握 Boot 集成 Shiro，实现安全认证一步到位。

一、Shiro 简介

Shiro 是一个开源的安全框架，它提供了认证、授权、会话管理和加密等安全功能。Shiro 的核心组件包括：

  • Subject：当前用户
  • SecurityManager：安全管理的核心，负责管理内部组件的交互
  • Realm：用于认证和授权的组件
  • SessionManager：会话管理组件
  • CacheManager：缓存管理组件

二、Spring Boot 集成 Shiro

1. 添加依赖

首先，您需要在 Spring Boot 项目中添加 Shiro 的依赖。以下是 Maven 项目的依赖配置：

<dependencies>
    <dependency>
        <groupId>org.apache.shiro</groupId>
        <artifactId>shiro-spring-boot-web-starter</artifactId>
        <version>1.8.0</version>
    </dependency>
</dependencies>

2. 配置 Shiro

在 application.properties 或 application.yml 文件中配置 Shiro 相关参数：

# Shiro 配置
shiro.loginUrl=/login
shiro.unauthorizedUrl=/unauthorized
shiro.sessionTimeout=1800
shiro.cacheManager=org.apache.shiro.cache.ehcache.EhCacheManager

3. 创建 Realm

创建一个自定义的 Realm 类，实现 AuthenticationRealm 接口，用于处理认证和授权逻辑：

import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.AuthenticationToken;
import org.apache.shiro.authc.SimpleAuthenticationInfo;
import org.apache.shiro.authz.AuthorizationInfo;
import org.apache.shiro.authz.SimpleAuthorizationInfo;
import org.apache.shiro.realm.AuthenticatingRealm;
import org.apache.shiro.subject.PrincipalCollection;

public class CustomRealm extends AuthenticatingRealm {

    @Override
    protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {
        // 获取用户名和密码
        String username = (String) token.getPrincipal();
        String password = new String((char[]) token.getCredentials());

        // 根据用户名查询用户信息
        // ...

        // 返回认证信息
        return new SimpleAuthenticationInfo(username, password, getName());
    }

    @Override
    protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {
        // 获取用户信息
        String username = (String) principals.getPrimaryPrincipal();

        // 根据用户名查询用户权限
        // ...

        // 返回授权信息
        return new SimpleAuthorizationInfo();
    }
}

4. 配置 Shiro Filter

在 WebSecurityConfig 类中配置 Shiro Filter：

import org.apache.shiro.web.filter.authc.FormAuthenticationFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebSecurityConfig implements WebMvcConfigurer {

    @Bean
    public CustomRealm customRealm() {
        return new CustomRealm();
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new ShiroInterceptor()).addPathPatterns("/**");
    }
}

5. 使用 Shiro 注解

在控制器中使用 Shiro 注解实现权限控制：

import org.apache.shiro.authz.annotation.RequiresPermissions;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class UserController {

    @GetMapping("/user")
    @RequiresPermissions("user:view")
    public String getUser() {
        return "User info";
    }
}

三、总结

通过以上步骤，您已经成功将 Shiro 集成到 Spring Boot 项目中，并实现了安全认证功能。在实际项目中，您可以根据需求进行扩展和定制。希望本文能帮助您轻松掌握 Boot 集成 Shiro，实现安全认证一步到位。

-- 展开阅读全文 --