Apache Shiro是一个强大且易用的Java安全框架,执行身份验证、授权、密码和会话管理。使用Shiro的易于理解的API,您可以快速、轻松地获得任何应用程序,从最小的移动应用程序到最大的网络和企业应用程序。
—— 摘自百度百科
什么是 Shiro
Shiro 是 Apache 公司开发的一款安全框架。它支持 Java、C / C++、C#、Python、PHP 等语言,同时支持单机项目使用和网络项目使用。
Shiro 核心组件
Shiro 有 Subject、SecurityManager、Realms 三大核心组件。
Subject
代表当前用户的安全操作,比如,我们可以使用 Subject 进行登录和退出登录。
SecurityManager
它是 Shiro 的核心,管理所有用户的安全操作。
Realms
充当了 Shiro 与应用安全数据间的“桥梁”或者“连接器”,存储用户和权限信息。Realm 的种类有很多,如 IniRealm 从 ini 配置文件中读取用户信息,JdbcRealm 从数据库中读取用户信息,我们还可以自定义 Realm 来编写登录和认证规则。
Hello World
配置
pom.xml
导入 Shiro 核心包、Slf4j、Log4j 和 JUnit 单元测试:
<!-- Shiro -->
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-core</artifactId>
<version>1.5.3</version>
</dependency>
<!-- Slf4j -->
<dependency>
<groupId>org.jboss.forge.addon</groupId>
<artifactId>slf4j</artifactId>
<version>1.7.13</version>
</dependency>
<!-- Log4j -->
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<!-- Junit -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
Shiro 配置文件
在 resource 文件夹中创建一个名为 shiro.ini 的配置文件,文件名随意。
我们可以在配置文件中写入用户的基本信息,所有用户写在[users]
标签下,等号左边表示账号、右边表示密码:
[users]
koorye = 123456
Main 方法
Shiro 的基本流程分为步:
- 新建一个 SecurityManager 安全管理类,这个类是 Shiro 一切操作的核心
- 为 manager 设置 Realm,此处我们使用 IniRealm
- 使用 SecurityUtils 全局工具类,指定安全管理类
- 使用 SecurityUtils 得到一个 Subject
- 设置一个 Token,可以包含用户名、密码等信息
- 使用 Subject 登录
注意登录是会抛出异常:
- UnknownAccountException 用户名不存在
- AuthenticationException 用户名存在,认证失败
package org.koorye;
import org.apache.shiro.SecurityUtils;
import org.apache.shiro.authc.AuthenticationException;
import org.apache.shiro.authc.UnknownAccountException;
import org.apache.shiro.authc.UsernamePasswordToken;
import org.apache.shiro.mgt.DefaultSecurityManager;
import org.apache.shiro.realm.text.IniRealm;
import org.apache.shiro.subject.Subject;
public class HelloShiro {
public static void main(String[] args) {
DefaultSecurityManager manager = new DefaultSecurityManager();
manager.setRealm(new IniRealm("classpath:shiro.ini"));
SecurityUtils.setSecurityManager(manager);
Subject subject = SecurityUtils.getSubject();
UsernamePasswordToken token = new UsernamePasswordToken("koorye", "123456");
try {
subject.login(token);
System.out.println("登录成功");
} catch (UnknownAccountException e) {
e.printStackTrace();
System.out.println("用户名不存在");
} catch (AuthenticationException e) {
e.printStackTrace();
System.out.println("密码错误");
}
}
}
运行:
登录成功
Process finished with exit code 0
如果用户名存在,密码错误:
UsernamePasswordToken token = new UsernamePasswordToken("koorye", "12345678");
运行:
org.apache.shiro.authc.IncorrectCredentialsException: Submitted credentials for token [org.apache.shiro.authc.UsernamePasswordToken - koorye, rememberMe=false] did not match the expected credentials.
at org.apache.shiro.realm.AuthenticatingRealm.assertCredentialsMatch(AuthenticatingRealm.java:603)
at org.apache.shiro.realm.AuthenticatingRealm.getAuthenticationInfo(AuthenticatingRealm.java:581)
at org.apache.shiro.authc.pam.ModularRealmAuthenticator.doSingleRealmAuthentication(ModularRealmAuthenticator.java:180)
at org.apache.shiro.authc.pam.ModularRealmAuthenticator.doAuthenticate(ModularRealmAuthenticator.java:273)
at org.apache.shiro.authc.AbstractAuthenticator.authenticate(AbstractAuthenticator.java:198)
at org.apache.shiro.mgt.AuthenticatingSecurityManager.authenticate(AuthenticatingSecurityManager.java:106)
at org.apache.shiro.mgt.DefaultSecurityManager.login(DefaultSecurityManager.java:275)
at org.apache.shiro.subject.support.DelegatingSubject.login(DelegatingSubject.java:260)
at org.koorye.HelloShiro.main(HelloShiro.java:21)
密码错误
Process finished with exit code 0
如果用户名不存在:
UsernamePasswordToken token = new UsernamePasswordToken("kkkoorye", "12345678");
运行:
org.apache.shiro.authc.UnknownAccountException: Realm [org.apache.shiro.realm.text.IniRealm@3b95a09c] was unable to find account data for the submitted AuthenticationToken [org.apache.shiro.authc.UsernamePasswordToken - kkkoorye, rememberMe=false].
at org.apache.shiro.authc.pam.ModularRealmAuthenticator.doSingleRealmAuthentication(ModularRealmAuthenticator.java:184)
at org.apache.shiro.authc.pam.ModularRealmAuthenticator.doAuthenticate(ModularRealmAuthenticator.java:273)
at org.apache.shiro.authc.AbstractAuthenticator.authenticate(AbstractAuthenticator.java:198)
at org.apache.shiro.mgt.AuthenticatingSecurityManager.authenticate(AuthenticatingSecurityManager.java:106)
at org.apache.shiro.mgt.DefaultSecurityManager.login(DefaultSecurityManager.java:275)
at org.apache.shiro.subject.support.DelegatingSubject.login(DelegatingSubject.java:260)
at org.koorye.HelloShiro.main(HelloShiro.java:21)
用户名不存在
Process finished with exit code 0