JEUS_HOME\config\<node_name>\JEUSMain.xml 내의 다음 태그를 이용하여 설정한다.

도메인에 대한 XML 파일 설정 방법은 JEUS_HOME\lib\schemas\jeus 디렉터리 내의 jeus-main.xsd와 jeus-security.xsd의 XML 스키마에 정의되어 있다. 상위 태그는 <security-manager>이며, 이 태그는 도메인 설정과 관련된 다음 하위 태그를 가진다. 하위 태그는 0개 이상씩 설정 가능하다.

<security-manager>
    <security-domains>
        <security-domain>
           <name>domain name</name>
           ...
        </security-domain>
        <security-domain>
           <name>domain name</name>
           ...
        </security-domain>
    <security-domains>
</security-manager>           

다음은 설정 태그에 대한 설명이다.

다음은 도메인 계정 및 정책 설정하는 과정에 대한 설명이다.

사용자 설정을 할 때 패스워드를 지정해야 한다. 패스워드는 특정 알고리즘을 사용해 인코딩한 데이터를 정의한다. 기본 패스워드 인코딩 방식은 plain-text이다.

특정 Hash 알고리즘이나 JCE에서 정의한 Cipher 알고리즘 값을 적용해서 <password> 값을 생성 한 경우 해당 값에 적용된 다음의 정의된 알고리즘 혹은 인코딩 정보를 <password> 값으로 함께 설정한다.

encryption 툴을 통해서 패스워드를 암호화하는 경우 해당 암호화 파일에 적용되는 SecretKey 정보를 security.key 파일에 암호화 알고리즘 별로 저장하여 관리한다.

Master Password를 입력받아 이 패스워드로 security.key 파일을 암호화하여 저장할 수 있다. security.key 파일은 다음 경로에 위치한다. 클러스터링 환경을 구성하는 경우 해당 security.key 파일을 함께 다른 노드에 옮겨놓아야 한다

JEUS_HOME\config\<node_name>\security\

JEUS에 등록하는 DB 패스워드를 암호화하였을 경우 클라이언트에서는 이를 decrypt하기 위해 key가 필요하다. 이때 secret key file path를 system property를 이용해 설정할 수 있다.

또한, security.key 파일에 Master Password가 설정된 경우 Master Password도 system property를 이용해서 설정할 수 있다. key path를 지정하는 property 이름은 jeus.security.keypath이며, Master Password를 설정하려면 jeus.security.master를 이용하면 된다. 이 property들은 JEUS를 기동할 때도 이용할 수 있다. 다만, 보안의 이유로 Master Password는 프롬프트(standard input)로 입력하는 것을 권장한다.

본 절에서는 JEUS가 정의한 DB 테이블을 이용한 Authentication을 설정하는 방법에 대해서 설명한다.

다음 예제는 JEUS에 정의한 Datasource를 이용할 때 설정하는 방법이다.

<?xml version="1.0" encoding="UTF-8"?>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    . . .
    <security-manager>
        <seuciry-domains>
            <security-domain>
                <name>MY_DOMAIN</name>
                    <authentication>
                        <repository-service>
                            <database-repository>
                              <datasource-export-name>auth</datasource-export-name>
                            </database-repository>
                        </repository-service>
                    </authentication>
                    . . .
                </security-domain>
            </security-domains>
        </security-manager>
        . . .
</jeus-system> 

위의 예제에서 <datasource-export-name>에는 authentication에 사용할 JEUSMain.xml에 등록한 datasource의 export-name을 명시해야 한다. 또 다른 방법으로 DriverManager를 이용해 JEUS에서 제공하는 JDBC를 이용하지 않고 직접 DB와 통신하면서 authentication을 이용할 수 있는데, 위의 예제에서 <datasource-export-name> 태그 부분을 다음과 같이 변경하면 된다.

다음 예제는 JEUS JDBC를 이용하지 않을 때 DB repository를 설정하는 방법이다.

<security-manager>
  ...
    <repository-service>
        <dbdriver-config>
           <vendor>oracle</vendor>
           <driver>oracle.jdbc.OracleDriver</driver>
           <url>jdbc:oracle:thin:@127.0.0.1:1521:ORA9I</url>
           <username>scott</username>
           <password>{base64}dGlnZXI=</password>
        </dbdriver-config>
     </repository-service>
  ...
