用來保護 Java EE 應用程式安全的註釋

您可以使用註釋,直接在您的原始碼中為 Java™ EE 企業應用程式提供安全保護。

一般安全註釋:JSR 250 有定義若干一般安全註釋。已定義五種安全註釋:
  • javax.annotation.security.PermitAll:
    • 可以用在類型或方法層次。
    • 指出每個人都可以存取給定的方法,或是給定 EJB 的所有商業方法。
  • javax.annotation.security.DenyAll:
    • 可以用在方法層次。
    • 指出任何人都無法存取 EJB 中的給定方法。
  • javax.annotation.security.RolesAllowed:
    • 可以用在類型或方法層次。
    • 指出與角色清單相關聯的使用者可以存取給定的方法,或是 EJB 中的所有商業方法。
  • javax.annotation.security.DeclareRoles:
    • 可以用在類型層次。
    • 定義要用於安全檢查的角色。供 EJBContext.isCallerInRole、HttpServletRequest.isUserInRole 和 WebServiceContext.isUserInRole 使用。
  • javax.annotation.security.RunAs:
    • 可以用在類型層次。
    • 為給定的元件指定執行身分角色。

使用安全註釋

  • 針對 @PermitAll、@DenyAll 和 @RolesAllowed 註釋,類別層次註釋套用至類別,而方法層次註釋套用至方法。方法層次註解會置換類別層次註釋的行為。
    	@Stateless
    	@RolesAllowed("team")
    	public class TestEJB implements Test {
    		@PermitAll
    		public String hello(String msg) {
    			return "Hello, " + msg;
    		}
    
    		public String goodbye(String msg) {
    			return "Goodbye, " + msg;
    		}
    	}
     

    在此範例中,每個人都可以存取 hello() 方法,而角色團隊的使用者可以存取 goodbye() 方法。

  • @DeclareRoles 註釋定義要供給定元件使用的角色清單。在 Java EE 5 或 6 環境中,您可以使用 @javax.annotation.Resource 來查閱資源,並呼叫下列 API 來驗證使用者是否為給定的角色:
    表 1. . Java EE 元件所使用的 API
    元件 用來檢查角色的 API
    EJB javax.ejb.EJBContext.isCallerInRole(role)
    Servlet javax.servlet.http.HttpServletRequest.isUserInRole(role)
    Web 服務 javax.xml.ws.WebServiceContext.isUserInRole(role)
  • @PermitAll、@DenyAll 和 @RolesAllowed 註釋可讓您實作大部分授權決策。不過,若要達成較複雜的邏輯,請使用 @DeclareRoles 註釋。例如,假設要讓具有角色 A 但不能同時具有角色 B 的使用者存取 hello 方法。下列程式碼片段可以達成這個目標:
    	@Stateless
    	@DeclaresRoles({"A", "B"})
    	public class TestEJB implements Test {
    		@Resource private SessionContext sc;
    		public String hello(String msg) {
    			if (sc.isCallerInRole("A") && !sc.isCallerInRole("B")) {
    				...
    			} else {
    				...
    			}
    		}
    	}
     

無效的安全註釋使用方式

  • 不能將多個 @DenyAll、@PermitAll、@RolesAllowed 套用至相同的方法。例如,下列用法無效:
    	@PermitAll
    	@DenyAll
    	public String test()
     
  • 不能將兩個 @RolesAllowed 註釋套用至相同的方法。例如,下列用法無效,並且會在編譯時失敗:
    	@RolesAllowed("team")
    	@RolesAllowed("otherteam")
    	public String hello()
    請改為使用此結構:
    	@RolesAllowed({"team", "otherteam"})
    	public String hello()
Icon that indicates the type of topic Concept topic
Timestamp icon Last updated: last_date

File name: csecuringejee.html