第 3 章 配置詳細資訊

本章描述 Communications Express 的配置詳細資訊。

• Communications Express 配置檔案

• 配置參數詳細資訊

• 支援 Address Book 伺服器的水平可伸縮性

Communications Express 配置檔案

Communications Express 在下列配置檔案中維護配置參數：

• uwcauth.properties 檔案會維護與認證、使用者或群組存取和單次登入相關的參數。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 文字檔，每一行都以下列格式定義一個參數及其關聯值：

parameter =value

參數會在 Communications Express 配置時初始化。您可使用文字編輯器來編輯檔案。以下是在配置檔案中設定參數的一些慣例：

• 所有參數及其關聯值 (一或多個) 必須以等號 (=) 分隔。等號前後可以有空格或定位鍵。

  例如：

  uwc-user-attr-sunUCDefaultApplication=calendar

• 註釋行以驚嘆號 (!) 開始。

  依預設，部分配置參數已使用驚嘆號標記為註釋。若要使用這些參數，請移除驚嘆號並變更參數值。

1. 登入為擁有修改權限的使用者。

2. 變更為 .properties 檔案所在的目錄。

3. 使用文字編輯器編輯參數。

4. 重新啟動 Web 容器，使新的配置值生效。

配置參數詳細資訊

可以按照下列表格中的解釋，修改行事曆、郵件及通訊錄的配置參數。

• 在 uwcconfig.properties 檔案中配置 Messenger Express 參數

• 在 uwcauth.properties 檔案中配置 Sun Java LDAP Schema V.1 的目錄伺服器相關參數

• 在 uwcauth.properties 檔案中配置 Access Manager 參數

• 在 uwcauth.properties 檔案中配置使用者或群組的使用者查詢參數

• 在 uwcconfig.properties 檔案中配置 Calendar 伺服器參數

• 在 db_config.properties 檔案中配置通訊錄個人存放區參數

• 在 db_config.properties 檔案中配置公司目錄參數

• 配置安全傳輸層

在 uwcconfig.properties 檔案中配置 Messenger Express 參數

表 3–1 列出與 Messenger Express 相關的所有參數。

在 uwcauth.properties 檔案中配置 Sun Java LDAP Schema V.1 的目錄伺服器相關參數

當認證 LDAP 伺服器與使用者或群組 LDAP 不同時，您可編輯表 3–2 中所提及的參數。

在 uwcauth.properties 檔案中配置 Access Manager 參數

在 uwcauth.properties 檔案中配置使用者或群組的使用者查詢參數

在 uwcconfig.properties 檔案中配置 Calendar 伺服器參數

確定已在 Sun Java^TM System Calendar Server 中啟用了代理伺服器認證和匿名存取。

若要啟用代理伺服器認證和匿名存取，請在行事曆配置檔案 ics.config 中配置下列 Calendar 伺服器參數：

• service.http.allowadminproxy = "yes"

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

• service.http.allowanonymouslogin = " yes"

• service.calendarsearch.ldap = "no "

如需有關啟用代理伺服器認證的資訊和有關配置 Calendar 伺服器參數的說明，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

• 確定您指定給 calendar.wcap.adminid 的行事曆管理員使用者 ID 值與 Calendar 伺服器的 ics.conf 檔案中的 service.admin.calmaster.userid 值相同。

• 確定 LDAP 伺服器上，有行事曆管理員使用者 ID 對應的使用者項目。

在 db_config.properties 檔案中配置通訊錄個人存放區參數

表 3–7 列出 db_config.properties 檔案中的預設通訊錄個人存放區配置參數。

可從以下位置存取檔案：uwc-deployed-path/ WEB-INF/config/ldappstore/

在 db_config.properties 檔案中配置公司目錄參數

表 3–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 項目類型的物件類別。例如，在 Sun Java 目錄伺服器中，xlate-inetorgperson.xml 是用於識別連絡人的物件類別，而 groupofuniquemembers 是用於識別群組的物件類別。

xlate 檔案包含連絡人或群組的 LDAP 模式與通訊錄 XML 模式之間的欄位對映。對映以 XML 節點來定義。例如，

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

在此範例中：

• ab-xml-schema-field 是通訊錄在程式碼中使用的值。

• LDAPField 是 LDAP 中對應的欄位名稱。

您需要為 LDAPField 提供適當的欄位名稱。指定給 LDAPField 的值應該與公司目錄 LDAP 模式中現有的 LDAPField 值對應。

範例 3–1 是 xlate-inetorgperson.xml 檔案範例。

範例 3–1 xlate-inetorgperson.xml 的預設內容

<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>db:expr: db:iplanetbuildingnum+' '+db:iplanetbuildinglev+' '+db:roomNumber</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>

配置安全傳輸層

您可以將部署了 Communications Express 的 Web Server 或 Application Server 配置為 SSL 模式。