</security-manager>

데이터베이스에서 사용되는 테이블은 다음과 같이 구성된다.

[그림 2.1] Subject에 대한 사용자 정보를 저장하기 위한 데이터베이스 테이블 구조

데이터베이스에 테이블이 존재하지 않을 경우 JEUS_HOME\config\security\dbrealm.sql 파일을 이용해서 DB에 테이블을 생성하면 사용자명이 jeus, 패스워드가 jeus인 사용자가 최초로 생성된다.

Permission(Role Permission 또는 Resource Permission)을 policies.xml 파일에 추가할 때마다, Permission을 나타내는 Java 클래스명을 설정해야 한다. 해당 클래스는 java.security.Permission 추상 클래스를 확장한 것이다. 자신만의 java.security.Permission 구현 클래스를 생성해서 policies.xml에 <classname> 태그로 설정해 두면 Custom Permission을 직접 만들 수 있다.

다음 요구사항을 가진 새로운 Custom Permission을 구현하는 방법을 설명한다.

새로운 Role Permission은 원래의 Role 외에 다음과 같은 2가지 조건이 충족되는 상황에서 또 다른 Role을 암시할 수 있다.

예를 들어, 이러한 Role Permission은 뱅킹 애플리케이션에서 "peter"라는 Principal이 오전 9시부터 오후 5시까지 업무시간 동안만 "teller"라는 Role을 가질 수 있도록 만들 수 있다.

이를 위해 2가지 작업이 필요하다.

다음은 위의 요구사항을 만족하는 Custom Permission 클래스를 구현한 것으로 자세한 코드는 생략한다.

package jeus.security.resource;

import java.security.Permission;
import java.util.Calendar;
import java.util.StringTokenizer;

/**
 * A time-constrained Role permission.
 * <p>
 * With this permission implementation you can express
 * things such as "X can only be in the role Y between
 * 09:00 AM to 05:00 PM".
*/
public class TimeConstrainedRolePermission extends RolePermission {
    private String timeConstraint = "*";
    private int startTime = Integer.MIN_VALUE;
    private int endTime = Integer.MAX_VALUE;

    public TimeConstrainedRolePermission(String roleName) {
        this(roleName, "*");
    }

    public TimeConstrainedRolePermission(String roleName, String timeConstraint)
    {
        super(roleName);
        if (timeConstraint != null) {
            this.timeConstraint = timeConstraint;
            parseTimeConstraint();
        }
    }

    private void parseTimeConstraint() {
                 . . .
    }

    public boolean equals(Object anotherObject) {
                 . . .
    }

    public int hashCode() {
                 . . .
    }

    public String getActions() {
        return timeConstraint;
    }

    public boolean implies(Permission anotherPermission) {
        if (this.timeConstraint.equals("*")) {
            return super.implies(anotherPermission);
        } else {
            Calendar cal = Calendar.getInstance();
            int curHour = cal.get(Calendar.HOUR_OF_DAY);
            int curMinute = cal.get(Calendar.MINUTE);

            int now = curHour * 60 + curMinute;
            if (now >= this.startTime && now <= this.endTime) {
                return super.implies(anotherPermission);
            } else {
                return false;
            }
        }
    }
}   

해당 클래스는 jeus.security.resource.RolePermission을 상속하고, jeus.security.resource.RolePermission은 다시 java.security.Permission을 상속한다. 이는 코드 재사용성을 높이기 위한 구조이다.

TimeConstrainedRolePermission을 상속해 또 다른 java.security.Permission을 만드는 것도 가능하다.

위의 소스 일부에서 보듯이, 2가지 타입의 생성자가 있다.

첫 번째는(role name) 하나의 파라미터만 받고 있고, 두 번째는(role name, time constraint) 2개의 파라미터를 받는다.

