首页 > 代码库 > Shiro 入门

Shiro 入门

Apache Shiro(http://shiro.apache.org/) 是 Java 的一个安全(权限)框架。
Shiro 可以非常容易的开发出足够好的应用,其不仅可以用在 JavaSE 环境,也可以用在 JavaEE 环境。

Shiro 可以完成:认证、授权、加密、会话管理、与Web 集成、缓存等。

主要类介绍

Authentication:身份认证/登录,验证用户是不是拥有相应的身份;
1. Authorization:授权,即权限验证,验证某个已认证的用户是否拥有某个权限;即判断用户是否能进行什么操作,如:验证某个用户是否拥有某个角色。或者细粒度的验证某个用户
对某个资源是否具有某个权限;
2. Session Manager:会话管理,即用户登录后就是一次会话,在没有退出之前,它的所有信息都在会话中;会话可以是普通 JavaSE 环境,也可以是 Web 环境的;
3. Cryptography:加密,保护数据的安全性,如密码加密存储到数据库,而不是明文存储;
4. Web Support:Web 支持,可以非常容易的集成到Web 环境;
5. Caching:缓存,比如用户登录后,其用户信息、拥有的角色/权限不必每次去查,这样可以提高效率;
6. Concurrency:Shiro 支持多线程应用的并发验证,即如在一个线程中开启另一个线程,能
7. 把权限自动传播过去;
8. Testing:提供测试支持;
9. Run As:允许一个用户假装为另一个用户(如果他们允许)的身份进行访问;
10. Remember Me:记住我,这个是非常常见的功能,即一次登录后,下次再来的话不用登录了

Shiro 架构
Subject:应用代码直接交互的对象是 Subject,也就是说 Shiro 的对外API核心就是Subject。Subject代表了当前“用户”,这个用户不一定
是一个具体的人,与当前应用交互的任何东西都是 Subject,如网络爬虫,机器人等;与 Subject 的所有交互都会委托给 SecurityManager;
Subject 其实是一个门面,SecurityManager 才是实际的执行者;
SecurityManager:安全管理器;即所有与安全有关的操作都会与SecurityManager 交互;且其管理着所有 Subject;可以看出它是 Shiro的核心,
它负责与 Shiro 的其他组件进行交互,它相当于 SpringMVC 中DispatcherServlet 的角色
Realm:Shiro 从 Realm 获取安全数据(如用户、角色、权限),就是说SecurityManager 要验证用户身份,那么它需要从 Realm 获取相应的用户进行
比较以确定用户身份是否合法;也需要从 Realm 得到用户相应的角色/权限进行验证用户是否能进行操作;可以把 Realm 看成 DataSource

HelloWorld

1.引入jar包

 log4j-1.2.15.jar, shiro-all-1.3.2.jar, slf4j-api-1.6.1.jar, slf4j-log4j12-1.6.1.jar

2.添加shiro.ini文件。(shiro提供的例子程序中有)添加log4j.properties

root = secret, admin
guest = guest, guest
presidentskroob = 12345, president
darkhelmet = ludicrousspeed, darklord, schwartz
lonestarr = vespa, goodguy, schwartz
[roles]
admin = *
schwartz = lightsaber:*
goodguy = user:delete:zhangsan
##添加log4j.properties
log4j.rootLogger=INFO, stdout log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%d %p [%c] - %m %n # General Apache libraries log4j.logger.org.apache=WARN # Spring log4j.logger.org.springframework=WARN # Default Shiro logging log4j.logger.org.apache.shiro=TRACE # Disable verbose logging log4j.logger.org.apache.shiro.util.ThreadContext=WARN log4j.logger.org.apache.shiro.cache.ehcache.EhCache=WARN

3.QuickStart

  1 import org.apache.shiro.SecurityUtils;
  2 import org.apache.shiro.authc.*;
  3 import org.apache.shiro.config.IniSecurityManagerFactory;
  4 import org.apache.shiro.mgt.SecurityManager;
  5 import org.apache.shiro.session.Session;
  6 import org.apache.shiro.subject.Subject;
  7 import org.apache.shiro.util.Factory;
  8 import org.slf4j.Logger;
  9 import org.slf4j.LoggerFactory;
 10 
 11 
 12 /**
 13  * Simple Quickstart application showing how to use Shiro‘s API.
 14  *
 15  * @since 0.9 RC2
 16  */
 17 public class Quickstart {
 18 
 19     private static final transient Logger log = LoggerFactory.getLogger(Quickstart.class);
 20 
 21     public static void main(String[] args) {
 22         Factory<SecurityManager> factory = new IniSecurityManagerFactory("classpath:shiro.ini");
 23         SecurityManager securityManager = factory.getInstance();
 24         SecurityUtils.setSecurityManager(securityManager);
 25         Subject currentUser = SecurityUtils.getSubject();
 26         // 测试使用 Session 
 27         // 获取 Session: Subject#getSession()
 28         Session session = currentUser.getSession();
 29         session.setAttribute("someKey", "aValue");
 30         String value = http://www.mamicode.com/(String) session.getAttribute("someKey");
 31         if (value.equals("aValue")) {
 32             log.info("---> Retrieved the correct value! [" + value + "]");
 33         }
 34 
 35         // let‘s login the current user so we can check against roles and permissions:
 36         // 测试当前的用户是否已经被认证. 即是否已经登录. 
 37         // 调动 Subject 的 isAuthenticated() 
 38         if (!currentUser.isAuthenticated()) {
 39             // 把用户名和密码封装为 UsernamePasswordToken 对象
 40             UsernamePasswordToken token = new UsernamePasswordToken("lonestarr", "vespa");
 41             // rememberme
 42             token.setRememberMe(true);
 43             try {
 44                 // 执行登录. 
 45                 currentUser.login(token);
 46             } 
 47             // 若没有指定的账户, 则 shiro 将会抛出 UnknownAccountException 异常. 
 48             catch (UnknownAccountException uae) {
 49                 log.info("----> There is no user with username of " + token.getPrincipal());
 50                 return; 
 51             } 
 52             // 若账户存在, 但密码不匹配, 则 shiro 会抛出 IncorrectCredentialsException 异常。 
 53             catch (IncorrectCredentialsException ice) {
 54                 log.info("----> Password for account " + token.getPrincipal() + " was incorrect!");
 55                 return; 
 56             } 
 57             // 用户被锁定的异常 LockedAccountException
 58             catch (LockedAccountException lae) {
 59                 log.info("The account for username " + token.getPrincipal() + " is locked.  " +
 60                         "Please contact your administrator to unlock it.");
 61             }
 62             // ... catch more exceptions here (maybe custom ones specific to your application?
 63             // 所有认证时异常的父类. 
 64             catch (AuthenticationException ae) {
 65                 //unexpected condition?  error?
 66             }
 67         }
 68 
 69         //say who they are:
 70         //print their identifying principal (in this case, a username):
 71         log.info("----> User [" + currentUser.getPrincipal() + "] logged in successfully.");
 72 
 73         //test a role:
 74         // 测试是否有某一个角色. 调用 Subject 的 hasRole 方法. 
 75         if (currentUser.hasRole("schwartz")) {
 76             log.info("----> May the Schwartz be with you!");
 77         } else {
 78             log.info("----> Hello, mere mortal.");
 79             return; 
 80         }
 81 
 82         //test a typed permission (not instance-level)
 83         // 测试用户是否具备某一个行为. 调用 Subject 的 isPermitted() 方法。 
 84         if (currentUser.isPermitted("lightsaber:weild")) {
 85             log.info("----> You may use a lightsaber ring.  Use it wisely.");
 86         } else {
 87             log.info("Sorry, lightsaber rings are for schwartz masters only.");
 88         }
 89 
 90         //a (very powerful) Instance Level permission:
 91         // 测试用户是否具备某一个行为. 
 92         if (currentUser.isPermitted("user:delete:zhangsan")) {
 93             log.info("----> You are permitted to ‘drive‘ the winnebago with license plate (id) ‘eagle5‘.  " +
 94                     "Here are the keys - have fun!");
 95         } else {
 96             log.info("Sorry, you aren‘t allowed to drive the ‘eagle5‘ winnebago!");
 97         }
 98 
 99         //all done - log out!
100         // 执行登出. 调用 Subject 的 Logout() 方法. 
101         System.out.println("---->" + currentUser.isAuthenticated());
102         currentUser.logout();
103         System.out.println("---->" + currentUser.isAuthenticated());
104         System.exit(0);
105     }
106 }

 

Shiro 入门