如需有關如何將部署了 Communications Express 的 Web Server 配置為 SSL 模式的資訊，請參閱「Sun Java System Web Server 7.0 Administrator’s Configuration File Reference」指南。

如需有關如何將部署了 Communications Express 的 Application Server 配置為 SSL 模式的資訊，請參閱「Sun Java Application Server Administration Guide」。

以 SSL 模式使用 Communications Express

1. 在 uwc-deployed-path /WEB-INF/config/uwcauth.properties 檔案中設定下列配置參數：

   • uwcauth.ssl.enabled=true。如果設定為 true，則整個認證程序及應用程式存取均以 SSL 模式執行。

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

   • webmail.ssl.port=SSL port for the Messaging Server

2. 根據已部署 Communications Express 的 Web Server 之 SSL 連接埠號，設定 local.webmail.sso.uwcsslport Messenger Express 參數值。

   此為指示 Messenger Server 取得 Communications Express 整合服務的必要參數。例如，如果設定了此參數，則 webmail 的逾時事件會將使用者帶至 Communications Express 的登入頁面。

   例如，local.webmail.sso.uwcsslport=已部署 communications express 之 Web 伺服器的 SSL 連接埠號

3. 設定 Messaging Server 的 webmail.ssl.port 參數。

   設定此參數為 Messaging Server 偵聽的 SSL 連接埠。

配置 Communications Express 為僅使用 SSL 認證

Communications Express 可以配置為僅使用 SSL 認證，這表示認證可透過 SSL 執行，但之後的應用程式存取則透過非 SSL 模式。

1. 在 uwcauth.properties 檔案中將 uwcauth.ssl.enabled 設定為 false。

2. 設定 uwcauth.https.port 為部署了 Communications Express 的 Web Server 之 SSL 連接埠號。

3. 將 uwcauth.ssl.authonly 設定為 true。

   ---

   備註 –

   uwcauth.properties 檔案中的 uwcauth.ssl.authonly 及 uwcauth.ssl.enabled 兩個參數互相排斥。

   ---

支援 Address Book 伺服器的水平可伸縮性

在舊版 Sun Java Communications Express 中，特定網域的個人通訊錄項目儲存在單一 LDAP 位置，該位置以 db_config.properties 檔案中定義的 defaultserver 實例表示。db_config.properties 檔案位於網域的 personalstore.properties 檔案指向的目錄中。例如，uwc-install/ WEB-INF/config/ldappstore。

此設定無法延展成在每個個人通訊錄中支援大量使用者與連絡人。為消除此限制，Communications Express 6.3 中的 psRoot 屬性可讓管理員佈建使用者，使得不同使用者的 PAB 資料可以分布在不同的 LDAP 位置上。

例如，ldap://mydir.com:389/piPStoreOwner=jsmith,o=siroe.com,o=PiServerDb

圖 3–1 提供了用來水平伸縮 Address Book 伺服器的架構之高層次概觀。

下列為「通訊錄」水平可伸縮性架構的關鍵元件：

• 個人存放區

• DB

• DBMap

「個人存放區」維護使用者的通訊錄資訊。它包含使用者以通訊錄中所有項目建立的所有通訊錄定義。「個人存放區」會以 URL 顯示，描述它們所在的目錄實例，以及特殊目錄實例中的 DN。

如圖 3–1 所示，DB (資料庫) 包含個人存放區的集合。通訊錄可存取任意數量的 DB。每個 DB 是由定義該 DB 連線參數的 DB-ID 定義。不同類型的 DB 會指向不同的 DB 位置。

DBMap 是相同類型 DB 的集合。每個 DBMap 有一個 ID，它會指引到該 DBMap 的配置資訊。

圖 3–1 通訊錄的水平可伸縮性

psRoot 是使用者的 LDAP 屬性，指定儲存使用者通訊錄項目的主機、目錄實例的連接埠和 DN。psRoot 的格式為：ldap://ldap_host:ldap_port/DN。

psRoot 屬性的值決定 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。

Address Book 伺服器未提供任何公用程式，以根據任何可伸縮性策略為使用者分配 psRoot 值。管理員需要設定最符合組織的特定策略，並使用自訂的程序檔為該策略設定 psRoot 值。

可使用網域特定的 personalstore.properties 檔案中的 db.UserPsRoot 參數開啟或關閉 psRoot 屬性。將參數設定為「false」，以使用 db_config.properties 檔案中的 defaultserver 參數。將參數設定為「true」，以使用使用者的 psRoot 值。必須為 psRoot 中使用的每個唯一目錄伺服器實例提供在 db_config.properties 檔案中配置通訊錄個人存放區參數列出的個人存放區參數。在執行階段中 psRoot 屬性值將被解析為使用 db-key.ldaphost 和 db-key.ldapport 的目錄實例，其中 db-key 是能夠區分不同實例的任意字串。如果無法找到與 db-key.ldaphost 和 db-key.ldapport 相符的實例，則將使用 defaultserver 實例。

支援水平可伸縮性所需的其他配置