java.security.Permission에서 첫 번째 파라미터는 "name"을 뜻하고 두 번째 파라미터는 "actions"를 뜻한다. "actions" 파라미터는 Permission에 대한 유효 시간을 나타내며, “09:00-17:00”라는 값을 가진다. "name"은 "administrator" 또는 "teller"와 같은 Role 이름을 나타낸다. 몇몇 Permission 구현 클래스는 "actions" 파라미터를 받는 두 번째 타입의 생성자가 생략되기도 한다.

소스의 핵심은 implies(Permission anotherPermission) 메소드로 현재 시스템 시간이 주어진 유효 시간내에 있는지 체크한 다음, 만약 그렇다면 super.implies() 메소드를 호출하고, 그렇지 않으면 false를 리턴한다. 모든 implies() 메소드는 boolean 값을 리턴하게 되어 있는데, 해당 Permission이 파라미터로 넘어온 Permission을 암시하는지를 나타낸다.

지금까지 java.security.Permission 커스텀 클래스를 구현해 보았다. 해당 소스를 javac로 컴파일하고 JEUS 서버의 클래스 패스에 해당 클래스 경로를 설정한다.

마지막으로 Custom Permission 클래스를 policies.xml 파일에 설정한다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<policies xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <policy>
        <role-permissions>
            <role-permission>
                <principal>peter</principal>
                <role>administrator</role>
                <actions>9:00-17:00</actions>
                <classname>
                    jeus.security.resource.TimeConstrainedRolePermission
                </classname>
            </role-permission>
        </role-permissions>
        <resource-permissions>
            <context-id>default</context-id>
            <resource-permission>
                <role>administrator</role>
                <resource>jeus.*</resource>
                <actions>*</actions>
            </resource-permission>
        </resource-permissions>
    </policy>
    . . .
</policies>               

위의 XML은 다음을 나타내고 있다.

"peter"라는 사용자는 "administrator" Role을 오전 9시부터 오후 5시까지 업무시간 동안만 부여받는다. "administrator" Role은 모든 JEUS 리소스(jeus.*)에 대해 모든 액션(<actions>*</actions>)을 실행할 수 있는 권한을 가지고 있다. 따라서 peter는 업무시간 동안만 모든 JEUS 리소스에 대한 모든 권한을 행사할 수 있다.

위의 스키마는 J2EE 애플리케이션과 모듈에서 JEUS DD 파일을 설정할 때도 그대로 적용되고 예제에서 보여준 Principal-to-Role Permission에 적용되고, Role-to-Resource Permission에도 동일하게 적용된다. JEUS DD에서 Custom Permission을 사용하는 방법은 “제3장 애플리케이션과 모듈에서 보안 설정” 을 참고한다.

데이터베이스를 이용하여 Policy를 설정하려면 다음과 같이 JEUSMain.xml에서 도메인 서비스를 지정해야 한다. authentication과 마찬가지로 driver manager를 직접 이용할 경우 <datasource-export-name> 대신에 <dbdriver-config> 태그를 추가한다. 그러나 일반적으로 JEUS JDBC Datasource를 사용할 것을 권장한다.

<?xml version="1.0" encoding="UTF-8"?>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    ...
    <security-manager>
        <security-domains>
            <security-domain>
                <name>MY_DOMAIN</name>
                <authorization>
                    <repository-service>
                        <database-repository>
                            <datasource-export-name>auth</datasource-export-name>
                        </database-repository>
                    </repository-service>
                </authorization>
                . . .
        </security-domains>
    </security-manager>   
    . . .
</jeus-system> 

데이터베이스를 사용하는 AuthenticationRepositoryService를 사용하려면 데이터베이스에 접근하는 JDBC driver와 접근을 하기위한 정보인 URL, 사용자 이름 그리고 패스워드가 필요하다.

본 예제에서는 Oracle에 접근하기 위한 정보로 패스워드는 base64로 인코딩된 문자가 입력된다. 특정 암호화 알고리즘 혹은 인코딩 방식이 적용된 패스워드 값을 기입하는 경우 accounts.xml의 사용자 패스워드와 동일한 방식으로 기입하면 된다.

데이터베이스에서 사용되는 테이블은 다음과 같이 구성된다.

[그림 2.2] Policy를 저장하기 위한 데이터베이스 테이블 구조

