4장 구성 세부 정보

이 장에서는 Communications Express에 대한 구성 세부 정보에 대해 설명합니다.

• Communications Express 구성 파일

• 구성 매개 변수 세부 정보

• AddressBook Server의 수평 확장성 지원

Communications Express 구성 파일

Communication Express는 구성 매개 변수를 다음 파일에서 관리합니다.

• uwcauth.properties 파일은 인증, 사용자/그룹 액세스 및 단일 사인 온(SSO) 관련 매개 변수를 관리합니다. uwcauth.properties 파일은 uwc-deployed-path /WEB-INF/config/에 있습니다.

• uwcconfig.properties 파일은 달력, 메일 및 주소록 관련 구성 매개 변수를 관리합니다. uwcconfig.properties 파일은 uwc-deployed-path /WEB-INF/config/에 있습니다.

• db_config.properties 파일은 주소록 저장소 구성 세부 정보를 정의하는 데 사용됩니다. 기본적으로 Communications Express는 두 가지 유형의 db_config.properties 파일을 배포합니다.

  • 개인 주소록 저장소. 개인 주소록 저장소 구성 파일은 uwc-deployed-path /WEB-INF/config/ldappstore/db_config.properties에 있습니다.

  • 회사 주소록 저장소. 회사 주소록 저장소 구성 파일은 uwc-deployed-path /WEB-INF/config/corp-dir/db_config.properties에 있습니다.

    모든 구성 파일은 ASCII 텍스트 파일로서 각 행에는 매개 변수 관련 값이 다음 형식으로 정의되어 있습니다.

    매개 변수 = 값

    매개 변수는 Communications Express를 구성할 때 초기화됩니다. 설치 후에는 텍스트 편집기를 사용하여 파일을 편집할 수 있습니다.

구성 파일을 편집하려면

단계

1. 수정 권한을 가진 사용자로 로그인합니다.

2. .properties 파일이 있는 디렉토리로 변경합니다.

3. 텍스트 편집기를 사용하여 매개 변수를 편집합니다.

   매개 변수의 활자체 규약은 다음과 같습니다.

   • 모든 매개 변수와 관련 값은 등호 기호(=)를 사용하여 구분해야 합니다. 등호 기호의 전과 후에 공백 또는 탭을 사용할 수 있습니다.

     예를 들면 다음과 같습니다.

     uwc-user-attr-sunUCDefaultApplication=calendar

     • 주석 행은 느낌표(!)로 시작합니다.

       일부 구성 매개 변수는 기본적으로 느낌표를 사용하여 주석으로 처리해 둡니다. 이러한 매개 변수를 사용하려면 느낌표를 제거하고 필요한 경우 값을 변경해야 합니다.

4. Web Server 또는 App Server를 다시 시작하여 새 구성 값을 적용합니다.

구성 매개 변수 세부 정보

다음 표에서 설명한 대로 달력, 메일 및 주소록 구성 매개 변수를 수정할 수 있습니다.

• uwcconfig.properties 파일에서 Messenger Express 매개 변수 구성

  • uwcauth.properties 파일에서 Sun Java System LDAP Schema v.1에 대해 Directory Server 관련 매개 변수 구성

  • uwcauth.properties 파일에서 Access Manager 매개 변수 구성

  • uwcauth.properties 파일에서 사용자/그룹에 대해 사용자 조회 매개 변수 구성

  • uwcconfig.properties 파일에서 Calendar Server 매개 변수 구성

  • db_config.properties 파일에서 주소록 개인 저장소 매개 변수 구성

  • db_config.properties 파일에서 회사 디렉토리 매개 변수 구성

  • AddressBook Server의 수평 확장성 지원

  • SSL(Secure Socket Layer) 구성

    메일, 달력 및 주소록 구성 매개 변수에 대한 자세한 내용은 2 장, Communications Express 개요을 참조하십시오.

uwcconfig.properties 파일에서 Messenger Express 매개 변수 구성

uwcauth.properties 파일에서 Sun Java System LDAP Schema v.1에 대해 Directory Server 관련 매개 변수 구성

인증 LDAP 서버가 사용자/그룹 LDAP와 다를 때는 표 4-2에 언급된 매개 변수를 편집할 수 있습니다.

uwcauth.properties 파일에서 Access Manager 매개 변수 구성

uwcauth.identity.enabled 값이 “true”로 설정되면 uwcauth.identity.naming.url, uwcauth.identity.binddn, uwcauth.identity.bindcred를 반드시 구성해야 합니다.

