Shiro入门教程

作者: Real_man | 来源:发表于2017-06-14 15:51 被阅读30419次

    简介

    Shiro是一个强大的简单易用的Java安全框架,主要用来更便捷的认证,授权,加密,会话管理。Shiro首要的和最重要的目标就是容易使用并且容易理解。

    Shiro是一个有许多特性的全面的安全框架,下面这幅图可以了解Shiro的特性:

    image.png

    可以看出shiro除了基本的认证,授权,会话管理,加密之外,还有许多额外的特性。

    Shiro架构

    从大的角度来看,Shiro有三个主要的概念:SubjectSecurityManagerRealms,下面这幅图可以看到这些原件之间的交互。

    image.png
    • Subject:翻译为主角,当前参与应用安全部分的主角。可以是用户,可以试第三方服务,可以是cron 任务,或者任何东西。主要指一个正在与当前软件交互的东西。
      所有Subject都需要SecurityManager,当你与Subject进行交互,这些交互行为实际上被转换为与SecurityManager的交互

    • SecurityManager:安全管理员,Shiro架构的核心,它就像Shiro内部所有原件的保护伞。然而一旦配置了SecurityManager,SecurityManager就用到的比较少,开发者大部分时间都花在Subject上面。
      请记得,当你与Subject进行交互的时候,实际上是SecurityManager在背后帮你举起Subject来做一些安全操作。

    • Realms:Realms作为Shiro和你的应用的连接桥,当需要与安全数据交互的时候,像用户账户,或者访问控制,Shiro就从一个或多个Realms中查找。
      Shiro提供了一些可以直接使用的Realms,如果默认的Realms不能满足你的需求,你也可以定制自己的Realms

    更细节的架构

    image.png

    创建Shiro应用

    使用Idea创建一个Maven项目

    Pom.xml中添加如下依赖:

     <dependencies>
            <dependency>
                <groupId>org.apache.shiro</groupId>
                <artifactId>shiro-core</artifactId>
                <version>1.2.3</version>
            </dependency>
    
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-simple</artifactId>
                <version>1.6.1</version>
            </dependency>
        </dependencies>
    

    任意创建一个包,在里面创建一个Tutorial类

    package me.aihe;import org.slf4j.Logger;
    
    import org.slf4j.LoggerFactory;
    
    public class Tutorial {
        private static final transient Logger log = LoggerFactory.getLogger(Tutorial.class);   
    
        public static void main(String[] args) {    
            log.info("My First Apache Shiro Application");       
            System.exit(0);    
        }
    }
    

    使用Shiro

    Shiro提供了一个通用的方案通过 INI 进行配置 ,当然也可以通过XML,YMAL,JSON等进行配置。
    在resource目录下面,创建一个shiro.ini的文件。内容如下:

    # -----------------------------------------------------------------------------
    # Users and their (optional) assigned roles
    # username = password, role1, role2, ..., roleN
    # -----------------------------------------------------------------------------
    [users]
    root = secret, admin
    guest = guest, guest
    presidentskroob = 12345, president
    darkhelmet = ludicrousspeed, darklord, schwartz
    aihe = aihe, goodguy, client
    
    # -----------------------------------------------------------------------------
    # Roles with assigned permissions
    # roleName = perm1, perm2, ..., permN
    # -----------------------------------------------------------------------------
    [roles]
    admin = *
    client = look:*
    goodguy = winnebago:drive:eagle5
    
    

    引用Shiro.ini配置进行测试

    现在改变我们的Tutorial类文件,内容如下

    package me.aihe;
    
    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.session.Session;
    import org.apache.shiro.subject.Subject;
    import org.apache.shiro.util.Factory;
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    
    /**
     * Created by aihe on 2017/6/14.
     */
    public class Tutorial {
    
        private static final transient Logger log = LoggerFactory.getLogger(Tutorial.class);
        public static void main(String[] args) {
            log.info("My First Apache Shiro Application");
    
            //1. 这里的SecurityManager是org.apache.shiro.mgt.SecurityManager,而不是java.lang.SecurityManager
            // 加载配置文件
            Factory<SecurityManager> factory = new IniSecurityManagerFactory("classpath:shiro.ini");
    
            //2.解析配置文件,并且返回一些SecurityManger实例
            SecurityManager securityManager = factory.getInstance();
    
            //3.设置SecurityManager到静态内存区,单例模式
            SecurityUtils.setSecurityManager(securityManager);
    
    
            // 安全操作
            Subject currentUser = SecurityUtils.getSubject();
    
            // 在应用的当前会话中设置属性
            Session session =  currentUser.getSession();
            session.setAttribute("key","value");
    
            //当前我们的用户是匿名的用户,我们尝试进行登录,
            if (!currentUser.isAuthenticated()){
                UsernamePasswordToken token = new UsernamePasswordToken("aihe", "aihe");
    
                //this is all you have to do to support 'remember me' (no config - built in!):
                token.setRememberMe(true);
    
                //尝试进行登录用户,如果登录失败了,我们进行一些处理
    
                try{
                    currentUser.login(token);
    
                    //当我们获登录用户之后
                    log.info("User [" + currentUser.getPrincipal() + "] logged in successfully.");
    
    
                    // 查看用户是否有指定的角色
                    if ( currentUser.hasRole( "client" ) ) {
                        log.info("Look is in your role" );
                    } else {
                        log.info( "....." );
                    }
    
                    // 查看用户是否有某个权限
                    if ( currentUser.isPermitted( "look:desk" ) ) {
                        log.info("You can look.  Use it wisely.");
                    } else {
                        log.info("Sorry, you can't look.");
                    }
    
                    if ( currentUser.isPermitted( "winnebago:drive:eagle5" ) ) {
                        log.info("You are permitted to 'drive' the 'winnebago' with license plate (id) 'eagle5'.  " +
                                "Here are the keys - have fun!");
                    } else {
                        log.info("Sorry, you aren't allowed to drive the 'eagle5' winnebago!");
                    }
    
                    //登出
    
                    currentUser.logout();
    
                }
                catch ( UnknownAccountException uae ) {
                    //账户不存在的操作
                } catch ( IncorrectCredentialsException ice ) {
                    //密码不正确
                } catch ( LockedAccountException lae ) {
                    //用户被锁定了
                } catch ( AuthenticationException ae ) {
                    //无法判断的情形
                }
    
            }
    
    
            System.exit(0);
        }
    }
    
    

    总结

    这个相对来说是一个简单的程序,但也证明了一些shiro的基本用法,我们可以通过shiro进行认证,权限控制等。想要了解更多shiro的用法,请参考Shiro的官方文档

    资料

    相关文章

      网友评论

      • 霍霍有声:好专业好牛🐮。看不太懂,慢慢学习

      本文标题:Shiro入门教程

      本文链接:https://www.haomeiwen.com/subject/ivzsqxtx.html