데이터베이스에 테이블이 존재하지 않는다면 JEUS_HOME\config\security\dbrealm.sql 파일을 이용해서 DB에 테이블을 생성하여 기본적인 Policy는 “SYSTEM_DOMAIN”에 “administrator”라는 Role을 가지게 되고, “jeus.*”에 대한 Resource 권한을 가진다. “administrator” Role 포함된 principal은 “2.4.3. 데이터베이스를 이용한 사용자 설정”에서 설명한 jeus이다.

JEUS에서 Java SE SecurityManger를 사용하면, 플랫폼에 대한 부수적인 견고성을 얻을 수 있으나, 성능이 저하된다. 일반적으로 Java SE SecurityManger에서는 모든 핵심 JEUS 코드뿐 아니라 JEUS에 디플로이되어 있는 J2EE 애플리케이션 및 모듈이 완벽하게 신뢰받은 코드로 간주되므로, 굳이 보안 관리자를 사용하여 부하를 초래할 필요는 없다. 보안 관리자를 사용하지 않는 모드가 JEUS에서 디폴트 모드이다.

그러나 때때로 Java SE SecurityManger를 사용하여 코드 수준의 보안을 강화시켜 추가적인 견고성을 높이는 문제가 퍼포먼스 저하보다 중요하게 다루어지는 경우가 있다.

예를 들어 시스템 관리자가 미심쩍은 코드를 포함하고 있을 지도 모르는 Java EE 애플리케이션을 JEUS에 디플로이해야 한다고 하자. 이 경우에 퍼포먼스 저하라는 비용을 감수하고서라도 코드 레벨의 보안을 강화시켜, 호스트를 보호하는 것이 더 중요하다고 판단되면, Java SE SecurityManger를 작동시켜야 한다.

Java SE SecurityManger를 JEUS와 함께 동작시키기 위한 절차는 다음과 같다.

JEUS를 실행시키는 jeus.cmd나 JEUS 스크립트, 컨테이너에 command-option에 다음과 같은 속성을 정의해 줄 수 있다.

-Djava.security.manager 
-Djava.security.policy=%JEUS_HOME%\config\security\policy (Windows기준)            

Policy 파일은 JEUS_HOME\config\security\policy이며 내용은 다음과 같다.

grant codeBase "file:${jeus.home}/lib/system/*" {
    permission java.security.AllPermission;
};

grant {
    permission java.net.SocketPermission "127.0.0.1:1024-", 
    "connect, accept, connect, listen, resolve";
    permission java.security.SecurityPermission "runTrustedLogin", "read";
    permission java.security.SecurityPermission "loginCodeSubject", "read";
    permission java.security.SecurityPermission "putProviderProperty.*";
    permission java.security.SecurityPermission "insertProvider.*";
    permission javax.management.MBeanPermission "*", "*";
}; 

Java SE SecurityManger는 JEUS의 보안 시스템과는 완전히 별개의 것이다. JEUS 보안 시스템은 코드 수준의 보호(코드를 호출할 수 있는 Permission 설정)가 아니라 사용자 수준의 보호(누가 로그인했고, 해당 자원에 대한 Permission이 있는가)를 다루고 있다.

둘 사이 유일한 접점은 JEUS가 특별한 경우 Java SE SecurityManger를 사용하여 코드 수준의 Permission을 체크함으로써, 악의적인 Servlet이나 EJB 코드로부터 JEUS를 보호하기도 한다는 점이다.

JEUS에서 JACC 1.0 설정에 대한 이슈는 “제6장 JACC Provider 사용”에서 충분히 설명할 것이다. 더 자세한 내용은 해당 절을 참고한다.

클러스터로 묶여 있는 모든 보안 서버들은 서로 간의 신뢰를 확보하기 위해 공통의 전역 시스템 패스워드를 사용한다.

보안 서버는 크게 2가지 종류가 있는데, JEUS Manager의 VM에 설치되어 있는 보안 서버와 엔진 컨테이너 VM별로 설치되어 있는 보안 서버가 있다. 이들을 여러 노드의 보안 클러스터로 묶었을 경우 상호 간의 신뢰를 확보하기 위해 VM에 동일한 전역 시스템 패스워드를 설정해 주어야 한다.