uwcauth.properties 파일에서 사용자/그룹에 대해 사용자 조회 매개 변수 구성

uwcconfig.properties 파일에서 Calendar Server 매개 변수 구성

Sun Java™ System Calendar Server에서 프록시 인증 및 익명 액세스를 사용할 수 있는지 확인합니다.

프록시 인증 및 익명 액세스를 사용하려면 달력 구성 파일인 ics.config에서 다음 Calendar Server 매개 변수를 구성합니다.

• service.http.allowadminproxy = ”yes”

• service.http.admins = includes-the-value-specified-for- calendar.wcap.adminid-in-uwcconfig.properties.

• service.admin.calmaster.userid = the-value-specified-for- calendar.wcap.adminid-in-uwcconfig.properties

• service.admin.calmaster.cred = the-value-specified-for- calendar.wcap.passwd-in-uwcconfig.properties

• service.wcap.anonymous.allowpubliccalendarwrite = "yes"

• service.http.allowanonymouslogin = "yes"

• service.calendarsearch.ldap = "no"

프록시 인증 사용 및 Calendar Server 매개 변수 구성에 대한 지침은 Sun Java System Calendar Server 관리 설명서를 참조하십시오.

• calendar.wcap.adminid로 지정했던 달력 관리자 아이디 값은 Calendar Server의 ics.conf 파일에 언급된 service.admin.calmaster.userid 값과 같아야 합니다.

• 달력 관리자 아이디에 해당하는 사용자 항목이 LDAP Server에 있어야 합니다.

db_config.properties 파일에서 주소록 개인 저장소 매개 변수 구성

표 4-7에서는 db_config.properties 파일의 기본 주소록 개인 저장소 구성 매개 변수를 나열합니다.

이 파일은 다음 경로로 액세스할 수 있습니다.

uwc-deployed-path/WEB-INF/config/ldappstore/

db_config.properties 파일에서 회사 디렉토리 매개 변수 구성

표 4-8에서는 db_config.properties 파일의 기본 회사 디렉토리 매개 변수를 나열합니다. 기본적으로 모든 LDAP 관련 정보는 사용자/그룹 디렉토리에 언급된 값에 따라 설정됩니다.

db_config.properties 파일은 다음 경로로 액세스할 수 있습니다.

WEB-INF/config/corp-dir/

회사 디렉토리는 두 개의 xlate 파일을 xlate-objectclass-name.xml 형식으로 유지 관리합니다.

• xlate-inetorgperson.xml - 연락처

• xlate-groupofuniquemembers.xml - 그룹

xlate-objectclass-name .xml에서 objectclass-name은 특정 LDAP 항목 유형을 식별하는 객체 클래스를 나타냅니다. 예를 들어, xlate-inetorgperson.xml은 연락처를 식별하는 데 사용되고 groupofuniquemembers는 Sun Java System Directory Server에서 그룹을 식별하는 데 사용되는 객체 클래스입니다.

xlate 파일에는 LDAP 스키마와 주소록 XML 스키마 간의 연락처 또는 그룹을 위한 필드 매핑이 포함되어 있습니다. 이 매핑은 XML 노드 면에서 정의됩니다. 예를 들면 다음과 같습니다.

ab-xml-schema-keydb:LDAPField /ab-xml-schema-key

여기서,

ab-xml-schema-field는 값이고 주소록은 코드로 사용됩니다.

LDAPField는 LDAP의 해당 필드 이름입니다.

LDAPField에 해당 필드 이름을 제공해야 합니다. LDAPField에 지정된 값은 회사 디렉토리 LDAP 스키마에 있는 LDAPField 값과 일치해야 합니다.

코드 예 4-1은 xlate-inetorgperson.xml 파일의 예입니다.

예 4–1 xlate-introgperson의 기본 내용

<abperson uid="db:uid"\>
 <entry entryID="db:uid"\>
   <displayname\>db:cn</displayname\>
   <description\>db:multilineDescription</description\>
   <creationdate\>db:createtimestamp</creationdate\>
   <lastmodifieddate\>db:modifytimestamp</lastmodifieddate\>
 </entry\>
 <person\>
   <givenname\>db:givenname</givenname\>
   <surname\>db:sn</surname\>
 </person\>
 <organization\>
   <company\>db:company</company\>
   <organizationalunit\>db:ou</organizationalunit\>
   <location\>
     <building\>db:buildingnum</building\>
     <floor\>db:iplanetbuildinglev</floor\>
     <office\>db:roomNumber</office\>
   </location\>
   <title\>db:title</title\>
   <manager\>db:manager</manager\>
   <secretary\>db:secretary</secretary\>
 </organization\>
