DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 web.xml 控制 Web 應用行為:安全、工作階段與部署設定
編輯:XML詳解     

限制對 Web 資源的存取

告訴容器要用哪一種驗證機制相對容易,真正實用的是「指定哪些 URL 受到保護、應該受到何種保護」,而這正是 security-constraint 元素的用途。它在 web.xml 中應緊接在 login-config 之前,包含四個可能的子元素:web-resource-collection、auth-constraint、user-data-constraint 與 display-name。

web-resource-collection:指定要保護的資源

每個 security-constraint 都必須至少包含一個 web-resource-collection。它由以下元素組成:web-resource-name(任意識別名稱)、url-pattern(要保護的 URL)、http-method(此保護適用的 HTTP 命令,如 GET、POST,預設為全部方法),以及可選的 description。

<security-constraint>
  <web-resource-collection>
    <web-resource-name>Proprietary</web-resource-name>
    <url-pattern>/proprietary/*</url-pattern>
  </web-resource-collection>
  <!-- ... -->
</security-constraint>

這裡有一個容易被忽略的細節:url-pattern 只對直接存取這些資源的用戶端生效。特別是,它不適用於透過 MVC 架構以 RequestDispatcher 轉發的頁面,也不適用於以 jsp:forward 之類手段存取的頁面。

這種不對稱若善加利用其實很有價值。例如 servlet 可依 MVC 架構查詢資料、放進 bean、再把請求轉發到從 bean 取值的 JSP 顯示。我們希望確保這支 JSP 絕不會被直接存取,只能透過建立該 bean 的 servlet 進入。做法很簡單:用 url-pattern 搭配 auth-constraint,宣告不允許任何使用者直接存取該 JSP。不過要留意,這種不對稱也可能讓開發者鬆懈,不小心替應受保護的資源開了不受限的後門。

auth-constraint:指定誰有權存取

web-resource-collection 說明了哪些 URL 該保護,auth-constraint 則說明哪些使用者有權存取。它應包含一個或多個 role-name 元素標識具存取權的角色,以及可選的 description。

<security-constraint>
  <web-resource-collection> ... </web-resource-collection>
  <auth-constraint>
    <role-name>administrator</role-name>
    <role-name>kahuna</role-name>
  </auth-constraint>
</security-constraint>

上面的設定表示只有被指定為 administrator 或 kahuna(或兩者兼具)的使用者能存取該資源。

值得注意的是,可攜性的部分到此為止。伺服器如何判定哪些使用者屬於哪個角色、又如何存放使用者密碼,完全取決於具體實作。以 Tomcat 為例,它使用 install_dir/conf/tomcat-users.xml 把使用者名稱與角色、密碼關聯起來:

<tomcat-users>
  <user name="joe"  password="bigshot" roles="administrator,kahuna" />
  <user name="jane" password="enaj"    roles="kahuna" />
</tomcat-users>

user-data-constraint:傳輸層保護

這個可選元素用來要求存取相關資源時採用傳輸層保護,必須包含一個 transport-guarantee 子元素(合法值為 NONE、INTEGRAL 或 CONFIDENTIAL),並可附帶 description。

NONE 表示不限制通訊協議。INTEGRAL 表示資料必須以能防止截取者閱讀的方式傳送。原理上(並且未來的 HTTP 版本中)INTEGRAL 與 CONFIDENTIAL 可能有差別,但在當時的實務上兩者都只是要求使用 SSL。

<security-constraint>
  <!-- ... -->
  <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
  </user-data-constraint>
</security-constraint>

這段設定指示伺服器只允許以 HTTPS 連線存取相關資源。

display-name

這個少用的子元素為安全限制項目取一個名稱,供 GUI 工具顯示之用。

分配角色別名

前面的討論都集中在完全由容器處理的安全機制上,但 servlet 與 JSP 也能自行處理部分安全判斷。

舉例來說,容器可能允許 bigwig 與 bigcheese 兩種角色存取一個顯示主管專屬資訊的頁面,卻只允許 bigwig 修改頁面上的參數。實作這種更細緻的控制,常見做法是呼叫 HttpServletRequest.isUserInRole() 並據此調整行為。

Servlet 的 security-role-ref 子元素,能為出現在伺服器專屬帳密檔中的角色名稱建立別名。假設你寫了一支呼叫 request.isUserInRole("boss") 的 servlet,後來它被部署到一個角色名為 manager 而非 boss 的伺服器上,下面的寫法讓這支 servlet 同時吃這兩個名稱:

<servlet>
  <!-- ... -->
  <security-role-ref>
    <role-name>boss</role-name>     <!-- 別名 -->
    <role-link>manager</role-link>  <!-- 實際名稱 -->
  </security-role-ref>
</servlet>

此外,也可以在 web-app 內用 security-role 元素,為所有出現在 role-name 中的安全角色提供一份全域清單。分別宣告這些角色,能讓高階 IDE 更容易處理安全資訊。

控制工作階段逾時

若某個工作階段在一段時間內沒有被存取,伺服器可以丟掉它以節省記憶體。你可以直接呼叫 HttpSession.setMaxInactiveInterval() 設定個別工作階段的逾時值;若不這麼做,預設值由伺服器決定。想讓所有伺服器都有一致行為,可用 session-config 與 session-timeout 明確指定。單位是分鐘,下面的例子把預設逾時設為三小時:

<session-config>
  <session-timeout>180</session-timeout>
</session-config>

為 Web 應用寫好文件

當時愈來愈多開發環境直接支援 servlet 與 JSP,例如 Borland JBuilder Enterprise Edition、Macromedia UltraDev、Allaire JRun Studio(撰文時已被 Macromedia 收購)以及 IBM VisualAge for Java。

web.xml 中有不少元素並非給伺服器看,而是給視覺化開發環境用的,包括 icon、display-name 與 description。要記得 web.xml 中 web-app 子元素的順序至關重要,而這三個正好是 web-app 內合法順序的前三名。

icon:指出 GUI 工具可用來代表這個 Web 應用的圖檔。small-icon 指定 16×16 的 GIF 或 JPEG,large-icon 指定 32×32 的圖。

<icon>
  <small-icon>/images/small-book.gif</small-icon>
  <large-icon>/images/tome.jpg</large-icon>
</icon>

display-name:提供 GUI 工具標示此 Web 應用的名稱。

<display-name>Rare Books</display-name>

description:提供說明性文字。

<description>
This Web application represents the store developed for
rare-books.com, an online bookstore specializing in rare
and limited-edition books.
</description>

關聯副檔名與 MIME 類型

伺服器一般都提供方法讓站點管理者把副檔名關聯到媒體類型,例如 mom.jpg 會自動獲得 image/jpeg。但若你的應用有幾個不常見的檔案,需要確保它們送出時帶上正確的 MIME 類型,mime-mapping(含 extension 與 mime-type 子元素)就能派上用場:

<mime-mapping>
  <extension>foo</extension>
  <mime-type>application/x-fubar</mime-type>
</mime-mapping>

這段設定把 application/x-fubar 指派給所有以 .foo 結尾的檔案。同理,你也可以覆寫標準關聯,例如把 .ps 檔以純文字而非 PostScript 送出:

<mime-mapping>
  <extension>ps</extension>
  <mime-type>text/plain</mime-type>
</mime-mapping>

定位 TLD 檔

JSP 的 taglib 指令有一個必要的 uri 屬性,用來給出 TLD(Tag Library Descriptor)檔相對於 Web 應用根節點的位置。問題是 TLD 的實際檔名在標籤庫升版時可能改變,而你不希望去改動所有既有的 JSP;此外,你也會想在 JSP 頁面中保持 uri 簡潔。這正是部署描述符中 taglib 元素的用武之地。

它包含兩個子元素:taglib-uri 要與 JSP 中 taglib 指令的 uri 值一致;taglib-location 則給出 TLD 檔的實際位置。假設你把 chart-tags-1.3beta.tld 放在 WEB-INF/tlds 中:

<taglib>
  <taglib-uri>/charts.tld</taglib-uri>
  <taglib-location>
    /WEB-INF/tlds/chart-tags-1.3beta.tld
  </taglib-location>
</taglib>

如此一來,JSP 頁面就能用簡潔的形式引用標籤庫:

<%@ taglib uri="/charts.tld" prefix="somePrefix" %>

指定應用事件監聽器

應用事件監聽器是在 servlet 環境或工作階段物件建立、修改時被通知的類別,這是 Servlet 規範 2.3 版新增的功能。註冊方式是在 web.xml 的 web-app 內放一個 listener 元素,其中 listener-class 列出監聽器的完整限定類名:

<listener>
  <listener-class>package.ListenerClass</listener-class>
</listener>

結構雖簡單,仍要注意 web-app 子元素的順序:listener 位於所有 servlet 元素之前、所有 filter-mapping 元素之後。另外,由於應用生命週期監聽器是 2.3 版的新功能,必須使用 2.3 版的 web.xml DTD,而非 2.2 版。

以下是一個名為 ContextReporter 的簡單監聽器,只要 Web 應用的 ServletContext 建立(例如載入應用)或消滅(例如伺服器關機)時,就在標準輸出上顯示一則訊息。

package moreservlets;

import javax.servlet.*;
import java.util.*;

/** 當 ServletContext 建立或消滅時,於標準輸出印出報告 */
public class ContextReporter implements ServletContextListener {

