web中采用shiro实现登录认证与权限授权管理

Apache Shiro是Java的一个安全框架。

官网对shiro的介绍：Apache Shiro™ is a powerful and easy-to-use Java security framework that performs authentication, authorization, cryptography, and session management. With Shiro’s easy-to-understand API, you can quickly and easily secure any application – from the smallest mobile applications to the largest web and enterprise applications.

  翻译一下：Apache Shiro™是强大且易于使用的Java安全框架，可执行认证，授权，加密和会话管理。借助Shiro易于理解的API，您可以快速轻松地确保任何应用程序 - 从最小的移动应用程序到最大的Web和企业应用程序。

本篇介绍shiro进行登陆认证和权限授权，并与web集成。

1、在pom.xml中引入shiro的jar包

<!-- shiro -->          <dependency>              <groupId>org.apache.shiro</groupId>              <artifactId>shiro-core</artifactId>              <version>1.2.1</version>          </dependency>          <dependency>              <groupId>org.apache.shiro</groupId>              <artifactId>shiro-web</artifactId>              <version>1.2.1</version>          </dependency>          <dependency>              <groupId>org.apache.shiro</groupId>              <artifactId>shiro-ehcache</artifactId>              <version>1.2.1</version>          </dependency>          <dependency>              <groupId>org.apache.shiro</groupId>              <artifactId>shiro-spring</artifactId>              <version>1.2.1</version>          </dependency>

2、在web.xml中添加shiro过滤器（启动web程序的时候，javaweb会自动读取web.xml文件，创建servelet上下文并共享）