使用者 LDAP 項目中的 psRoot 屬性是 Address Book 伺服器相容的 URL，定義儲存並擷取個人通訊錄項目的 LDAP 位置。psRoot 屬性可讓管理員佈建使用者，從而可以跨多目錄位置散佈所有使用者的 PAB 資料。

對於現有 Messenger Express 使用者，如果 PAB 遷移已啟用，將會使用現有 pabURI 屬性來建構 psRoot 屬性，且 uwc-deploy-dir/ WEB-INF/config/migrate.properties 中會定義對映表。

migrate.properties 檔案中的查詢表包括 pabhost 和 pabport 項目，其格式如下：

pabhost.pabport.abhostport = abldaphost:abldapport

其中 pabhost.pabport 指來源目錄實例，abldaphost 和 abldaport 指 PAB 資料應遷移到的目標目錄實例。

例如，如果您要將 PAB 資料從執行於 pab.example.com:389 的目錄遷移到執行於 abs.example.com:389 的通訊錄目錄，migrate.properties 中應有下列項目：

pab.example.com.389.abhostport = abs.example.com:389

您在 migrate.properties 檔案中可能會有所有必要的查詢。如果使用者的 pabURI 屬性使用 pabhost 和 pabport，則使用預設 psRoot 模式建構的 psRoot 將以如下格式顯示：

ldap://abldaphost: abldapport/piPStoreOwner=%U,o=%D,o=PiServerDb

如果並未定義 pabURI 值的查詢，亦即對映表中未提供與 pabURI 相符的項目，則 pabhost 和 pabport 值將用為 abldaphost 和 abport 的預設值。這表示如果缺少對映表，Messaging Server 的 PAB 項目會根據通訊錄模式遷移到相同目錄實例中的另一個根目錄。在這個案例中，目標目錄實例將與來源目標實例相同。

修補安裝程式並未定義查詢表。安裝修補程式之後，您需要定義查詢表，並重新啟動 Web Server。

確定該網域 personalstore.properties 指向的 db_config.properties 檔案中已定義 abldaphost: abldapport 目錄伺服器實例。

自動設定 psRoot 值

當新使用者登入時，會將使用者項目的 psRoot 屬性設定為預設值。

對於新使用者，psRoot 值是使用 personalstore.properties 檔案中定義的 psRoot 模式，以及 db_config.properties 檔案中的 defaultserverhost 和 defaultserverPort 值所建構。例如，使用預設 psRoot 模式時，預設 psRoot 值的格式如下：

ldap://default-server-host :default-server-port/piPStoreOwner=%U,o=%D,o=PiServerDb

其中：

%U = 使用者的登入識別碼。例如，jsmith。

%D = 使用者的網域。例如，siroe.com。

建立額外的遠端通訊錄

您可配置讓 Communications Express 增加一個以上的遠端通訊錄。例如，您可擁有一個以上的公司目錄，用於不同網域的使用者。

增加遠端通訊錄

對於遠端通訊錄，personalstore.properties 檔案中應存在相應的實例。personalstore.properties 檔案中的 db.xxx.urlmatch 值應指定為 defaultps.xml 檔案中的 bookremoteurl 屬性值。

若要增加新的遠端通訊錄，需要增加下列項目：

1. 在 defaultps.xml 檔案中增加一個新通訊錄節點。

   此檔案包含使用者首次登入時在 LDAP 存放區建立的個人和公司通訊錄預設定義。其中包含個人通訊錄和公司通訊錄的定義。以下為 defaultps.xml 中 XML 區段的範例，其中包含多個遠端通訊錄的定義：

   <book booktype="abook" bookremoteurl="ldap://corpdirectory/o=org1,o=isp";> <bookoc>piRemoteBook</bookoc> <entry entryID="corpdir1"> <displayname>_Corporate Directory 1</displayname> <description>This is Corporate Directory 1</description> </entry> </book> <book booktype="abook" bookremoteurl="ldap://corpdirectory/o=org2,o=isp";> <bookoc>piRemoteBook</bookoc> <entry entryID="corpdir2"> <displayname>_Corporate Directory 2</displayname> <description>This is Corporate Directory 2</description> </entry> </book>

2. 在 personalstore.properties 檔案中增加一個新實例。

   以下為配置兩個遠端通訊錄的 personalstore.properties 檔案中的項目範例：

   db.idir.class = com.iplanet.iabs.ldapplug.iLDAP db.idir.urlmatch = ldap://corpdirectory/o=org1,o=isp db.idir.configpath = ../config/corp-dir db.idir.wildcardsearch = 0 db.idir.randompaging = false db.idir.corporatedir = true db.idir2.class = com.iplanet.iabs.ldapplug.iLDAP db.idir2.urlmatch = ldap://corpdirectory/o=org2,o=isp db.idir2.configpath = ../config/corp-dir db.idir2.wildcardsearch = 0 db.idir2.randompaging = false db.idir2.corporatedir = true