Shiro的简单身份验证

前言

身份验证，即在应用中谁能证明他就是他本人。一般提供如他们的身份 ID 一些标识信息来表明他就是他本人，如提供身份证，用户名/密码来证明。

在 shiro 中，用户需要提供 principals （身份）和 credentials（证明）给 shiro，从而应用能验证用户身份：
principals：身份，即主体的标识属性，可以是任何东西，如用户名、邮箱等，唯一即可。一个主体可以有多个 principals，但只有一个 Primary principals，一般是用户名/密码/手机号。
credentials：证明/凭证，即只有主体知道的安全值，如密码/数字证书等。最常见的 principals 和 credentials 组合就是用户名/密码了。接下来先进行一个基本的身份认证。

另外两个相关的概念是之前提到的 Subject 及 Realm，分别是主体及验证主体的数据源。

一.环境准备

使用 Maven 构建，首先准备环境依赖：

<dependencies>
     <!--shiro-->
      <dependency>
        <groupId>org.apache.shiro</groupId>
        <artifactId>shiro-core</artifactId>
        <version>1.4.0</version>
      </dependency>

      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.9</version>
      </dependency>

      <dependency>
        <groupId>commons-logging</groupId>
        <artifactId>commons-logging</artifactId>
        <version>1.1.3</version>
      </dependency>
</dependencies>

添加 junit、common-logging 及 shiro-core 依赖即可。

二.登录/退出

1、首先准备一些用户身份/凭据（shiro.ini）

[users]
zhang=123
wang=123 

2、测试用例

@Test
public void testHelloworld() {
   //1、获取 SecurityManager 工厂，此处使用 Ini 配置文件初始化 SecurityManager
   Factory<org.apache.shiro.mgt.SecurityManager> factory = new IniSecurityManagerFactory("classpath:shiro.ini");

   //2、得到 SecurityManager 实例 并绑定给 SecurityUtils
   org.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance();
   SecurityUtils.setSecurityManager(securityManager);

   //3、得到 Subject 及创建用户名/密码身份验证 Token（即用户身份/凭证）
   Subject subject = SecurityUtils.getSubject();
   UsernamePasswordToken token = new UsernamePasswordToken("zhang", "123");

   try {
   //4、登录，即身份验证
   subject.login(token);
   } catch (AuthenticationException e) {
   //5、身份验证失败
   }
    //断言用户已经登录
   Assert.assertEquals(true, subject.isAuthenticated());

   //6、退出
   subject.logout();
} 

三.流程说明

1、首先通过 new IniSecurityManagerFactory 并指定一个 ini 配置文件来创建一个SecurityManager 工厂；

2、接着获取 SecurityManager 并绑定到 SecurityUtils，这是一个全局设置，设置一次即可；

3、通过 SecurityUtils 得到 Subject，其会自动绑定到当前线程；如果在 web 环境在请求结束时需要解除绑定；然后获取身份验证的 Token，如用户名/密码；

4、调用 subject.login 方法进行登录，其会自动委托给 SecurityManager.login 方法进行登录；

5 、 如 果 身份验证 失败请捕 获 AuthenticationException 或 其 子 类 ， 常 见 的 如 ：DisabledAccountException（禁用的帐号）、LockedAccountException（锁定的帐号）、UnknownAccountException（错误的帐号）、ExcessiveAttemptsException（登录失败次数过多）、IncorrectCredentialsException （错误的凭证）、ExpiredCredentialsException（过期的凭证）等，对于页面的错误消息展示，最好使用如“用户名/密码错误”而不是“用户名错误”/“密码错误”，防止一些恶意用户非法扫描帐号库；

6、最后可以调用 subject.logout 退出，其会自动委托给 SecurityManager.logout 方法退出。

四.总结

从如上代码可总结出身份验证的步骤：

1、收集用户身份/凭证，即如用户名/密码；
2、调用 Subject.login 进行登录，如果失败将得到相应的 AuthenticationException 异常，根
据异常提示用户错误信息；否则登录成功；
3、最后调用 Subject.logout 进行退出操作。

如上测试的几个问题：
1、用户名/密码硬编码在 ini 配置文件，以后需要改成如数据库存储，且密码需要加密存储；
2、用户身份 Token 可能不仅仅是用户名/密码，也可能还有其他的，如登录时允许用户名/邮箱/手机号同时登录。