当前位置：首页 > news >正文

深入理解 Apache Shiro：安全框架全解析

news 来源：原创 2025/7/1 18:27:23

亲爱的小伙伴们😘，在求知的漫漫旅途中，若你对深度学习的奥秘、JAVA 、PYTHON与SAP 的奇妙世界，亦或是读研论文的撰写攻略有所探寻🧐，那不妨给我一个小小的关注吧🥰。我会精心筹备，在未来的日子里不定期地为大家呈上这些领域的知识宝藏与实用经验分享🎁。每一个点赞👍，都如同春日里的一缕阳光，给予我满满的动力与温暖，让我们在学习成长的道路上相伴而行，共同进步✨。期待你的关注与点赞哟🤗！

一、引言

在当今的软件开发领域，安全是至关重要的一环。无论是企业级应用还是普通的移动应用，都需要保护用户数据和系统资源免受非法访问。Apache Shiro 作为一款强大的 Java 安全框架，提供了全面的安全解决方案，涵盖了身份验证、授权、加密和会话管理等多个方面。在这篇博客中，我们将深入探讨 Shiro 的核心概念、架构以及如何在实际项目中应用它来构建安全的系统。

二、Shiro 核心概念

（一）Subject

Subject 是 Shiro 安全框架的核心概念之一，它代表了当前与系统进行交互的用户或实体。可以将其看作是一个安全上下文的持有者，通过它可以进行身份验证、授权、获取会话等操作。例如，在一个 Web 应用中，当一个用户发起请求时，Shiro 会创建一个对应的 Subject 对象来代表这个用户。

以下是一个简单的代码示例，展示如何获取当前的 Subject：