시스템 패스워드는 클러스터로 묶여 있는 모든 JEUS VM에서 동일해야 하며, 다양한 목적으로 사용된다. JVM에서 시스템 패스워드를 설정하려면, 다음 Java 시스템 속성을 사용한다.

-Djeus.security.globalPassword=<password>

이 속성은 JEUS_HOME\bin 디렉터리 내의 JEUS 구동 스크립트(예를 들어 Window에서 jeus.cmd)와 JEUSMain.xml에 다음과 같이 설정한다.

. . .
 java -server . . .
-Djeus.security.globalPassword=syspass
jeus.server.JeusBootstrapper %*                   

<?xml version="1.0" encoding="UTF-8"?>
<jeus-system xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
    <node>
        <name>@HOSTNAME@</name>
        <engine-container>
            <name>container1</name>
            <!-- engine container JVM option -->
            <command-option>
             . . .
             –Djeus.security.globalPassword=syspass
           </command-option>
             <engine-command>
                 <type>servlet</type>
                 <name>engine1</name>
                 <startup-mode>xml</startup-mode>
              </engine-command>
          . . .                    

시스템 패스워드는 application client container와 같은 클라이언트 VM에는 설정하지 않는다. 전역 시스템 패스워드를 별도로 설정하지 않았다면, 디폴트로 "globalpass"가 패스워드로 사용된다.

Identity Assertion Service 지원하는 경우 추가적으로 인증서와 사용자 간의 매핑 정보가 있는 cert-user-map.xml 파일에서 읽어 들인다.

이 파일에는 최상위 태그 <cert-user> 하위에 <user> 및 <cert> 태그가 있으며 하위 0개 이상의 <cert-user> 태그가 포함되어 있다. 각각은 사용자에 대한 인증서 매핑을 위한 속성 정보를 나타내고 있다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<cert-user-map xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
   <cert-user>
     <username>choco</username>
     <cert>
        <subjectDN>chococa</subjectDN>
     </cert>               
   </cert-user>
</cert-user-map>  

이 파일은 다음의 경로에 위치한다.

JEUS_HOME\config\<node_name>\security\<domain_name>\cert-user-map.xml

<node_name>은 호스트 머신의 이름이고, <domain_name>은 사용자가 속한 보안 도메인의 이름을 나타낸다. cert-user-map.xml의 XML 스키마는 cert-user-map.xsd이며, JEUS_HOME\lib\schemas\jeus 경로에 있다.

JEUS 보안 시스템에서는 인증서로 인증된 Identity 사용자 정보에 대한 인증서 정보를 얻을 수 있는 API를 제공하는 UserCertMappingService를 제공한다. UserCertMappingService 지원하는 경우 추가적으로 사용자별 인증서 파일을 얻기 위한 매핑 정보가 있는 user-cert-map.xml 파일에서 읽어 들인다.

이 파일에는 최상위 태그 <user-cert-map> 태그 하위에 0개 이상의 <user-cert> 태그가 포함되어 있다. 각각은 keystore 파일에서 사용자에 대한 인증서를 얻기 위한 속성 정보를 나타내고 있다.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user-cert-map xmlns="http://www.tmaxsoft.com/xml/ns/jeus">
   <user-cert>
     <username>choco</username>
     <alias>chococa</alias>
     <keypassword>changeit</keypassword>
     <secretkey>
       <keyname>testkeypass</keyname>
       <keyalgorithm>AES</keyalgorithm>
       <keyvalue>bjhTUjJvSXRTOGlkVEdlNHJnM2N3VnljSDZXV0JkYz0=</keyvalue>
     </secretkey>
   </user-cert>
</user-cert-map>      

다음은 설정 태그에 대한 설명이다.

이 파일은 다음의 경로에 위치한다.

JEUS_HOME\config\<node_name>\security\<domain_name>\user-cert-map.xml

<node name>은 호스트 머신의 이름이고, <domain_name>은 사용자가 속한 보안 도메인의 이름을 나타낸다. user-cert-map.xml의 XML 스키마는 user-cert-map.xsd이며, JEUS_HOME\lib\schmas\jeus 경로에 있다.