這一篇文章涵蓋了將 Shiro 集成到基于 Spring 的應用程序的方法。
Shiro 的 Java Bean兼容性使它非常適合通過 Spring XML 或其他基于 Spring 的配置機制進行配置。Shiro 的應用程序需要一個應用程序單例安全管理器 ( SecuriyManager) 實例。注意,這并不一定是靜態的單例,但是應用程序應該只使用一個實例,不管它是否是靜態的單例。
1.獨立的應用程序
以下是在 Spring 應用程序中啟用應用程序單例安全管理器的最簡單方法:
<!-- 定義連接到后端安全數據源的 Realm : -->
<bean id="myRealm" class="...">
...
</bean>
<bean id="securityManager" class="org.apache.shiro.mgt.DefaultSecurityManager">
<!-- 單一 Realm 應用這樣寫。如果有多個 Realm ,可以使用 "realms" 屬性 -->
<property name="realm" ref="myRealm"/>
</bean>
<bean id="lifecycleBeanPostProcessor" class="org.apache.shiro.spring.LifecycleBeanPostProcessor"/>
<!-- 對于最簡單的集成方式,就像所有的 SecurityUtils 中的靜態
方法一樣,在所有情況下都適用,將 securityManager bean 聲明
為一個靜態的單例對象。但不要在 web 應用程序中這樣做。參見
下面的 “web 應用程序” 部分。 -->
<bean class="org.springframework.beans.factory.config.MethodInvokingFactoryBean">
<property name="staticMethod" value="org.apache.shiro.SecurityUtils.setSecurityManager"/>
<property name="arguments" ref="securityManager"/>
</bean>
2.Web 應用程序
Shiro 對 Spring web 應用程序有很棒的支持。在一個 web 應用程序中,所有的可用的 web 請求都必須經過 Shiro Filter。這個過濾器非常強大,允許基于 URL 路徑表達式執行的特殊自定義任何過濾器鏈。
在 Shiro 1.0之前,你必須在 Spring web 應用程序中使用一種混合的方法,定義 Shiro 的過濾器所有的配置屬性都在 web.xml 中。但是在 spring.xml中定義 securityManager,這有點不友好。
現在,在 Shiro 1.0 以上的版本中,所有的 Shiro 配置都是在Spring XML 中完成的,它提供了更健壯的 Spring 配置機制。
以下是如何在基于 spring 的 web 應用程序中配置 Shiro:
web.xml
除了其他的 spring 的一些標簽 ( ContextLoaderListener、Log4jConfigListener 等),還定義了以下過濾器和過濾器的映射:
<!-- 在 applicationContext.xml 中,過濾器名稱 “shiroFilter” bean的名稱匹配。-->
<filter>
<filter-name>shiroFilter</filter-name>
<filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
<init-param>
<param-name>targetFilterLifecycle</param-name>
<param-value>true</param-value>
</init-param>
</filter>
...
<!-- 確保你想要的任何請求都可以被過濾。/ * 捕獲所有
請求。通常,這個過濾器映射首先 (在所有其他的之前)定義,
確保 Shiro 在過濾器鏈的后續過濾器中工作:-->
<filter-mapping>
<filter-name>shiroFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
applicationContext.xml
在 applicationContext.xml 文件,定義 web 適用的SecurityManager 和 “shiroFilter” bean,這個bean 在 web.xml 中會被引用。
<bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
<property name="securityManager" ref="securityManager"/>
<!-- 根據具體情況定義以下幾個屬性:
<property name="loginUrl" value="/login.jsp"/>
<property name="successUrl" value="/home.jsp"/>
<property name="unauthorizedUrl" value="/unauthorized.jsp"/> -->
<!-- 如果聲明過任何的 javax.servlet,“filters” 屬性就是不必要的了-->
<!-- <property name="filters">
<util:map>
<entry key="anAlias" value-ref="someFilter"/>
</util:map>
</property> -->
<property name="filterChainDefinitions">
<value>
# 定義需要過濾的 url :
/admin/** = authc, roles[admin]
/docs/** = authc, perms[document:read]
/** = authc
</value>
</property>
</bean>
<!-- 可以在上下文中定義的任何 javax.servlet.Filter bean,它們會自動被上面的 “shiroFilter” bean 所捕獲,并為“filterChainDefinitions” 屬性所用。如果需要的話,可以手動添加/顯式添加到 shiroFilter 的 “filters” Map 上。-->
<bean id="someFilter" class="..."/>
<bean id="anotherFilter" class="..."> ... </bean>
...
<bean id="securityManager" class="org.apache.shiro.web.mgt.DefaultWebSecurityManager">
<!-- 單一 Realm 應用這樣寫。如果有多個 Realm ,可以使用 "realms" 屬性. -->
<property name="realm" ref="myRealm"/>
<!-- 認情況下,適用 servlet 容器的 session 。取消對這一行的注釋后則使用 shiro的原生 session -->
<!-- <property name="sessionMode" value="native"/> -->
</bean>
<bean id="lifecycleBeanPostProcessor" class="org.apache.shiro.spring.LifecycleBeanPostProcessor"/>
<!-- 通過自定義 Shiro Realm 的子類來使用后臺的數據源 -->
<bean id="myRealm" class="...">
...
</bean>
啟用 Shiro 的注解
在應用程序中,可能需要使用 Shiro 的注釋來進行安全檢查(例如,@RequiresRole、@requiresPermission 等等。這需要 Shiro的 Spring AOP 集成,以掃描適當的帶注釋的類,并在必要時執行安全邏輯。下面是如何啟用這些注釋,將這兩個 bean 定義添加到 applicationContext.xml 中:
<bean class="org.springframework.aop.framework.autoproxy.DefaultAdvisorAutoProxyCreator" depends-on="lifecycleBeanPostProcessor"/>
<bean class="org.apache.shiro.spring.security.interceptor.AuthorizationAttributeSourceAdvisor">
<property name="securityManager" ref="securityManager"/>
</bean>