<filter>        <filter-name>shiroFilter</filter-name>        <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>    </filter>    <filter-mapping>        <filter-name>shiroFilter</filter-name>        <url-pattern>/admin/*</url-pattern>    </filter-mapping>

3、创建spring-shiro.xml，在spring中集成shiro

<beans xmlns="http://www.springframework.org/schema/beans"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mvc="http://www.springframework.org/schema/mvc"    xmlns:context="http://www.springframework.org/schema/context"    xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"    xsi:schemaLocation="http://www.springframework.org/schema/beans         http://www.springframework.org/schema/beans/spring-beans-3.2.xsd         http://www.springframework.org/schema/mvc         http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd         http://www.springframework.org/schema/context         http://www.springframework.org/schema/context/spring-context-3.2.xsd         http://www.springframework.org/schema/aop         http://www.springframework.org/schema/aop/spring-aop-3.2.xsd         http://www.springframework.org/schema/tx         http://www.springframework.org/schema/tx/spring-tx-3.2.xsd ">    <!-- web.xml中shiro的filter对应的bean -->    <bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">        <!-- 管理器，必须设置 -->        <property name="securityManager" ref="securityManager" />        <!-- 拦截到，跳转到的地址,通过此地址去认证 -->        <property name="loginUrl" value="/admin/login.do" />        <!-- 认证成功统一跳转到/admin/index.do，建议不配置，shiro认证成功自动到上一个请求路径 -->        <property name="successUrl" value="/admin/index.do" />        <!-- 通过unauthorizedUrl指定没有权限操作时跳转页面 -->        <property name="unauthorizedUrl" value="/refuse.jsp" />        <!-- 自定义filter，可用来更改默认的表单名称配置 -->        <property name="filters">            <map>                <!-- 将自定义 的FormAuthenticationFilter注入shiroFilter中 -->                <entry key="authc" value-ref="formAuthenticationFilter" />            </map>        </property>        <property name="filterChainDefinitions">            <value>                <!-- 对静态资源设置匿名访问 -->                /images/** = anon                /js/** = anon                /styles/** = anon                <!-- 验证码，可匿名访问 -->                /validatecode.jsp = anon                <!-- 请求 logout.do地址，shiro去清除session -->                /admin/logout.do = logout                <!--商品查询需要商品查询权限 ，取消url拦截配置，使用注解授权方式 -->                <!-- /items/queryItems.action = perms[item:query] /items/editItems.action                     = perms[item:edit] -->                <!-- 配置记住我或认证通过可以访问的地址 -->                /welcome.jsp = user                /admin/index.do = user                <!-- /** = authc 所有url都必须认证通过才可以访问 -->                /** = authc            </value>        </property>    </bean>    <!-- securityManager安全管理器 -->    <bean id="securityManager" class="org.apache.shiro.web.mgt.DefaultWebSecurityManager">        <property name="realm" ref="customRealm" />        <!-- 注入缓存管理器 -->        <property name="cacheManager" ref="cacheManager" />        <!-- 注入session管理器 -->        <!-- <property name="sessionManager" ref="sessionManager" /> -->        <!-- 记住我 -->        <property name="rememberMeManager" ref="rememberMeManager" />    </bean>    <!-- 自定义realm -->    <bean id="customRealm" class="com.zhijianj.stucheck.shiro.CustomRealm">        <!-- 将凭证匹配器设置到realm中，realm按照凭证匹配器的要求进行散列 -->        <!-- <property name="credentialsMatcher" ref="credentialsMatcher" /> -->    </bean>    <!-- 凭证匹配器 -->    <bean id="credentialsMatcher"        class="org.apache.shiro.authc.credential.HashedCredentialsMatcher">        <!-- 选用MD5散列算法 -->        <property name="hashAlgorithmName" value="md5" />        <!-- 进行一次加密 -->        <property name="hashIterations" value="1" />    </bean>    <!-- 自定义form认证过虑器 -->    <!-- 基于Form表单的身份验证过滤器，不配置将也会注册此过虑器，表单中的用户账号、密码及loginurl将采用默认值，建议配置 -->    <!-- 可通过此配置，判断验证码 -->    <bean id="formAuthenticationFilter"        class="com.zhijianj.stucheck.shiro.CustomFormAuthenticationFilter ">        <!-- 表单中账号的input名称,默认为username -->        <property name="usernameParam" value="username" />        <!-- 表单中密码的input名称,默认为password -->        <property name="passwordParam" value="password" />        <!-- 记住我input的名称,默认为rememberMe -->        <property name="rememberMeParam" value="rememberMe" />    </bean>    <!-- 会话管理器 -->    <bean id="sessionManager"        class="org.apache.shiro.web.session.mgt.DefaultWebSessionManager">        <!-- session的失效时长，单位毫秒 -->        <property name="globalSessionTimeout" value="600000" />        <!-- 删除失效的session -->        <property name="deleteInvalidSessions" value="true" />    </bean>    <!-- 缓存管理器 -->    <bean id="cacheManager" class="org.apache.shiro.cache.ehcache.EhCacheManager">        <property name="cacheManagerConfigFile" value="classpath:shiro-ehcache.xml" />    </bean>    <!-- rememberMeManager管理器，写cookie，取出cookie生成用户信息 -->    <bean id="rememberMeManager" class="org.apache.shiro.web.mgt.CookieRememberMeManager">        <property name="cookie" ref="rememberMeCookie" />    </bean>    <!-- 记住我cookie -->    <bean id="rememberMeCookie" class="org.apache.shiro.web.servlet.SimpleCookie">        <!-- rememberMe是cookie的名字 -->        <constructor-arg value="rememberMe" />        <!-- 记住我cookie生效时间30天 -->        <property name="maxAge" value="2592000" />    </bean></beans>

4、shiro中唯一需要用户管理的就是realm了，因为realm是做登陆认证和权限认证的，具体的认证规则需要用户自定义

创建CustomRealm，如下

public class CustomRealm extends AuthorizingRealm {    // 设置realm的名称    @Override    public void setName(String name) {        super.setName("customRealm");    }    @Autowired    private AdminUserService adminUserService;    /**     * 认证     */    @Override    protected AuthenticationInfo doGetAuthenticationInfo(AuthenticationToken token) throws AuthenticationException {        // token中包含用户输入的用户名和密码        // 第一步从token中取出用户名        String userName = (String) token.getPrincipal();        // 第二步：根据用户输入的userCode从数据库查询        TAdminUser adminUser = adminUserService.getAdminUserByUserName(userName);        // 如果查询不到返回null        if (adminUser == null) {//            return null;        }        // 获取数据库中的密码        String password = adminUser.getPassword();        /**         * 认证的用户,正确的密码         */        AuthenticationInfo authcInfo = new SimpleAuthenticationInfo(adminUser, password, this.getName());               //MD5 加密+加盐+多次加密//<span style="color:#ff0000;">SimpleAuthenticationInfo authcInfo = new SimpleAuthenticationInfo(adminUser, password,ByteSource.Util.bytes(salt), this.getName());</span>        return authcInfo;    }    /**     * 授权,只有成功通过<span style="font-family: Arial, Helvetica, sans-serif;">doGetAuthenticationInfo方法的认证后才会执行。</span>     */    @Override    protected AuthorizationInfo doGetAuthorizationInfo(PrincipalCollection principals) {        // 从 principals获取主身份信息        // 将getPrimaryPrincipal方法返回值转为真实身份类型（在上边的doGetAuthenticationInfo认证通过填充到SimpleAuthenticationInfo中身份类型），        TAdminUser activeUser = (TAdminUser) principals.getPrimaryPrincipal();        // 根据身份信息获取权限信息        // 从数据库获取到权限数据        TAdminRole adminRoles = adminUserService.getAdminRoles(activeUser);        // 单独定一个集合对象        List<String> permissions = new ArrayList<String>();        if (adminRoles != null) {            permissions.add(adminRoles.getRoleKey());        }        // 查到权限数据，返回授权信息(要包括 上边的permissions)        SimpleAuthorizationInfo simpleAuthorizationInfo = new SimpleAuthorizationInfo();        // 将上边查询到授权信息填充到simpleAuthorizationInfo对象中        simpleAuthorizationInfo.addStringPermissions(permissions);        return simpleAuthorizationInfo;    }    // 清除缓存    public void clearCached() {        PrincipalCollection principals = SecurityUtils.getSubject().getPrincipals();        super.clearCache(principals);    }}

5、创建shiro-ehcache.xml,在spring-shiro.xml中会读取这个配置文件，作为缓存配置。

<ehcache updateCheck="false" name="shiroCache">   <defaultCache            maxElementsInMemory="10000"            eternal="false"            timeToIdleSeconds="120"            timeToLiveSeconds="120"            overflowToDisk="false"            diskPersistent="false"            diskExpiryThreadIntervalSeconds="120"            /></ehcache>

6、用户登陆方法，用户登录时，需要先在后台做一次用户空判断（虽然前端已经做了，但是为了防止有人通过http恶意访问网站，获取网站信息），登录方法如下：

public Object loginPost(HttpServletRequest request, HttpServletResponse response,            String username, String password, String captcha,             @RequestParam(value = "rememberMe", defaultValue = "0") Integer rememberMe) {        logger.info("POST请求登录");        // 改为全部抛出异常，避免ajax csrf token被刷新        if (StringUtils.isBlank(username)) {            throw new RuntimeException("用户名不能为空");        }        if (StringUtils.isBlank(password)) {            throw new RuntimeException("密码不能为空");        }        if (StringUtils.isBlank(captcha)) {            throw new RuntimeException("验证码不能为空");        }        if (!dreamCaptcha.validate(request, response, captcha)) {//验证码生成和验证的方法需要自己实现，如果不开启验证码则可以去掉            throw new RuntimeException("验证码错误");        }        Subject user = SecurityUtils.getSubject();        UsernamePasswordToken token = new UsernamePasswordToken(username, password);        // 设置记住密码        token.setRememberMe(1 == rememberMe);        try {            user.login(token);            return renderSuccess();        } catch (UnknownAccountException e) {            throw new RuntimeException("账号不存在！", e);        } catch (DisabledAccountException e) {            throw new RuntimeException("账号未启用！", e);        } catch (IncorrectCredentialsException e) {            throw new RuntimeException("密码错误！", e);        } catch (Throwable e) {            throw new RuntimeException(e.getMessage(), e);        }    }

7、如果开启了验证码登陆功能，则需要在后台加一个验证码生成类，生成验证码之后存在session中，然后在用户登陆时进行验证码的验证。

虽然shiro框架是一种轻量级的Java安全框架，官网描述的多么多么简单，但是真正使用起来还是有一定的难度，特别是shiro加入的一些专业名词和验证步骤，推荐大家一个好的项目，通过git克隆下来就可以直接使用，基本上可以作为一个权限控制框架练练手

项目地址：https://gitee.com/wangzhixuan/spring-shiro-training