三、身份验证
身份验证,即在应用中谁能证明他就是他本人。一般提供如他们的身份 ID 一些标识信息来表明他就是他本人,如提供身份证,用户名/密码来证明
在 shiro 中,用户需要提供 principals (身份)和 credentials(证明)给 shiro,从而应用能验证用户身份:
principals:身份,即主体的标识属性,可以是任何东西,如用户名、邮箱等,唯一即可。一个主体可以有多个 principals,但只有一个 Primary principals,一般是用户名/密码/手机号。
credentials:证明/凭证,即只有主体知道的安全值,如密码/数字证书等。
最常见的 principals 和 credentials 组合就是用户名/密码了。接下来先进行一个基本的身份认证。
3.1环境准备
首先准备环境依赖:添加 junit、common-logging 及 shiro-core 依赖即可。
1 <dependency> 2 3 <groupId>junit </groupId> 4 5 <artifactId>junit </artifactId> 6 7 <version>4.9</version> 8 9 </dependency> 10 11 <dependency> 12 13 <groupId>commons-logging </groupId> 14 15 <artifactId>commons-logging </artifactId> 16 17 <version>1.1.3</version> 18 19 </dependency> 20 21 <dependency> 22 23 <groupId>org.apache.shiro </groupId> 24 25 <artifactId>shiro-core </artifactId> 26 27 <version>1.2.5</version> 28 29 </dependency>
3.2登录/退出
1、首先准备一些用户身份/凭据(shiro.ini)
1 [users] 2 zhang=123 3 wang=123
此处使用 ini 配置文件,通过[users]指定了两个主体:zhang/123、wang/123。
2、测试用例
1 @Test 2 public void testHelloworld() { 3 //1、获取 SecurityManager 工厂,此处使用 Ini 配置文件初始化 SecurityManager 4 Factory<org.apache.shiro.mgt.SecurityManager> factory =new IniSecurityManagerFactory("classpath:shiro.ini"); 5 //2、得到 SecurityManager 实例 并绑定给 SecurityUtils 6 org.apache.shiro.mgt.SecurityManager securityManager = factory.getInstance(); 7 SecurityUtils.setSecurityManager(securityManager); 8 //3、得到 Subject 及创建用户名/密码身份验证 Token(即用户身份/凭证) 9 Subject subject = SecurityUtils.getSubject(); 10 UsernamePasswordToken token = new UsernamePasswordToken("zhang", "123"); 11 try { 12 //4、登录,即身份验证 13 subject.login(token); 14 } catch (AuthenticationException e) { 15 //5、身份验证失败 16 } 17 Assert.assertEquals(true, subject.isAuthenticated()); //断言用户已经登录 18 //6、退出 19 subject.logout(); 20 }
2.1、首先通过 new IniSecurityManagerFactory 并指定一个 ini 配置文件来创建一个SecurityManager 工厂
2.2、接着获取 SecurityManager 并绑定到 SecurityUtils,这是一个全局设置,设置一次即可;
2.3、通过 SecurityUtils 得到 Subject,其会自动绑定到当前线程;如果在 web 环境在请求结束时需要解除绑定;然后获取身份验证的 Token,如用户名/密码;
2.4、调用 subject.login 方法进行登录,其会自动委托给 SecurityManager.login 方法进行登录;
2.5 、 如 果 身 份 验 证 失 败 请 捕 获 AuthenticationException 或 其 子 类 , 常 见 的 如 :
DisabledAccountException(禁用的帐号)、LockedAccountException(锁定的帐号)、
UnknownAccountException(错误的帐号)、ExcessiveAttemptsException(登录失败次数过多)、IncorrectCredentialsException (错误的凭证)、ExpiredCredentialsException(过期的凭证)等,具体请查看其继承关系;对于页面的错误消息展示,最好使用如“用户名/密码错误”而不是“用户名错误”/“密码错误”,防止一些恶意用户非法扫描帐号库;
2.6、最后可以调用 subject.logout 退出,其会自动委托给 SecurityManager.logout 方法退出。
从如上代码可总结出身份验证的步骤:
1、收集用户身份/凭证,即如用户名/密码;
2、调用 Subject.login 进行登录,如果失败将得到相应的 AuthenticationException 异常,根据异常提示用户错误信息;否则登录成功;
3、最后调用 Subject.logout 进行退出操作。
3.3身份认证流程
流程如下:
1、首先调用Subject.login(token)进行登录,其会自动委托给Security Manager,调用之前必须通过SecurityUtils. setSecurityManager()设置;
2、SecurityManager负责真正的身份验证逻辑;它会委托给Authenticator进行身份验证;
3、Authenticator才是真正的身份验证者,Shiro API中核心的身份认证入口点,此处可以自定义插入自己的实现;
4、Authenticator可能会委托给相应的AuthenticationStrategy进行多Realm身份验证,默认ModularRealmAuthenticator会调用AuthenticationStrategy进行多Realm身份验证;
5、Authenticator会把相应的token传入Realm,从Realm获取身份验证信息,如果没有返回/抛出异常表示身份验证失败了。此处可以配置多个Realm,将按照相应的顺序及策略进行访问
3.4Realm
Realm:域,Shiro从从Realm获取安全数据(如用户、角色、权限),就是说SecurityManager要验证用户身份,那么它需要从Realm获取相应的用户进行比较以确定用户身份是否合法;也需要从Realm得到用户相应的角色/权限进行验证用户是否能进行操作;可以把Realm看成DataSource,即安全数据源。
Shiro默认提供的Realm
以后一般继承AuthorizingRealm(授权)即可;其继承了AuthenticatingRealm(即身份验证),而且也间接继承了CachingRealm(带有缓存实现)。