<phone priority="1" type="work"\>db:telephoneNumber</phone\>
<phone priority="2" type="fax"\>db:facsimileTelephoneNumber</phone\>
 <phone priority="3" type="mobile"\>db:mobile</phone\>
 <phone priority="4" type="home"\>db:homePhone</phone\>
 <phone priority="5" type="pager"\>db:pager</phone\>
 <email priority="1" type="work"\>db:mail</email\>
 <im priority="1" service="SunONE"\>db:uid</im\>
 <im priority="2" service="AIM"\>db:aimscreenname</im\>
 <im priority="3" service="ICQ"\>db:icqnumber</im\>
 <postaladdress type="home"\>
   <street\>db:homePostalAddress</street\>
 </postaladdress\>
 <postaladdress type="work"\>
   <street\>db:postaladdress</street\>
 </postaladdress\>
 <weburl priority="1"\>
   <urladdr\>db:labeleduri</urladdr\>
   <description\>URL</description\>
 </weburl\>
 <weburl priority="2"\>
   <urladdr\>db:homepage</urladdr\>
   <description\>Home URL</description\>
 </weburl\>
 <calendar type="calendar"\>
   <urladdr\>db:caluri</urladdr\>
 </calendar\>
</abperson\>

SSL(Secure Socket Layer) 구성

Communications Express가 SSL 모드로 배포된 Web Server를 구성할 수 있습니다. Communications Express가 SSL 모드로 배포된 Web Server를 구성하는 방법에 대한 자세한 내용은 Sun ONE Web Server Administrator’s Configuration File Reference를 참조하십시오.

Communications Express를 SSL 모드로 사용하려면

단계

1. uwc-deployed-path/WEB-INF/config/uwcauth.properties에서 다음 구성 매개 변수를 편집합니다.

   • uwcauth.ssl.enabled=true

     • uwcauth.https.port=SSL-port-number-of -the webserver-in which-uwc-is-deployed

       또한 Communications Express는 SSL에 대해 인증 전용으로 구성될 수 있습니다. 이는 SSL을 통해 인증을 수행할 수 있지만 그 이후의 응용 프로그램 액세스는 비 SSL 모드를 통해 이루어진다는 것을 의미합니다.

2. local.webmail.sso.uwcport Messenger Express 매개 변수 값을 Communications Express가 배포된 Web Server의 SSL 포트 번호로 설정해야 합니다.

   예를 들면 다음과 같습니다.

   local.webmail.sso.uwcport=SSL port-number of the webserver in which communications express is deployed

Communications Express를 SSL에 대해 인증 전용으로 구성하려면

단계

1. uwcauth.properties 파일에서 uwcauth.ssl.enabled를 “false”로 설정합니다.

2. uwcauth.https.port를 Communications Express가 배포된 Web Server의 SSL 포트 번호로 설정합니다.

3. uwcauth.ssl.authonly를 “true”로 설정합니다.

   ---

   주 –

   uwcauth.ssl.authonly와 uwcauth.ssl.enabled 두 매개 변수는 상호 배타적인 매개 변수입니다.

   메시징 SSO는 SSL에서 지원되지 않습니다.

   ---

AddressBook Server의 수평 확장성 지원

이전 버전의 Sun Java System Communications Express에서는 특정 도메인의 개인 주소록 항목이 db_config.properties 파일에 정의된 defaultserver 인스턴스에 표시된 단일 LDAP 위치에 저장되었습니다. db_config.properties 파일은 도메인의 personalstore.properties에 지정된 디렉토리에 있습니다. 예를 들면, uwc-install/WEB-INF/config/ldappstore와 같은 위치입니다.

이 배포는 주소록별로 많은 수의 사용자와 연락처를 지원하도록 확장할 수 없었습니다. 이러한 제한을 해결하기 위해 Sun Java System Communications Express 6.2의 psRoot 속성에서는 다른 사용자의 PAB 데이터를 다른 LDAP 위치로 분산시킬 수 있도록 관리자 관리 사용자를 활성화합니다.

