一、介绍
身份认证:即在系统中,什么能证明此用户的合法性,证明当前登录的用户就是自己。提供一些唯一标识ID来证明自己。一般是用户名/密码组合来证明。
principals:身份,即主体的标识属性,可以是任何东西,如用户名、邮箱等,唯一即可。一个主体可以有多个principals,但只有一个Primary principals,一般是用户名/密码/手机号。
Credentials:证明/凭证,即只有主体知道的安全值,如密码/数字证书等。最常见的principals和credentials组合就是用户名/密码了。接下来先进行一个基本的身份认证。
二、实际项目
1、使用Idea创建一个基于Maven管理的Java工程。
2、在POM文件中引入一下依赖。
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.9</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.21</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>org.apache.shiro</groupId>
<artifactId>shiro-core</artifactId>
<version>1.4.0</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
</dependencies>
3、在resources文件夹下新建shiro.ini配置文件,值为以下字段。指定主体
[users]
James=123
4、编写认证测试代码
package com.study.HelloWorld;
import org.apache.shiro.SecurityUtils;
import org.apache.shiro.authc.*;
import org.apache.shiro.config.IniSecurityManagerFactory;
import org.apache.shiro.mgt.SecurityManager;
import org.apache.shiro.subject.Subject;
import org.apache.shiro.util.Factory;
/**
* @author James
* @create 2019-11-02 22:59
*/
public class AuthenticationDemo {
public static void main(String[] args){
//1、获取SecurityManager工厂,此处使用(shiro.ini)初始化配置文件。
Factory<SecurityManager> factory = new IniSecurityManagerFactory("classpath:shiro.ini");
//2、得到SecurityManager实例
SecurityManager securityManager = factory.getInstance();
//3、将SecurityManager设置到运行环境中
SecurityUtils.setSecurityManager(securityManager);
//4、通过SecurityUtils获取Subject主体
Subject subject = SecurityUtils.getSubject();
//5、假设登录的用户名 密码是Jame 123(表示用户登录时输入信息 shiro.ini相当于数据库存信息)
UsernamePasswordToken token=new UsernamePasswordToken("James","123");
//6、进行登录
try {
subject.login(token);
if (subject.isAuthenticated()) {
System.out.println("登录成功.....");
}
}catch (DisabledAccountException e){
System.out.println("账户失效.....");
}catch (ExcessiveAttemptsException e){
System.out.println("尝试次数过多...");
}catch (UnknownAccountException e){
System.out.println("用户名不正确...");
}catch (IncorrectCredentialsException e){
System.out.println("用户名或密码不正确...");
}
}
}
此处注意:new IniSecurityManagerFactory()会报错,需要我们手动引入 import org.apache.shiro.mgt.SecurityManager ;Shiro中的SecurityManager。因为java.lang*包中也有SecurityManager。需要给idea指明。我曾在这里踩了大坑。
4.1、首先通过newIniSecurityManagerFactory并指定一个ini配置文件来创建一个SecurityManager工厂;
4.2、接着获取SecurityManager并绑定到SecurityUtils,这是一个全局设置,设置一次即可;
4.3、通过SecurityUtils得到Subject,其会自动绑定到当前线程;如果在web环境在请求结束时需要解除绑定;然后获取身份验证的Token,如用户名/密码;
4.4、调用subject.login方法进行登录,其会自动委托给SecurityManager.login方法进行登录;
4.5、isAuthenticated()返回boolean值,true为认证成功,false认证失败。如果身份验证失败请捕获AuthenticationException或其子类,常见的如:DisabledAccountException(禁用的帐号)、LockedAccountException(锁定的帐号)、UnknownAccountException(错误的帐号)、ExcessiveAttemptsException(登录失败次数过多)、IncorrectCredentialsException(错误的凭证)、ExpiredCredentialsException(过期的凭证)等,具体请查看其继承关系;对于页面的错误消息展示,最好使用如“用户名/密码错误”而不是“用户名错误”/“密码错误”,防止一些恶意用户非法扫描帐号库;
4.6、最后可以调用subject.logout退出,其会自动委托给SecurityManager.logout方法退出。
通过认证异常类的子类体系图,我们可以清楚的看到Shiro的一些异常子类。
以上就是Shiro的身份认证,在下一章将结合源码进行认证流程的分析。