注釈を使用した 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()