Spring Security入門程式範例


在本教學中,我們將向您展示如何通過Spring Security使用Spring MVC的Web應用程式來整合一個URL存取。使用 Spring Security 來實現一個「admin」頁面的內容後,驗證使用者輸入正確的「使用者名」和「密碼」。

使用到的技術包括:

  1. Spring 3.2.8.RELEASE
  2. Spring Security 3.2.3.RELEASE
  3. Eclipse 4.2
  4. JDK 1.6
  5. Maven 3
注意:
Spring Security 3.0 需要 Java5.0 或更高版本的執行環境,由於在這一系列教學中使用的是Maven來建立工程,如果不了解 Mave 如何使用的,可以參考:/20/223/8584.html

1. 目錄結構

下面先來看看本教學的最終目錄結構,如下圖所示 -

2. Spring Security依懶

要使用 Spring security 你需要 spring-security-web 和 spring-security-config.

pom.xml
<properties>
		<jdk.version>1.6</jdk.version>
		<spring.version>3.2.8.RELEASE</spring.version>
		<spring.security.version>3.2.3.RELEASE</spring.security.version>
		<jstl.version>1.2</jstl.version>
	</properties>

	<dependencies>

		<!-- Spring dependencies -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-web</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<!-- Spring Security -->
		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-web</artifactId>
			<version>${spring.security.version}</version>
		</dependency>

		<dependency>
			<groupId>org.springframework.security</groupId>
			<artifactId>spring-security-config</artifactId>
			<version>${spring.security.version}</version>
		</dependency>

		<!-- jstl for jsp page -->
		<dependency>
			<groupId>jstl</groupId>
			<artifactId>jstl</artifactId>
			<version>${jstl.version}</version>
		</dependency>

	</dependencies>

4. Spring MVC Web應用程式

一個簡單的控制器:

  1. 如果URL = /welcome 或  / , 返回 hello 頁面;
  2. 如果 URL = /admin , 返回 admin 頁面;
稍後,我們將學習如何使用Spring Security 實現 「/admin」 網址頁面顯示使用者登入表單。
HelloController.java
package com.yiibai.web.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class HelloController {

	@RequestMapping(value = { "/", "/welcome**" }, method = RequestMethod.GET)
	public ModelAndView welcomePage() {

		ModelAndView model = new ModelAndView();
		model.addObject("title", "Spring Security Hello World");
		model.addObject("message", "This is welcome page!");
		model.setViewName("hello");
		return model;

	}

	@RequestMapping(value = "/admin**", method = RequestMethod.GET)
	public ModelAndView adminPage() {

		ModelAndView model = new ModelAndView();
		model.addObject("title", "Spring Security Hello World");
		model.addObject("message", "This is protected page!");
		model.setViewName("admin");

		return model;

	}

}

需要用到兩個JSP 頁面,如下所示 - 

hello.jsp
<%@page session="false"%>
<html>
<body>
	<h1>標題: ${title}</h1>	
	<h1>訊息 : ${message}</h1>	
</body>
</html>
admin.jsp
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@page session="true"%>
<html>
<body>
	<h1>標題: ${title}</h1>
	<h1>訊息 : ${message}</h1>

	<c:if test="${pageContext.request.userPrincipal.name != null}">
	   <h2>歡迎: ${pageContext.request.userPrincipal.name} 
           | <a href="<c:url value="/j_spring_security_logout" />" > Logout</a></h2>  
	</c:if>
</body>
</html>
mvc-dispatcher-servlet.xml
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:context="http://www.springframework.org/schema/context"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="
        http://www.springframework.org/schema/beans     
        http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
        http://www.springframework.org/schema/context 
        http://www.springframework.org/schema/context/spring-context-3.0.xsd">

	<context:component-scan base-package="com.yiibai.*" />

	<bean
	  class="org.springframework.web.servlet.view.InternalResourceViewResolver">
	  <property name="prefix">
		<value>/WEB-INF/pages/</value>
	  </property>
	  <property name="suffix">
		<value>.jsp</value>
	  </property>
	</bean>

</beans>

5. Spring Security : 使用者身份驗證

建立一個 Spring Security XML檔案,如下所示 -

spring-security.xml
<beans:beans xmlns="http://www.springframework.org/schema/security"
	xmlns:beans="http://www.springframework.org/schema/beans" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
	http://www.springframework.org/schema/security
	http://www.springframework.org/schema/security/spring-security-3.2.xsd">

	<http auto-config="true">
		<intercept-url pattern="/admin**" access="ROLE_USER" />
	</http>

	<authentication-manager>
	  <authentication-provider>
	    <user-service>
		<user name="yiibai" password="123456" authorities="ROLE_USER" />
	    </user-service>
	  </authentication-provider>
	</authentication-manager>

</beans:beans>
這裡要說明的是:只有使用者「yiibai」才能允許存取URL:/admin 。

6. 整合Spring Security

通過Spring Security使用Spring MVC Web應用程式整合,只是宣告 DelegatingFilterProxy 作為一個Servlet過濾器來攔截任何傳入的請求。
web.xml
<web-app id="WebApp_ID" version="2.4"
	xmlns="http://java.sun.com/xml/ns/j2ee" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
	http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

	<display-name>Spring MVC Application</display-name>

	<!-- Spring MVC -->
	<servlet>
		<servlet-name>mvc-dispatcher</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet
		</servlet-class>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>mvc-dispatcher</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>

	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener
		</listener-class>
	</listener>

        <!-- Loads Spring Security config file -->
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>
			/WEB-INF/spring-security.xml
		</param-value>
	</context-param>

	<!-- Spring Security -->
	<filter>
		<filter-name>springSecurityFilterChain</filter-name>
		<filter-class>org.springframework.web.filter.DelegatingFilterProxy
		</filter-class>
	</filter>

	<filter-mapping>
		<filter-name>springSecurityFilterChain</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

</web-app>

7. 範例

首先要建立一個 Maven 的 j2ee 工程,然後編寫程式碼完成後,再發布 Maven 工程。按照如下操作,在工程名稱:spsecurity-helloworld-xml 上右鍵,選擇 Run As -> Maven install 如下圖中所示:

Eclipse 開始下載相關聯的依懶包,如下圖中所示 - 


全部就這些,但是等等...登入表單哪來?不用擔心,如果不客製化定義登入表單,Spring會自動建立一個簡單的登入表單。
定義登入表單
請閱讀 「Spring Security登入範例」 以了解如何建立Spring Security中的自定義登入表單。

1. 歡迎頁面 – http://localhost:8080/spsecurity-helloworld-xml/welcome

2. 現在嘗試存取 http://localhost:8080/spsecurity-helloworld-xml/admin 頁面,Spring Security將攔截請求並重定向到 /spring_security_login,並顯示一個預定義的登入表單。

3. 如果使用者名和密碼不正確,那麼將會顯示錯誤資訊,並且 Spring 將重定向到以下網址:/spring_security_login?login_error.

4.如果使用者名和密碼都正確,Spring將請求重定向到原來請求的URL並顯示該網頁內容。

下載原始碼

請點選以下連結下載範例程式碼 – spsecurity-helloworld-xml.zip (9 KB)

參考

  1. Spring Security官方網站
  2. Spring 3 MVC hello world範例
  3. Spring Security登入範例(身份驗證)