예를 들면 다음과 같습니다. ldap://mydir.com:389/piPStoreOwner=jsmith,o=siroe.com,o=PiServerDb

그림 4-1에서는 AddressBook Server를 수평으로 확장하는 데 사용되는 구조에 대한 상위 수준 개요를 제공합니다.

주소록 수평 확장성 구조의 주요 구성 요소는 다음과 같습니다.

• 개인 저장소

• DB

• DBMap

개인 저장소에는 사용자의 주소록 정보를 저장합니다. 또한, 사용자가 만든 모든 주소록의 정의와 해당 주소록의 모든 항목이 포함되어 있습니다. 개인 주소록은 URL로 표시되며 그 URL은 개인 주소록이 위치한 디렉토리의 인스턴스와 해당 디렉토리 인스턴스에 있는 DN을 설명합니다.

DB에는 개인 저장소 모음이 포함되어 있으며 그림 4-1에 표시된 것처럼 모든 DB를 Address Book Server에서 액세스할 수 있습니다. 모든 DB는 해당 DB의 연결 매개 변수를 정의하는 DB 아이디로 정의됩니다. DB는 여러 유형을 가질 수 있으며 다른 DB 위치를 가리킬 수 있습니다.

DBMap은 유형이 동일한 DB의 모음입니다. 각 DBMap에는 해당 DBMap에 대한 구성 정보를 참조하는 아이디가 있습니다.

그림 4–1 주소록의 수평 확장성

psRoot는 사용자의 LDAP에서 사용자의 주소록 항목이 저장되는 호스트, 디렉토리 인스턴스 포트 및 DN을 지정하는 속성입니다. psRoot는ldap://ldap_host:ldap_port/DN 형식으로 사용됩니다.

psRoot 속성 값에 따라 DB 유형과 DB 위치가 결정됩니다.

psRoot 예는 다음과 같습니다. ldap://mydir.com:389/piPStoreOwner=jsmith,o=siroe.com,o=PiServerDb

ldap://는 사용자의 주소록 개인 저장소가 LDAP DB 플러그 인을 사용하여 액세스됨을 나타냅니다.

mydir.com:389는 LDAP 호스트와 포트를 지정합니다.

piPStoreOwner=jsmith,o=siroe.com,o=PiServerDb는 개인 저장소의 DN을 지정합니다.

AddressBook Server는 확장성 정책별로 사용자의 psRoot 값 배포를 위한 유틸리티를 제공하지 않습니다. 따라서, 관리자는 조직에 가장 알맞은 특정 정책을 설정하고 사용자 정의 스크립트를 사용하여 해당 정책에 대한 psRoot 값을 설정해야 합니다.

psRoot 속성은 도메인별 personalstore.properties 파일에 있는 db.UserPsRoot 매개 변수를 사용하여 설정하거나 해제할 수 있습니다. db_config.properties 파일의 defaultserver 매개 변수를 사용하려면 이 매개 변수를 “false”로 설정합니다. 사용자의 psRoot 값을 사용하려면 이 매개 변수를 “true”로 설정합니다. db_config.properties 파일에서 주소록 개인 저장소 매개 변수 구성에 나열된 개인 저장소 매개 변수를 psRoot에 사용된 각 Directory Server 인스턴스에 제공해야 합니다. 런타임에서 db-key.ldaphost 및 db-key.ldapport를 사용하여 디렉토리 인스턴스에 대한 psRoot 속성 값을 확인합니다. 여기서 db-key는 인스턴스를 다른 인스턴스와 구별하는 임의의 문자열입니다. db-key.ldaphost 및 db-key.ldapport와 일치하는 인스턴스가 없는 경우 defaultserver 인스턴스가 사용됩니다.

자동으로 psRoot 값 설정

새 사용자가 로그인하면 사용자 항목의 psRoot 속성에 대한 기본값이 설정됩니다.

새 사용자에 대한 psRoot 값은 personalstore.properties 파일에 정의된 psRoot 패턴과 db_config.properties 파일에 있는 defaultserverhost 및 defaultserverPort 값을 사용하여 구성됩니다. 예를 들어, 기본 psRoot 패턴을 사용하는 기본 psRoot 값은 다음과 같은 형식입니다.

ldap://defaultserver_host :defaultserver_port/piPStoreOwner=%U,o=%D,o=PiServerDb

여기서,

%U = 사용자의 로그인 아이디(예: jsmith)

%D = 사용자의 도메인(예: siroe.com)