注釈を使用した Java EE アプリケーションの保護

注釈を使用して、ソース・コード内で直接 Java™ EE エンタープライズ・アプリケーションにセキュリティーを指定できます。

共通セキュリティー注釈: JSR 250 では、 いくつかの共通セキュリティー注釈を定義しています。次の 5 つのセキュリティー注釈が定義されています。
  • 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:
    • 型レベルで使用できます。
    • 所定のコンポーネントの 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() メソッドには team 役割のユーザーがアクセスできます。

  • @DeclareRoles 注釈は、所定のコンポーネントが使用する役割のリストを定義します。 Java EE 5 または 6 環境では、@javax.annotation.Resource を使用してリソースをルックアップし、以下の API を呼び出して所定の役割を持つユーザーかどうかを検証できます。
    表 1. . Java EE コンポーネントによって使用される API
    コンポーネント 役割の検査に使用される API
    EJB javax.ejb.EJBContext.isCallerInRole(role)
    サーブレット javax.servlet.http.HttpServletRequest.isUserInRole(role)
    Web サービス javax.xml.ws.WebServiceContext.isUserInRole(role)
  • @PermitAll、@DenyAll、および @RolesAllowed の注釈では、 ほとんどの許可デシジョンを実施できます。ただし、より複雑なロジックを実現するには、 @DeclareRoles 注釈を使用します。例えば、 hello メソッドに、役割 A であり、同時に役割 B ではないユーザーがアクセスできるようにするとします。 これは、以下のコード・クリップによって実行できます。
    	@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()
     
  • 同じメソッドに 2 つの @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