본 장에서는 J2EE 애플리케이션과 EJB 모듈, 웹 모듈에서 보안을 설정하는 방법을 설명한다.
본 절에서는 애플리케이션과 모듈에 보안을 설정하는 것과 관련된 가장 기본적인 이슈를 설명한다.
J2EE 애플리케이션, EJB 모듈, 웹 모듈의 가장 기본적인 보안 설정 과정은 다음과 같다.
Role-to-Resource 매핑을 각 모듈마다 설정한다.
각 애플리케이션에 대해 Principal-to-Role 매핑을 정의한다.
JEUS에서 deploy하는 방법은 크게 2가지로 나누어진다.
EJB 모듈(.jar 파일), 웹 모듈(.war 파일)을 각각 독립적으로 deploy하는 방법
여러 개의 EJB 모듈, 웹 모듈, Connector 모듈(.rar)을 EAR로 압축하여 J2EE 애플리케이션(.ear)으로 deploy하는 방법
Assembler는 EJB 모듈이나 웹 모듈을 deploy하기 전에 해당 모듈에 Role-to-Resource 매핑을 설정해야 한다. Role-to-Resource 매핑을 보안 제약(security constraint)이라고 하며, 논리적인 Role에 모듈의 리소스를 매핑하는 것을 의미한다.
EJB 모듈에서 리소스는 EJB의 메소드를 의미하며, META-INF/ejb-jar.xml에 설정한다.
웹 모듈에서 리소스는 서블릿 URL을 의미하며, WEB-INF/web.xml에 설정한다.
다음은 EJB 모듈에 설정된 보안 제약 내용으로 META-INF/ejb-jar.xml에 설정에 대한 설명이다.
[예 3.1] EJB 모듈에 설정된 보안 제약 : <<ejb-jar.xml>>
<?xml version="1.0"?> <ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"> <display-name>product</display-name> <enterprise-beans> <entity> <ejb-name>product</ejb-name> . . . <security-role-ref> <role-name>cust</role-name> <role-link>customer</role-link> </security-role-ref> </entity> </enterprise-beans> <assembly-descriptor> . . . <security-role> <role-name>administrator</role-name> </security-role> <security-role> <role-name>customer</role-name> </security-role> <method-permission> <role-name>administrator</role-name> <method> <ejb-name>product</ejb-name> <method-intf>Remote</method-intf> <method-name>getSecretKey</method-name> <method-params> <method-param>java.lang.Integer</method-param> </method-params> </method> </method-permission> <method-permission> <unchecked/> <method> <ejb-name>product</ejb-name> <method-name>doSomeAdmin</method-name> <method-params> <method-param>java.lang.String</method-param> </method-params> </method> </method-permission> <method-permission> <role-name>customer</role-name> <method> <ejb-name>product</ejb-name> <method-name>test1</method-name> </method> </method-permission> <exclude-list> <method> <ejb-name>product</ejb-name> <method-intf>Remote</method-intf> <method-name>getCustomerProfile</method-name> <method-params></method-params> </method> </exclude-list> </assembly-descriptor> </ejb-jar>
DD 파일의 각 부분이 의미하는 보안 제약 사항은 다음과 같다.
웹 모듈에 대해서도 EJB와 비슷한 설정이 적용된다. 단, EJB에서 Role이 EJB 메소드를 호출할 수 있느냐의 문제였다면 웹 모듈에서는 Role이 서블릿 URL에 접근할 수 있느냐의 문제를 다룬다. 웹 모듈 보안 설정에 대한 자세한 정보는 “3.3. 웹 모듈 보안 설정”을 참고한다.
지금까지 언급한 2가지 Role, 즉 "administrator"와 "customer"는 논리적 개념으로 실제 deploy되는 환경을 의미하지 않는다. 따라서, 논리적 Role을 실제 환경의 사용자나 사용자 그룹에 매핑하는 작업이 필요하다. 이 작업을 Principal-to-Role 매핑이라 하는데 자세한 내용은 “3.1.3. Principal-to-Role 매핑”에서 설명한다.
일반적으로 Deployer가 J2EE 모듈 또는 애플리케이션에 정의된 Role을 실제 환경의 사용자나 사용자 그룹에 매핑하는 작업을 한다. 여기서, Principal을 논리적 Role에 매핑하는 것은 애플리케이션 범위(scope)를 가진다는 점에 주의해야 한다.
예를 들어 모듈 M1과 M2가 A1이라는 애플리케이션에 포함되어 있다면, Principal-to-Role 매핑은 M1과 M2에서 공유된다. 더 나아가 A2라는 별도의 애플리케이션은 A1과는 완전히 다른 Principal-to-Role 매핑을 가진다. A1과 A2에서 동일한 이름의 Role이 있다고 하더라도 이들은 서로 다른 Role로 인식되며 공유되지 않는다.
다음 그림은 이러한 범위와 관련된 개념에 대한 설명이다.
위 그림에서 보듯이 2개의 서로 다른 애플리케이션(A1, A2)가 서로 다른 Principal-to-Role 매핑을 가지고 있으며, 포함되어 있는 모듈(M1, M2)은 애플리케이션이 포함하고 있는 매핑을 공유한다.
JEUS에서 Principal-to-Role 매핑은 다음의 파일에 설정된다.
JEUS DD인 jeus-ejb-dd.xml(EJB 모듈)
jeus-web-dd.xml(웹 모듈)
jeus-application-dd.xml(J2EE 애플리케이션)
다음은 ejb-jar.xml에 대한 jeus-ejb-dd.xml의 설정 예이다.
[예 3.2] Principal-to-Role 매핑 : <<jeus-ejb-dd.xml>>
<?xml version="1.0"?> <jeus-ejb-dd xmlns=“http://www.tmaxsoft.com/xml/ns/jeus”> <module-info> <role-permission> <principal>user1</principal> <role>administrator</role> <classname>mypackage.MyRolePermission</classname> </role-permission> <role-permission> <principal>user2</principal> <role>customer</role> </role-permission> <role-permission> <role>roleA</role> </excluded> </role-permission> <role-permission> <role>roleB</role> </unchecked> </role-permission> <unspecified-method-permission> <role>administrator</role> </unspecified-method-permission> </module-info> <beanlist> . . . </beanlist> </jeus-ejb-dd>
위의 예제는 다음과 같은 보안 정보를 담고 있다.
"user1"이라는 Principal(user)에게 "administrator" Role을 허가하는 Role Permission이 선언되어 있다. 이는 "user1"이 "administrator" Role의 모든 권한을 가지게 되었다는 것을 의미한다. 예제에서 보듯이 Cusotom Role Permission은 <classname> 태그로 정의한다. Cusotom Role Permission에 대한 자세한 정보는 “제2장 보안 시스템 설정”을 참고한다. | |
"user2"라는 Principal(user)에게 "customer" Role을 부여하는 Role-Permission이 선언되어 있다. 이는 "user2"가 "customer" Role이 가지는 모든 권한을 가지게 되었다는 의미이다. <classname> 태그가 설정되어 있지 않았으므로, 디폴트 Role Permission이 설정되어 있다. | |
"roleA"라는 Role은 모든 Principal로부터 배제되어(excluded) 있다. 즉, 어떤 Principal도 "roleA"에 포함될 수 없다. | |
"roleB"라는 Role은 권한 부여 시스템에서 체크되지 않는다.(unchecked) 즉, 모든 Principal은 자동으로 "roleB"에 포함된다. | |
<unspecified-method-permission>은 "unspecified" EJB 메소드를 기본적으로 어떻게 다룰지 결정한다. "unspecified" EJB 메소드는 ejb-jar.xml에서 <method-permission> 태그로 언급되지 않은 메소드를 의미한다. <unspecified-method-permission>은 3가지 방식으로 처리할 수 있다. Role에 매핑(예제에서는 "administrator" Role에 매핑되었다)하거나, excluded(누구도 접근할 수 없는 것)로 취급하거나, unchecked(누구나 접근할 수 있는 것)로 취급하는 것이 그것이다. 마지막 unchecked 옵션이 기본값이다. |
웹 모듈(jeus-web-dd.xml)의 설정은 <unspecified-method-permission> 설정이 없다는 것을 제외하고, EJB 모듈에서 설정과 동일하다.
사용자 설정은 크게 2가지로 나누어진다.
애플리케이션에서 사용하는 도메인 자체의 사용자 설정을 이용하는 방식으로 다음의 파일에 설정한다. (“2.5. 보안 시스템 사용자 정보 설정” 참조)
JEUS_HOME/domains/<domain name>/config/security/<security domain name>/accounts.xml
EJB 모듈(.jar 파일), 웹 모듈(.war 파일), J2EE 애플리케이션(.ear)자체의 사용자 설정 방식으로 WEB-INF(웹 모듈) 또는 META-INF(EJB 모듈 및 EAR) 디렉터리 안의 accounts.xml을 설정한다.
사용자 정보는 위의 어떤 방식으로 설정을 했는지에 관계없이 애플리케이션의 보안 도메인 범위(scope)을 가진다. 즉, 한 보안 도메인에서의 사용자는 같은 보안 도메인을 사용하는 모든 애플리케이션 내에서 공유된다.
본 절에서는 EJB 모듈에 보안 설정하는 방법을 자세하게 설명한다. 본 절에서 다루지 않은 CSI와 같은 보안 설정들은 "JEUS EJB 안내서"를 참고한다.
보안 설정 방법은 크게 2가지로 나눌 수 있다.
ejb-jar.xml에 다음과 같은 보안 요소를 설정할 수 있다.
Role-to-Role Reference 매핑
security identity 설정
논리적 Role 선언
EJB 메소드 Permission 설정
다음 예제는 위 보안 설정 요소를 포함하는 ejb-jar.xml이다.
[예 3.3] 보안 설정 : <<ejb-jar.xml>>
<?xml version="1.0"?> <ejb-jar xmlns="http://java.sun.com/xml/ns/j2ee"> <display-name>product</display-name> <enterprise-beans> <entity> <ejb-name>product</ejb-name> . . . <security-role-ref> <role-name>cust</role-name> <role-link>customer</role-link> </security-role-ref> <security-identity> <run-as> <role-name>administrator</role-name> </run-as> </security-identity> </entity> </enterprise-beans> <assembly-descriptor> . . . <security-role> <role-name>administrator</role-name> </security-role> <security-role> <role-name>customer</role-name> </security-role> <method-permission> <role-name>administrator</role-name> <method> <ejb-name>product</ejb-name> <method-intf>Remote</method-intf> <method-name>getSecretKey</method-name> <method-params> <method-param>java.lang.Integer</method-param> </method-params> </method> </method-permission> <method-permission> <unchecked/> <method> <ejb-name>product</ejb-name> <method-name>doSomeAdmin</method-name> <method-params> <method-param>java.lang.String</method-param> </method-params> </method> </method-permission> <method-permission> <role-name>customer</role-name> <method> <ejb-name>product</ejb-name> <method-name>test1</method-name> </method> </method-permission> <exclude-list> <method> <ejb-name>product</ejb-name> <method-intf>Remote</method-intf> <method-name>getCustomerProfile</method-name> <method-params></method-params> </method> </exclude-list> </assembly-descriptor> </ejb-jar>
ejb-jar.xml에 다음과 같은 보안 요소를 설정할 수 있다.
Role-to-Role Reference 매핑
Role-to-Role Reference 매핑은 <security-role-ref> 태그로 정의한다. 목적은 실제 논리적 Role에 대한 참조를 설정하는 것이다. 그래서 EJB 소스에서는 실제 Role대신 Role Reference를 사용하게 된다.
다음 태그는 <security-role-ref> 태그 내에서 사용하는 태그이다.
Security Identity 설정
모듈 내에 있는 각 EJB는 다른 EJB로 원격지를 호출할 때 자신의 Security Identity를 전파한다.
EJB의 Security Identity는 <ejb-jar> <enterprise-beans> <type> <security-identity> 태그로 설정한다.
다음과 같은 하위 태그를 가지고 있다.
EJB 메소드 Permission 설정
<assembly-descriptor>의 하위 태그인 <method-permission> 태그는 각 EJB 메소드에 보안 제약을 설정하는 태그이다.
다음의 하위 태그를 설정한다.
<security-role> 태그에 선언되어 있는 논리적 Role 이름으로 아래에 정의된 메소드에 접근할 수 있다.
값이 없는 empty 태그로 설정되어 있으면 아래에 정의된 메소드는 권한 체크를 하지 않는다. 즉, Role에 상관없이 누구나 메소드에 접근할 수 있다.
<role-name> 또는 <unchecked> 태그가 적용되는 메소드로 하위 태그는 다음과 같다.
단 하나의 <exclude-list>가 올 수 있으며, Excluded되는 EJB 메소드를 정의한다. 즉, 누구도 접근할 수 없는 메소드이다. 하위 태그로 1개 이상의 <method> 태그를 가질 수 있다.
예제에 대한 설명은 “3.1.2. Role-to-Resource 매핑”을 참고한다. 각 태그에 대한 자세한 설명은 EJB 스펙을 참고한다. 또한 JEUS에서 EJB를 Deploy하는 방법은 "JEUS EJB 안내서"를 참고한다.
jeus-ejb-dd.xml에 다음과 같은 보안 요소를 설정할 수 있다.
보안 관련된 설정
ejb-jar.xml에 설정되어 있지 않는 EJB 메소드 설정
Run-as Identity를 사용하는 EJB Principal 설정
EJB에서 대부분 Role-to-Method 매핑은 ejb-jar.xml에 설정되어 있으나, ejb-jar.xml에서 설정되어 있지 않는 메소드를 어떻게 다룰지와 실제 Principal-to-Role 매핑을 어디서 선언할지는 여전히 해결해야 할 문제이다. 이는 EJB.jar 파일의 META-INF 디렉터리에 존재하는 jeus-ejb-dd.xml 파일에서 설정한다.
다음 예제는 위 보안 설정 요소를 포함하는 jeus-ejb-dd.xml이다.
[예 3.4] 보안 설정 : <<jeus-ejb-dd.xml>>
<?xml version="1.0"?> <jeus-ejb-dd xmlns=“http://www.tmaxsoft.com/xml/ns/jeus”> <module-info> <role-permission> <principal>user1</principal> <role>administrator</role> <classname>mypackage.MyRolePermission</classname> </role-permission> <role-permission> <principal>user2</principal> <role>customer</role> </role-permission> <role-permission> <role>roleA</role> </excluded> </role-permission> <role-permission> <role>roleB</role> </unchecked> </role-permission> <unspecified-method-permission> <role>administrator</role> </unspecified-method-permission> </module-info> <beanlist> <jeus-bean> . . . <run-as-identity> <principal-name>user1</principal-name> </run-as-identity> </jeus-bean> . . . </beanlist> </jeus-ejb-dd>
jeus-ejb-dd.xml에 다음과 같은 보안 요소를 설정할 수 있다.
보안 관련된 설정
jeus-ejb-dd.xml에서 대부분 보안 관련된 설정의 <jeus-ejb-dd> 루트 태그 바로 아래에 있는 <module-info> 태그 내에 설정된다.
각 태그는 Role(Principal-to-Role 매핑)을 정의하고 있다.
다음은 <role-permission>의 하위 태그에 대한 설명이다.
본 절에서는 웹 모듈(서블릿 모듈)에 보안 설정하는 방법을 설명한다.
웹 모듈의 보안 설정은 크게 2가지로 구성된다.
web.xml 설정 : Role-to-Web Resource 매핑 설정
jeus-web-dd.xml 설정 : Principal-to-Role 매핑 설정
web.xml은 Web Archive(WAR 파일)에 대한 메인 DD 파일이다. 표준 J2EE DD 파일로 WAR 파일의 WEB-INF 디렉터리 내에 있다.
web.xml에서 설정할 수 있는 보안 요소는 다음과 같다.
서블릿 URL 접근 Permissions (Security constraints, 보안제약)
서블릿 URL에 접근을 제한하려는 목적으로 <web-app> 태그 바로 아래에 있는 <security-constraint> 태그를 사용한다.
<security-constraint>는 다음과 같은 하위 태그를 가진다.
<web-resource-collection> (1개 이상)
접근 제한이 설정되는 웹 리소스의 목록을 나타낸다.
<security-constraint> 태그 내에 정의된 웹 리소스에 접근할 수 있는 Role을 설정한다. 하위 태그로는 0개 이상의 <role-name> 태그가 오는데 각각은 접근이 허락된 Role을 나타낸다.
Role 이름이 설정되어 있지 않고 empty 태그 (<auth-constraint/>)로 설정되어 있다면, 아무도 해당 웹 리소스에 접근할 수 없다는 의미이다(이는 웹 리소스가 excluded된다는 것과 동일하다).
<auth-constraint> 태그가 아예 생략되어 있다면 이는 웹 리소스가 unchecked된다는 것으로 Role에 상관없이 누구나 웹 리소스에 접근할 수 있다는 의미이다.
웹 리소스에 맺어지는 커넥션에 대해 "transport guarantee"(전송 보장)할 것인가를 선언하는 태그다.
하위 태그로 <transport-guarantee> 태그를 가지며, 웹 리소스로의 커넥션을 보장하는 레벨을 나타낸다.
다음은 web.xml의 보안 설정 예제이다.
[예 3.5] 웹 모듈 보안 설정 : <<web.xml>>
<?xml version="1.0"?> <web-app xmlns="http://java.sun.com/xml/ns/j2ee"> <servlet> <servlet-name>HelloWorld</servlet-name> . . . <run-as> <role-name>R1</role-name> </run-as> <security-role-ref> <role-name>adminRef</role-name> <role-link>R1</role-link> </security-role-ref> . . . </servlet> <security-constraint> <web-resource-collection> <web-resource-name>A</web-resource-name> <url-pattern>/a/*</url-pattern> <url-pattern>/b/*</url-pattern> <url-pattern>/a</url-pattern> <url-pattern>/b</url-pattern> <http-method>DELETE</http-method> <http-method>PUT</http-method> </web-resource-collection> <web-resource-collection> <web-resource-name>B</web-resource-name> <url-pattern>*.asp</url-pattern> </web-resource-collection> <auth-constraint/> </security-constraint> <security-constraint> <web-resource-collection> <web-resource-name>C</web-resource-name> <url-pattern>/a/*</url-pattern> <url-pattern>/b/*</url-pattern> <http-method>GET</http-method> </web-resource-collection> <web-resource-collection> <web-resource-name>D</web-resource-name> <url-pattern>/b/*</url-pattern> <http-method>POST</http-method> </web-resource-collection> <auth-constraint> <role-name>R1</role-name> </auth-constraint> <user-data-constraint> <transport-guarantee> CONFIDENTIAL </transport-guarantee> </user-data-constraint> </security-constraint> <security-role> <role-name>R1</role-name> </security-role> <security-role> <role-name>R2</role-name> </security-role> <security-role> <role-name>R3</role-name> </security-role> </web-app>
위 예제의 각각의 부분이 의미하는 내용은 다음과 같다.
웹 리소스(URL 패턴 + HTTP 메소드)가 web.xml에 별도로 설정되어 있지 않으면, 해당 리소스는 Role에 상관없이 누구나 접근할 수 있다는 의미이다. 이는 J2EE에서 웹 애플리케이션 접근에 대한 기본값이다.
web.xml에 나타나는 모든 태그들에 대한 자세한 정보는 서블릿 스펙을 참고한다. 또한 JEUS에서 서블릿을 deploy하는 것에 대한 추가적인 정보는 "JEUS Web Engine 안내서"를 참고한다.
웹 모듈에 대한 JEUS DD 파일인 jeus-web-dd.xml에서 보안을 설정하는 방법에 대해 설명한다.
Principal-to-Role 매핑 정의
jeus-web-dd.xml에서 Principal-to-Role 매핑을 정의하기 위해 <jeus-web-dd><context><role-mapping> 태그를 사용한다.
다음은 <role-mapping>의 하위 태그들이다.
Role에 대한 Permission을 (보통 Principal-to-Role 매핑) 다음이 하위 태그에 설정한다.
서블릿에서 <run-as-principal> 설정
서블릿에서 <run-as-principal>을 설정하기 위해 <servlet> 태그를 선언하고 <run-as><principal-name> 태그를 추가한다. <principal-name> 태그 값은 web.xml에서 <run-as><role-name>에 선언된 Role에 속하는 Principal이어야 한다.
현재로는 web.xml에서 언급되어 있지 않는 서블릿 URL을 어떻게 다룰지 정의하는 태그가 jeus-web-dd.xml에 없다. 서블릿 스펙에서는 모든 정의되지 않은 URL을 항상 Unchecked로 취급한다. 즉, 누구나 접근할 수 있다.
다음은 jeus-web-dd.xml의 보안 설정 예제이다.
[예 3.6] 웹 모듈 보안 설정 : <<jeus-web-dd.xml>>
<?xml version="1.0"?> <jeus-web-dd xmlns=“http://www.tmaxsoft.com/xml/ns/jeus”> <context> <context-path>/tutorial</context-path> <docbase>Tutorial</docbase> . . . <role-mapping> <role-permission> <principal>user1</principal> <principal>user2</principal> <principal>customerGroup</principal> <role>R1</role> </role-permission> <role-permission> <role>R2</role> </excluded> </role-permission> <role-permission> <role>R3</role> </unchecked> </role-permission> <role-permission> <principal>tellerGroup</principal> <role>R4</role> <actions>09:00-17:00</actions> <classname> jeus.security.resource.TimeConstrainedRolePermission </classname> </role-permission> </role-mapping> <servlet> <servlet-name>HelloWorld</servlet-name> <run-as-identity> <principal-name>user1</principal-name> </run-as-identity> . . . </context> </servlet> . . . </jeus-web-dd>
위 예제의 각 부분에 대한 의미는 다음과 같다.
본 절에서는 J2EE 애플리케이션(EAR 파일)의 보안을 설정하는 방법을 설명한다.
기본적인 설정 방법은 다음과 같다.
application.xml 설정 : 논리적 Role을 선언
jeus-application-dd.xml 설정 : deploy할 보안 도메인과 Principal-to-Role 매핑을 설정
J2EE 애플리케이션은 .ear 확장자를 가진 Archive 파일이다. EAR Archive는 EJB 모듈, 웹 모듈, Connector 모듈 그리고 모듈에서 참조하고 있는 클래스들로 구성되어 있다. META-INF 디렉터리는 application.xml 설정 파일을 포함하고 있는데, 전체 애플리케이션에 대한 여러 가지 정보를 제공한다.
본 절에서는 application.xml에서 보안과 관련된 부분을 설명한다.
기본적으로 application.xml에는 보안과 관련된 설정은 논리적 Role을 설정하는 단 한 가지 밖에 없다. Role 선언은 EAR 파일 내에 있는 모든 EJB 모듈과 웹 모듈에 공통으로 적용되며 애플리케이션 범위(scope)를 가진다.
[예 3.7] J2EE 애플리케이션 보안 설정 : <<application.xml>>
<?xml version="1.0" encoding="UTF-8"?> <application version="1.4" . . .> <description>Application description</description> <display-name>myApp</display-name> <module> <web> <web-uri>myWebApp.war</web-uri> <context-root>myWebApp</context-root> </web> </module> <module> <ejb>myEjbApp.jar</ejb> </module> <security-role> <role-name>Administrator</role-name> </security-role> <security-role> <role-name>Customer</role-name> </security-role> </application>
위의 예제에서는 "Administrator", "Customer" 2가지 Role이 선언되었다.
두 가지 Role은 Role-to-Resource 매핑을 정의하기 위해 EJB 모듈과 웹 모듈의 DD 파일에서 사용된다. EJB 모듈과 웹 모듈 보안에 대해서는 “3.2. EJB 모듈 보안 설정”과 “3.3. 웹 모듈 보안 설정”에서 이미 설명되었다.
애플리케이션을 JEUS 서버에 deploy하기 전에 논리적 Role이 실제 Principal에 매핑되었는지 확인해야 한다. 이 매핑은 각각의 경우에 따라 아래 파일에 매핑된다.
애플리케이션의 경우 : jeus-application-dd.xml
EJB 모듈의 경우 : jeus-ejb-dd.xml (Principal-to-Role 설정은 “3.2.2. jeus-ejb-dd.xml 설정”을 참고)
웹 모듈의 경우 : jeus-web-dd.xml (Principal-to-Role 설정은 “3.3.2. jeus-web-dd.xml 설정”을 참고)
애플리케이션 전체에서 Role과 Principal-to-Role 매핑을 공유하기 때문에 J2EE 애플리케이션에 포함되어 있는 모든 모듈을 잘 알고 있어야 한다. 가령, application.xml에 "Administrator"라는 Role을 설정해 놓고, jeus-application-dd.xml에서 "user2"라는 Principal을 할당했다고 가정한다. 이 Role 매핑은 애플리케이션에 포함된 모든 EJB 모듈과 웹 모듈에서 적용된다.
비슷하게 Role과 Principal-to-Role 매핑을 특정 EJB의 jeus-ejb-dd.xml에만 정의했다고 해도 설정된 Role과 Principal-to-Role 매핑은 .ear에 포함된 모든 모듈에서 여전히 공유될 수 있다.
J2EE 애플리케이션에서 모든 Principal-to-Role 매핑은 그것이 jeus-application-dd.xml에 설정되어 있든 특정 jeus-ejb-dd.xml이나 jeus-web-dd.xml에 설정되어 있든 상관없이 애플리케이션 범위(scope)를 가진다는 점을 주의한다.
애플리케이션 레벨에서 Principal-to-Role 매핑은 jeus-application-dd.xml에 설정한다.
Principal-to-Role 매핑을 정의하기 위해 jeus-application-dd.xml의 <application> 태그 아래에 다음 태그들을 추가한다.
<role-permission> 태그는 Principal-to-Role 매핑을 정의하며, 선택적으로 Excluded, Unchecked Role을 설정할 수 있다. 이 태그는 jeus-web-dd.xml, jeus-ejb-dd.xml, policies.xml과 완전히 동일하게 동작한다.
다음의 하위 태그를 가진다.
<application> 태그 아래에 해당 애플리케이션이 deploy되는 보안 도메인을 설정해 놓아야 한다. 기본값으로 'SYSTEM_DOMAIN'이 사용되지만, 특정 애플리케이션이 특별한 보안 서비스를 필요로 한다면 해당 보안 서비스를 포함하고 있는 새로운 도메인을 생성해서 deploy해야 한다.
jeusadmin의 deploy 명령에서 보안 도메인 이름을 설정할 수 있다.
위의 예제에서, J2EE 애플리케이션 보안을 다음과 같이 설정했다.
"user2"라는 Principal은 "Administrator" Role에 매핑되어 있으며, 디폴트 RolePermission을 사용한다. | |
모든 Principal에 "Customer" Role을 부여한다(Role이 unchecked되었기 때문이다). |
1. 보안 도메인을 설정하는 방법은 “2.2. 보안 도메인 정의”을 참고한다.
2. Cusotom Permission을 개발하고 설정하는 방법은 “2.6. 보안 시스템 정책 설정”을 참고한다.
3. JEUS에 J2EE 애플리케이션을 deploy하는 방법은 "JEUS Server 안내서"를 참고한다.
본 절에서는 위에서 설명한 설정을 기반으로 작성한 예제에 대해 간략하게 설명한다.
다음 화면은 최초로 접속할 때의 로그인 화면이다. 해당 URL에 checked permission이 설정된 경우에만 보이며, Unchecked permission일 때는 이 화면이 생략되고 바로 페이지가 표시된다. Excluded permission일 때는 Authorization이 실패하고 에러 화면이 나타난다.
인증에 실패하였거나 권한이 없는 계정으로 로그인했을 경우 에러 페이지가 나타난다. 권한이 있는 계정으로 로그인에 성공하면 다음과 같은 화면이 나타난다.
이 예제는 메인 페이지에서 3개의 서블릿으로 링크가 걸려 있으며, 3개의 EJB 메소드를 호출하게 된다. 로그인한 계정과 설정 파일에 따라 접근할 수 있는지 여부에는 차이가 있으므로 여러 가지 설정을 하고 여러 계정으로 로그인해 보면서 직접 확인해본다.