import org.apache.shiro.SecurityUtils;
import org.apache.shiro.subject.Subject;public class ShiroExample {public static void main(String[] args) {// 获取当前 SubjectSubject currentUser = SecurityUtils.getSubject();System.out.println("当前 Subject: " + currentUser);}
}

（二）SecurityManager

SecurityManager 是 Shiro 的核心组件，它负责协调和管理整个安全系统。它是 Shiro 架构的核心枢纽，所有的安全操作都通过它来进行调度和执行。它管理着所有的 Subject、Realm 以及其他安全组件之间的交互。

在 Shiro 的配置中，通常需要创建并配置一个 SecurityManager 实例。例如，在一个基于 Spring 的应用中，可以这样配置：

<bean id="securityManager" class="org.apache.shiro.web.mgt.DefaultWebSecurityManager"><property name="realm" ref="userRealm"/>
</bean>

这里的 userRealm 是一个自定义的 Realm，用于处理身份验证和授权信息。

（三）Realm

Realm 是 Shiro 进行身份验证和授权的数据源。它负责从数据库、文件系统或其他存储介质中获取用户的身份信息（如用户名、密码）和授权信息（如角色、权限）。可以将 Realm 看作是 Shiro 与实际数据存储之间的桥梁。

例如，我们可以创建一个简单的 Realm 来从内存中获取用户信息：

import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.AuthenticationToken;
import org.apache.shiro.authz.AuthorizationInfo;
import org.apache.shiro.realm.AuthorizingRealm;
import org.apache.shiro.subject.PrincipalCollection;import java.util.HashMap;
import java.util.Map;public class SimpleRealm extends AuthorizingRealm {private Map<String, String> userMap = new HashMap<>();public SimpleRealm() {userMap.put("user1", "password1");userMap.put("user2", "password2");}@Overrideprotected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {// 这里可以根据用户信息加载对应的角色和权限信息，暂时为空实现return null;}@Overrideprotected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {String username = (String) token.getPrincipal();String password = userMap.get(username);if (password!= null) {return new SimpleAuthenticationInfo(username, password, getName());} else {throw new AuthenticationException("用户不存在");}}
}

三、Shiro 架构

Shiro 的架构设计非常灵活和可扩展，主要由以下几个核心组件组成（如图 1 所示）：

Subject：如前所述，代表当前用户或实体。
SecurityManager：整个安全系统的核心管理者。
Realm：数据源，提供身份验证和授权数据。
Authenticator：负责处理身份验证逻辑，它会调用 Realm 来获取用户信息并进行验证。
Authorizer：负责处理授权逻辑，根据用户的角色和权限信息来决定是否允许访问特定资源。
SessionManager：管理用户会话，包括会话的创建、销毁、超时设置等。

当一个 Subject 发起一个安全操作（如访问受保护资源）时，请求会被传递到 SecurityManager。SecurityManager 首先会调用 Authenticator 进行身份验证，如果身份验证成功，再调用 Authorizer 进行授权检查。如果授权通过，Subject 就可以访问相应的资源。

四、身份验证

（一）身份验证流程

身份验证是确定用户身份的过程。在 Shiro 中，通常使用用户名和密码进行身份验证。其基本流程如下：

创建一个 UsernamePasswordToken，包含用户名和密码信息。
获取当前的 Subject。
通过 Subject 的 login 方法传入 UsernamePasswordToken 进行身份验证。

以下是代码示例：

import org.apache.shiro.SecurityUtils;
import org.apache.shiro.authc.UsernamePasswordToken;
import org.apache.shiro.subject.Subject;public class AuthenticationExample {public static void main(String[] args) {Subject currentUser = SecurityUtils.getSubject();// 创建用户名密码令牌UsernamePasswordToken token = new UsernamePasswordToken("user1", "password1");try {// 进行身份验证currentUser.login(token);System.out.println("身份验证成功");} catch (Exception e) {System.out.println("身份验证失败: " + e.getMessage());}}
}

（二）自定义身份验证策略

Shiro 允许我们自定义身份验证策略，以满足不同的业务需求。例如，我们可以实现一个多 Realm 身份验证策略，当多个 Realm 存在时，根据不同的规则来确定身份验证是否成功。

import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.AuthenticationInfo;
import org.apache.shiro.authc.AuthenticationToken;
import org.apache.shiro.authc.pam.ModularRealmAuthenticator;
import org.apache.shiro.realm.Realm;import java.util.ArrayList;
import java.util.Collection;public class MyModularRealmAuthenticator extends ModularRealmAuthenticator {@Overrideprotected AuthenticationInfo doAuthenticate(AuthenticationToken authenticationToken) throws AuthenticationException {// 获取所有的 RealmCollection<Realm> realms = getRealms();if (realms == null || realms.isEmpty()) {throw new AuthenticationException("没有配置 Realm");}ArrayList<AuthenticationInfo> infoList = new ArrayList<>();for (Realm realm : realms) {// 每个 Realm 进行身份验证AuthenticationInfo info = realm.getAuthenticationInfo(authenticationToken);if (info!= null) {infoList.add(info);}}if (infoList.isEmpty()) {throw new AuthenticationException("身份验证失败");} else if (infoList.size() == 1) {return infoList.get(0);} else {// 自定义多 Realm 身份验证成功的逻辑，这里简单返回第一个return infoList.get(0);}}
}

五、授权

（一）基于角色的授权

Shiro 支持基于角色的授权，即根据用户所属的角色来决定是否允许访问资源。首先需要在 Realm 中加载用户的角色信息，然后在代码中通过 hasRole 等方法进行授权检查。

import org.apache.shiro.SecurityUtils;
import org.apache.shiro.subject.Subject;public class AuthorizationExample {public static void main(String[] args) {Subject currentUser = SecurityUtils.getSubject();if (currentUser.hasRole("admin")) {System.out.println("用户具有管理员角色，可以访问特定资源");} else {System.out.println("用户没有管理员角色，无权访问");}}
}

（二）基于权限的授权

除了基于角色，Shiro 还支持基于权限的授权，更加细粒度地控制资源访问。权限可以是对某个操作或资源的特定许可。

例如，在 Realm 中加载用户的权限信息后，可以这样进行授权检查：

if (currentUser.isPermitted("user:create")) {System.out.println("用户有权创建用户");
} else {System.out.println("用户无权创建用户");
}

六、会话管理

Shiro 提供了强大的会话管理功能，可以管理用户的会话状态，包括会话的创建、销毁、超时设置等。

在 Web 应用中，可以通过配置 SessionManager 来定制会话管理策略。例如：

<bean id="sessionManager" class="org.apache.shiro.web.session.mgt.DefaultWebSessionManager"><property name="globalSessionTimeout" value="1800000"/> <!-- 会话超时时间，单位毫秒 -->
</bean>

在代码中，可以通过 Subject 获取会话对象并进行操作：

Subject currentUser = SecurityUtils.getSubject();
// 获取会话
org.apache.shiro.session.Session session = currentUser.getSession();
session.setAttribute("userData", "一些用户数据");
String data = (String) session.getAttribute("userData");
System.out.println("会话中的数据: " + data);

七、加密

Shiro 提供了方便的加密工具，用于对敏感数据（如密码）进行加密存储和传输。

例如，使用 Shiro 的 Md5Hash 对密码进行加密：

import org.apache.shiro.crypto.hash.Md5Hash;public class EncryptionExample {public static void main(String[] args) {String password = "password1";// 使用 Md5 加密密码，可指定盐值Md5Hash md5Hash = new Md5Hash(password, "salt");System.out.println("加密后的密码: " + md5Hash.toHex());}
}

八、总结

Apache Shiro 是一款功能强大、灵活且易于使用的 Java 安全框架。通过深入理解其核心概念（如 Subject、SecurityManager、Realm）、架构以及身份验证、授权、会话管理和加密等关键功能，我们可以在实际项目中有效地构建安全可靠的系统。无论是简单的单体应用还是复杂的分布式系统，Shiro 都能提供合适的安全解决方案，帮助我们保护用户数据和系统资源免受各种安全威胁。在后续的开发中，我们可以根据具体的业务需求进一步探索 Shiro 的高级特性和定制化配置，以构建更加完善的安全体系。