    public void contextInitialized(ServletContextEvent event) {
        System.out.println("Context created on " + new Date() + ".");
    }

    public void contextDestroyed(ServletContextEvent event) {
        System.out.println("Context destroyed on " + new Date() + ".");
    }
}

對應的 web.xml 片段:

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
  PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
  "https://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
  <!-- ... -->
  <filter-mapping> ... </filter-mapping>
  <listener>
    <listener-class>package.ListenerClass</listener-class>
  </listener>
  <servlet> ... </servlet>
  <!-- ... -->
</web-app>

J2EE 相關元素

以下元素屬於 J2EE 環境下的 Web 應用設定,更完整的說明可參考 Java 2 Platform Enterprise Edition 1.3 規範第 5 章。

distributable:宣告這個 Web 應用是以「可被分散部署」的方式撰寫,支援叢集(cluster)的伺服器可以安全地把它部署到多台機器上。例如可分散的應用必須只把 Serializable 物件作為 HttpSession 的屬性,並避免用實例變數維持狀態。它緊接在 description 之後,沒有子元素也沒有內容,只是一個標記:

<distributable />

resource-env-ref:宣告一個與資源相關的管理物件,由可選的 description、resource-env-ref-name(相對於 java:comp/env 的 JNDI 名稱)與 resource-env-ref-type(資源類別的完整限定類名)組成。

<resource-env-ref>
  <resource-env-ref-name>jms/StockQueue</resource-env-ref-name>
  <resource-env-ref-type>javax.jms.Queue</resource-env-ref-type>
</resource-env-ref>

env-entry:宣告 Web 應用的環境項目,由可選的 description、env-entry-name(相對於 java:comp/env 的 JNDI 名)、env-entry-value(項目值)與 env-entry-type(java.lang 套件中某型別的完整限定類名,如 java.lang.Boolean、java.lang.String)組成。

<env-entry>
  <env-entry-name>minAmount</env-entry-name>
  <env-entry-value>100.00</env-entry-value>
  <env-entry-type>java.lang.String</env-entry-type>
</env-entry>

ejb-ref:宣告對某個 EJB Home 的引用,由可選的 description、ejb-ref-name(相對於 java:comp/env 的 EJB 引用名)、ejb-ref-type(bean 型別,Entity 或 Session)、home(Home 介面的完整限定名)、remote(Remote 介面的完整限定名)與可選的 ejb-link(連結到同應用中另一個 bean 的名稱)組成。

ejb-local-ref:宣告對 EJB 本地 Home 的引用。除了以 local-home 取代 home 之外,其餘屬性與用法與 ejb-ref 相同。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved