用來保護 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()