Sun Java logo     上一頁      目錄      索引      下一頁     

Sun logo
Sun Java System Portal Server 6 2004Q2 管理員指南 

第 14 章
配置通訊通道

本章針對 Sun™ Java System Portal Server 6 2004Q2 通訊通道提供循序漸進的介紹，首先是一般性的描述，接著提出通訊通道在安裝之後、配置之前的狀態說明，最後說明依據站台需求進行通訊通道配置的各種實際操作步驟。

本章篇幅著重探討配置方面的資訊，包括管理員及一般使用者的配置工作。一般使用者只要在各通道中按一下可存取的編輯按鈕，即可從 Portal Desktop 直接編輯各通道的配置。如此會讓一般使用者存取編輯頁面 (一頁或多頁)，以便編輯特定伺服器配置資訊，以及通道中開放一般使用者查看的特定功能，例如在通訊錄通道中可見的多筆通訊錄項目。

管理員可限制或擴增一般使用者的編輯選項。管理員甚至可以透過預先配置讓通道無需經過一般使用者伺服器配置即可運作；如需更多資訊，請參閱管理員代理伺服器驗證：結束一般使用者憑證配置。

由於管理員能夠自行設計各通道的編輯頁面，因此有權選擇一般使用者能夠使用的特定功能；如需更多資訊，請參閱應用程式喜好設定編輯：配置通訊通道編輯頁面。

此外，假如某站台具有一個以上的特定應用程式執行實例可供使用，例如具有兩個或以上的郵件應用程式執行實例時，管理員可開放讓一般使用者在其 Portal Desktop 上配置第二個郵件通道；如需更多資訊，請參閱允許一般使用者設定通訊通道類型的多重實例。

本章包含以下各節：

通訊通道簡介

Sun Java System Portal Server 6 2004Q2 產品提供四個通訊通道，可供一般使用者透過 Portal Desktop 直接存取。這些通道能讓一般使用者存取相對應的應用程式 (如郵件應用程式)，裨便一般使用者更有效進行管理、排程及通訊。

這四個通訊通道分別是：

通訊錄通道    

通訊錄通道在於顯示通訊錄項目供一般使用者檢視。要存取通訊錄以建立、編輯通訊錄項目時，請先按一下 [啟動通訊錄]。

行事曆通道     行事曆通道會顯示行事曆事件與作業供一般使用者檢視。要存取行事曆應用程式以建立新的作業及事件，請先按一下 [啟動行事曆]。

Instant Messaging 通道    

Instant Messaging 通道會顯示其他能夠存取 Sun™ Java System Instant Messenger 的使用者之上線狀態。這些聯絡人來自於一般使用者在 Instant Messenger 應用程式中建立的聯絡人清單。按一下上線狀態圖示，在通道中開闢聊天室，也是啟動 Instant Messenger 的方法之一。如要直接從通道中得知上線更新狀態，需重新載入「Portal Desktop」。如要在其他使用者上線時得知更新狀態，需啟動應用程式以檢視聯絡人的上線狀態，此時請按一下 Instant Messenger。

郵件通道     郵件通道在於顯示已傳至一般使用者供其讀取的郵件訊息。要存取郵件應用程式以閱讀和撰寫訊息，按一下 [啟動郵件]。

通訊通道支援軟體

Sun Java System Portal Server 軟體支援下列通訊通道用的資源伺服器平台：

安裝程式與通訊通道

Sun Java System Portal Server 安裝程式會執行數項與通訊通道相關的作業。此外安裝程式也處理一般性的通訊通道配置作業。至於更細部的配置，則由管理員及一般使用者視站台及個人需要自行設定。

Sun Java System Portal Server 安裝程式作業

Sun Java System Portal Server 安裝程式負責：

多重實例部署

如要進行多重 Sun Java System Portal Server 部署，需將通訊通道手動部署到 Sun Java System Portal Server 的各個附加執行實例，然後逐一重新啟動執行實例。若要進行部署，請鍵入：

portal-server-install-dir/SUNWps/bin/deploy redeploy -instance instancename -deploy_admin_password deployadminpassword

其中，instancename 是非預設的特定實例名稱，而 deployadminpassword 是 web 容器 (web 伺服器或應用程式伺服器) 的管理員密碼。當 web 容器為 Sun™ Java System Application Server 或 BEA WebLogic Server™ 時，才會用到 web 容器管理員密碼。不過您若在使用另外一個可接受的 web 容器時加入密碼，也不至於造成問題。Sun™ Java System 然而使用 Web Server 或 IBM WebSphere® Application Server 時，密碼會被忽略。

程式碼範例 14-1 列舉將通訊通道手動部署至兩個非預設的 Sun Java System Portal Server 實例並重新開機時使用的指令，其中 myinstance1 和 myinstance2 為非預設的 Sun Java System Portal Server 實例名稱，而 Admin 是 web 容器管理員密碼。

程式碼範例 14-1  將通訊通道部署至非預設的實例

portal-server-install-dir/SUNWps/bin/deploy redeploy -instance myinstance1     -deploy_admin_password Admin

portal-server-install-dir/SUNWps/bin/deploy redeploy -instance myinstance2     -deploy_admin_password Admin

portal-server-install-dir/SUNWam/bin/amserver stopall

portal-server-install-dir/SUNWam/bin/amserver startall

通訊通道配置作業

以下說明有關設定通訊通道的高階作業。並非每項作業均適用於所有網站。您應當根據網站的業務需求，判定網站所需執行的作業。

如果您已在相同或不同伺服器上安裝 Sun Java System Messaging Server 與 Sun Java System Calendar Server，請在建立通道時指定各自的 URL。

配置服務供預設組織使用

通訊通道安裝完成後，需進一步對 Instant Messaging 及通訊錄通道進行後述的細部配置。至於行事曆及郵件通道則具有範例或預設的設定，無需管理員做進一步的配置即可運作。任何通訊通道 (包括行事曆及郵件通道) 中都可能會發生網站特定的問題，需要管理員在通道開始運作前特別注意，或根據網站需求予以適當配置。

以下各節提供有關通訊通道配置的重要資訊。

通訊通道配置資訊

配置 Instant Messaging 通道

配置通訊錄通道

通訊通道配置資訊

涉及所有通訊通道
一般使用者配置

除非您採用代理伺服器認證進行通訊通道配置 (如需更多資訊，請參閱管理員代理伺服器驗證：結束一般使用者憑證配置)，否則使用者仍需按一下個別通訊通道中的編輯按鈕，進入各個通道的編輯頁面做進一步的通道配置。

注意未察覺錯誤：遺失啟動按鈕

如有任何通訊通道的用戶端連接埠號輸入不正確，一般使用者將無法收到錯誤訊息。但是當各個通道不顯示啟動按鈕時則表示有錯誤發生，這對一般使用者釐清問題的根本原因將沒有任何幫助。管理員及一般使用者都有可能輸入不正確的用戶端連接埠號，不過由於一般使用者僅能編輯行事曆及郵件通道的用戶端連接埠號，因此只有這兩種通道才會發生這個問題。

注意未察覺錯誤：缺少通道

各種情況都可能造成一般使用者未能看見通訊通道，也未能看見說明此問題的錯誤訊息。可能造成這種情況的原因是範本或配置名稱的配置不正確，因而使得使用者沒有辦法看見範本或配置。當下列任何情況為 true 時，將不會顯示通訊通道：

涉及郵件通道
HTTPS 啟用型 Messaging Server

當郵件通道連接安全性較高的 HTTPS 啟用型傳訊伺服器，而非基本 HTTP 啟用型傳訊伺服器時，為使郵件通道依預期方式運作，您需要做一些安全方面的調整。如需詳細資訊，請參閱「配置郵件提供者使其配合啟用 HTTPS 的 Messaging Server 運作」。

配置 Instant Messaging 通道

Sun Java System 如在安裝 Sun Java System Instant Messaging Server 過程中選取了 Portal Server 選項中的「啟用 IM」，則 Instant Messaging Server 會在安裝 Sun Java System Portal Server 過程中一併安裝。

儘管 Instant Messaging Portal 通道具備隨裝即用的特色，但依據實際的網站需求，仍有可能需要進行其他配置。因此，當您完成 Instant Messaging 通道配置步驟中的步驟後，請參閱 Instant Messaging 通道附加配置,，以判定該節中是否有任何小節內容符合您的安裝情形。

Instant Messaging 通道是由一位 Portal Server 內容提供者所建，名為 IMProvider。IMProvider 在 Portal Server 中屬於 JSPProvider 的延伸。作為 JSPProvider 的延伸，IMProvider 將使用 JSP 檔案來產生 Instant Messaging 通道的內容頁面和編輯頁面。JSP 檔案亦可用來產生啟動 Instant Messenger 的頁面。IMProvider 也用來定義一項 JSP 檔案專用的即時傳訊標記程式庫。JSP 檔案及標記程式庫使用 IMProvider 所定義的通道特性。

如需 Sun Java System Instant Messaging Server 的詳細資訊，請參閱「Instant Messaging 管理員指南」。如需 Sun Java System Portal Server Instant Messaging 通道標記程式庫的特定資訊，以及藉由編輯 JSP 檔案來自訂 Instant Messaging 通道的方法，請參閱「Sun Java System Portal Server 6 2004Q2 Desktop Customization Guide」。此外，管理員及一般使用者可造訪 Instant Messaging 通道配置程式碼屬性中使用的 URL，存取有關 Sun Java System Instant Messaging Server 的資訊。

Instant Messaging 通道配置步驟
  1. 透過網際網路瀏覽器登入 Sun™ Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [識別管理] 標籤，使導覽窗格中顯示 [檢視] 下拉清單 (左下框架)。
  3. 在 [檢視] 下拉清單中選取 [服務]，顯示可配置的服務清單。
  4. 在 Portal Server 配置標題下，按一下 Portal 桌面旁的箭頭，資料窗格中即出現 [Portal 桌面] 頁面 (右下框架)。
  5. 按一下 [通道與容器管理] 連結。
  6. 向下捲動到 [通道] 標題，按一下 IMChannel 旁的 [編輯特性] 以顯示包含「基本特性」的 Instant Messaging 服務面板。

    7. 以下是 [編輯 IMChannel] 頁面中顯示的部分特性清單，其中附帶各項屬性的範例值。

    特性

    值

    Server

    imserver.example.com

    port

    49999

    mux

    imserver.example.com

    muxport

    49909

    codebase

    imapplet.example.com

     

     

    netletRule

    IM

    clientRunMode

    plugin

    authMethod

    idsvr

    authUsernameAttr

    uid

    username

    (當 authmethod 使用 idsvr 時不適用)

    password

    (當 authmethod 使用 idsvr 時不適用)

    contactGroup

    My Contacts

  7. 在您要輸入的各項屬性旁之文字欄位中，輸入所要設定的值。表 14-1 說明可設定的屬性值及其資訊類型。

    8. 表 14-1  編輯 IMChannel 頁面之屬性及屬性值說明

    特性

    值

    Server

    輸入供通道使用的 Sun Java System Instant Messaging Server 主機名稱。

    port

    輸入供通道使用的 Sun Java System Instant Messaging Server 連接埠號。預設連接埠號為 49999。

    mux

    輸入 Sun Java System Instant Messaging 多重訊號組合器的主機名稱；該多重訊號組合器是在通道啟動 Instant Messaging 用戶端時使用。

    muxport

    輸入 Sun Java System Instant Messaging 多重訊號組合器的連接埠號。預設連接埠號為 49909。

    codebase

    輸入用來下載 Instant Messaging 用戶端的 URL 前綴。

     

     

    netletRule

    輸入 Netlet 規則名稱，其係透過 Secure Remote Access (SRA) 閘道、在安全模式下使用於 Instant Messaging 用戶端。

    clientRunMode

    輸入 Instant Messaging 用戶端的執行方法： plugin 或 jnlp (用於 Java Web Start)。

    authMethod

    通常較為偏好輸入 idsvr 作為屬性值，表示認證方法採用的是 Sun Java System Identity Server 認證法。

    以下兩者為可能值：idsvr 或 ldap。idsvr 值可以讓單次登入運作。它也會移除 Instant Messaging 通道編輯頁中的 username 和 password 欄位。

    authUsernameAttr

    輸入使用 idsvr 認證方法時用於使用者名稱的屬性名稱。

    username

    輸入使用 LDAP 認證方法時所用的使用者名稱。

    password

    輸入使用 LDAP 認證方法時所用的密碼。儲存於顯示設定檔時，此屬性會以 AMPasswordUtil 類別混淆。

    contactGroup

    輸入 Instant Messaging 通道中顯示的聯絡群組名稱。

  8. 視需要捲動畫面，按一下 [儲存]。
Instant Messaging 通道附加配置
多重組織運用時可能需執行的步驟

當 Portal Server 實例使用單一 Instant Messaging 伺服器來服務多個組織時，必須執行額外步驟。

Identity Server 及 Portal Server 允許管理員以相同的使用者 ID (uid) 設定組織內部的使用者。例如，組織中可能有兩個子組織，其中各自設有名為 enduser22 的一般使用者。當這兩位一般使用者嘗試透過 Instant Messaging 通道存取其各自的帳戶時，將會發生衝突。

若要避免潛在的衝突問題，需針對每一個組織建立一組 JSP 啟動頁面，其中含有設定為組織的屬性值 sunPreferredDomain 之參數互傳網域。預設的啟動頁面有：

/etc/opt/SUNWps/desktop/default/IMProvider/jnlpLaunch.jsp

/etc/opt/SUNWps/desktop/default/IMProvider/pluginLaunch.jsp

在組織中插入 Instant Messenger 連結

依預設，Instant Messenger 連結會新增至預設組織中的應用程式通道－該通道會提供啟動不同的應用程式之連結。Instant Messenger 連結可讓使用者從應用程式通道啟動 Instant Messenger。如遇下列情形，您需手動加入 Instant Messenger 連結：

Instant Messenger 連結的內容位於 portal-server-install-dir/SUNWps/samples/InstantMessaging/dp-IMChannel.xml 檔案中。dp-IMChannel.xml 檔案亦含有範例 IMChannel。

編輯 dp-IMChannel.xml 檔的複本，以便將 Instant Messenger 連結資訊加入另一組織的顯示設定檔，並使用 dpadmin 指令安裝該檔，方法如下：

  1. 變更以下目錄：
  1. 建立 dp-IMChannel.xml 檔案副本，方法如下：
  1. 如要修改應用程式通道，鍵入下列 dpadmin 指令：

    dpadmin modify -u ADMIN_DN -w PASSPHRASE -d ORG_DN -m newfile.xml

其中，

在 Sun Java Server Portal Server 中啟用 Sun Java System Instant Messenger 的安全模式

Netlet 可促進 Instant Messenger 與伺服器之間的通訊安全。

備註   

每當透過 Secure Remote Access 閘道進行存取時，Instant Messaging 通道會自動使用安全模式。如非透過該閘道進行存取，Instant Messaging 通道則不會使用安全模式。

要啟用安全模式，需加入 Netlet 規則。

加入 Netlet 規則的步驟如下：

  1. 透過網際網路瀏覽器，登入 Identity Server 管理主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
  3. 在 [檢視] 下拉清單中選取 [服務]，顯示可配置的服務清單。
  4. 向下捲動至 SRA 配置然後選取 Netlet。
  5. 按一下 Netlet 旁的箭頭圖示。Netlet Rules 即顯示於右窗格中。
  6. 按一下 [Netlet 規則]下方的 [新增]。
  7. 在 [規則名稱] 欄位中鍵入 IM。

    8. 備註

    Netlet 規則名稱可以變更。您可以通過配置讓 Instant Messaging 通道使用不同的 Netlet 規則。

  8. 移除 URL 欄位中的預設值，使該欄位空白。
  9. 勾選 [下載 Applet] 核取方塊並輸入下列字串：

    10. $IM_DOWNLOAD_PORT:$IM_HOST:$IM_PORT

    例如：

    49916:company22.example.com:80

    其中，

    IM_DOWNLOAD_PORT。Instant Messaging 連接埠，用來接收使用 Netlet 下載的資源。

    IM_HOST。執行 Instant Messenger 的 Web 容器主機名稱。例如： company22.example.com

    IM_PORT。執行 Instant Messenger 的 Web 容器之連接埠號。例如 80。

  10. 選取 [連接埠-主機-連接埠] 清單中的預設值後，按一下 [移除]。
  11. 在 [用戶端連接埠] 欄位中輸入將要執行 Netlet 的本端主機連接埠。例如： 49916.
  12. 在 [目標主機] 欄位中輸入 Instant Messenger 多重訊號組合器主機名稱。
  13. 在 [目標連接埠] 欄位中輸入 Instant Messenger 多重訊號組合器連接埠。

    14. 備註     

    Netlet 連接埠、Instant Messaging 主機以及 Instant Messaging 連接埠的值，應與 Instant Messaging 服務面板中提及的 Instant Messaging 服務屬性一致，這些內容在 Instant Messaging 通道配置步驟的最後步驟中會有討論。

  14. 按一下 [加入清單]。
  15. 按一下 [儲存] 以儲存 Netlet 規則。
禁止使用者啟動 Instant Messenger

您可以拒絕讓使用者使用 Instant Messaging 通道，只要將該通道從使用者的顯示設定檔中移除即可。例如，要移除自動安裝的範例 IMChannel，請執行下列步驟：

  1. 透過網際網路瀏覽器，登入 Identity Server 管理主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
  3. 在 [檢視] 下拉清單中選取 [服務]，顯示可配置的服務清單。
  4. 按一下 [Portal Desktop 服務] 旁的箭頭圖示。
  5. 按一下 [容器] 與 [通道管理] 連結。
  6. 勾選 IMChannel 通道左側的核取方塊。
  7. 視需要捲動畫面並按一下 [刪除]，即可刪除通道。

配置通訊錄通道

為使通訊錄通道能夠運作，您需配置通訊錄服務的預設值。

配置通訊錄服務預設值

配置通訊錄服務預設值

本節介紹單次登入 (SSO) 配接卡範本的相關資訊。這些範本會全面影響通訊通道在使用者的 Portal Desktop上顯示之情形。要變更使用者的通訊通道顯示設定檔，您需要編輯或建立 SSO 配接卡範本及配置。

本章僅探討通訊錄的範本。即使是以通訊錄為例，此處的探討內容仍十分具體。如需有關 SSO 配接卡、SSO 配接卡範本及 SSO 配接卡配置較為廣義的解釋，請參閱附錄 H，「SSO 配接卡範本與配置」。

配置通訊錄服務預設值
  1. 透過網際網路瀏覽器，登入 Identity Server 管理主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [服務配置] 標籤，使導覽窗格顯示出可配置的服務清單。
  3. 向下捲動導覽窗格，找到[單次登入配接卡配置] 標題，按一下 SSO 配接卡項目旁的箭頭，資料窗格中即出現 SSO 配接卡頁面。
  4. 按一下 SSO 配接卡配置底下的 [新增] 以新增 SSO 配接卡配置。

    5. [新配置] 頁面隨即顯示。

  5. 鍵入配置名稱，然後選取功能表中的 SUN-ONE-ADDRESS-BOOK。
  6. 按一下 [下一步]。

    7. [配置屬性] 頁面隨即顯示。

  7. 依需要修改屬性。
  8. 向下捲動 SSO 配接卡頁面，按一下 [儲存]。
  9. 完成後按一下 [儲存]。

    10. 如需 SSO 配接卡範本中的屬性之詳細資訊，請參閱附錄 H，「SSO 配接卡範本與配置」。

配置一般使用者通道設定

  1. 以新使用者的身份登入桌面：
    1. 利用網際網路瀏覽器連至：

      2. http://主機名.domain:port/portal/dt，例如 http://psserver.company22.example.com:80/portal/dt

    2. 輸入使用者 ID 及密碼。
    3. 按一下 [登入]。
  2. 按一下各通道的 [編輯] 按鈕，開始配置伺服器設定。
    • 若要配置郵件通道設定：

      • 伺服器名稱。輸入郵件伺服器的主機名稱。例如，mailserver.example.com。

      IMAP 伺服器連接埠。輸入郵件伺服器連接埠號碼。

      SMTP 伺服器名稱。輸入外送郵件伺服器 (簡易郵件傳輸協定，SMTP) 的網域名稱伺服器 (DNS) 名稱。

      用戶端連接埠。輸入 HTTP 服務配置使用的連接埠號碼。

      使用者名稱。輸入郵件伺服器使用者名稱。

      使用者密碼。輸入郵件伺服器使用者密碼。

      當傳送訊息時在 [寄件資料夾] 放置副本。勾選此方塊以在 [寄件資料夾] 中儲存外送訊息的副本。

      完成。按此按鈕儲存郵件配置。

        取消。按此按鈕關閉視窗而不儲存細部配置。

    • 配置通訊錄通道設定：

        • IMAP 使用者 ID 及密碼與配置郵件通道設定時輸入的使用者名稱及密碼相同。詳細請見前一分項若要配置郵件通道設定：之說明。

        IMAP 使用者 ID。輸入您的 IMAP 使用者 ID。

        IMAP 密碼。輸入您的 IMAP 密碼。

        完成。按此按鈕儲存伺服器資訊。

        取消。按此按鈕關閉視窗而不儲存詳細資料。

    • 若要配置行事曆通道設定：

        • 伺服器名稱。輸入行事曆伺服器主機名稱。例如 Calserver.example.com。

        伺服器連接埠。輸入行事曆伺服器連接埠號碼。

        使用者名稱。輸入行事曆伺服器使用者名稱。

        使用者密碼。輸入行事曆伺服器使用者密碼。

        完成。按一下此按鈕以儲存行事曆配置。

        取消。按此按鈕關閉視窗而不儲存詳細資料。

    • 編輯 Instant Messaging 通道設定：

        • 聯絡人清單。選取想要的聯絡清單，以便讓該清單內的聯絡人顯示於 Instant Messaging 通道中。

        啟動方法。選取想要的啟動方法：
        Java Plugin 或 Java Web Start。

        伺服器。輸入 Sun Java System Instant Messaging Server 名稱。例如：
        IMserver.example.com

        伺服器連接埠。輸入 Sun Java System Instant Messaging Server 連接埠號碼。例如：
        49999

        多重訊號組合器。輸入多重訊號組合器名稱，此組合器必須與 Sun Java System Instant Messaging 伺服器的機器是同一機器。例如：
        IMserver.example.com

        多重訊號組合器連接埠。輸入多重訊號組合器連接埠號碼。例如：
        49909

        使用者名稱。(只有在認證方法設定為 Sun Java System Identity Server 認證方法，idsvr 時，此欄位才會出現) 輸入 Sun Java System Instant Messaging 使用者名稱。

        使用者密碼。(只有在認證方法設定為 Sun Java System Identity Server 認證方法，idsvr 時，此欄位才會出現) 輸入 Sun Java System Instant Messaging 使用者密碼。

        完成。按此按鈕儲存 Sun Java System Instant Messaging Server 配置。

        取消。按此按鈕關閉視窗而不儲存詳細資料。

        備註     

        通訊錄、行事曆及郵件通道均各自擁有顯示選項可供使用者設定，且在預設下禁止管理員覆寫。使用者登入桌面後，只要按一下任一通道的窗格中之編輯按鈕，即可變更該通道的顯示選項。顯示選項均有明確標示且易於變更。

        在通訊錄通道中，使用者可變更的顯示選項為 [項目數目] 選項；在行事曆通道中，使用者可變更的顯示選項為 [顯示日檢視] 選項；在郵件通道中，使用者可變更的顯示選項為 [標頭數目] 選項。

        使用者對預設通訊通道顯示選項所做的變更具有優先效力。管理員日後所做的任何變更不會自動生效，而管理員新增的通道也不會自動開放供使用者存取。

應用程式喜好設定編輯：配置通訊通道編輯頁面

您可以配置一般使用者按一下通訊錄、行事曆或郵件通道的通訊通道工具列中的編輯按鈕即可看到的編輯頁面。Instant Messaging 通道則不使用應用程式喜好設定編輯。有關配置 Instant Messaging 通道的編輯頁面之資訊，請參閱「Sun Java System Portal Server 6 2004Q2 Desktop Customization Guide」。

您可以針對容許喜好設定編輯的三種通訊通道進行變更，開放選項供一般使用者編輯、依照該等選項變更名稱及文字敘述及選項格式化的方式等。您可以透過顯示設定檔、各種 HTML 範本及 SSO 配接卡範本，執行通訊通道編輯頁面的配置。也有可能需要存取 SSO 配接卡配置。這些項目均關係到編輯頁面的配置。

本節僅提供應用程式喜好設定編輯的簡要說明。本指南的其他章節以及「Sun Java System Portal Server 6 2004Q2 Desktop Customization Guide 」會針對範本檔案及顯示設定檔做較完整的解說，包括這些檔案彼此之間的互動方式，及其存取和編輯方法等。

編輯頁面之顯示設定檔屬性

通訊通道的顯示設定檔中具有兩項促使編輯頁面建立的集合，即 ssoEditAttributes 和 dpEditAttributes。

您可以進入 Sun Java System Identity Server 管理主控台來編輯這些集合。無論是下載顯示設定檔 (編輯 XML 碼後再將其上傳回目錄伺服器) 或是編輯這些集合中的特定屬性，都一律使用管理主控台。

ssoEditAttributes 集合係控制 SSO 配接卡服務內含屬性 (例如 user name 及 user passwor) 的編輯，而 dpEditAttributes 則是控制顯示設定檔屬性 (例如 sort order 和 sort by 等預設可供一般使用者編輯的選項) 的編輯。

因此，這些集合會列出可編輯的屬性，且包含有關輸入類型的資訊以及供輸入字串使用的標頭。例如：

<String name="uid" value="string|User Name:"/>

<String name="password" value="password|User Password:"/>

集合中的名稱必須符合對應的顯示設定檔 SSO 配接卡屬性。項目屬性值的部分含有兩項資訊，兩者間以“|” 字元分隔。該值字串的前半部分指定屬性的顯示類型。屬性的後半部分則是指定顯示於項目旁的文字。以下清單指出類型與對應的 HTML GUI 項目之關聯性：

每一種選取顯示類型都必須有對應的集合，其中列有可傳回的值以及該選項的顯示值。集合名稱必須涵蓋屬性值名稱及 SelectOptions 字樣。以 MailProvider 中的 sortOrder 屬性為例，其集合名稱為 sortOrderSelectOptions：

<Collection name="sortOrderSelectOptions" advanced="false" merge="replace" lock="false" propagate="true">

    <String name="top" value="Most recent at top"/>

    <String name="bottom" value="Most recent at bottom"/>

</Collection>

編輯頁面的 HTML 範本

可用來建立通訊通道提供者的編輯頁面之 HTML 範本共有 9 個。這些範本均特意製作得相當通用化，以便靈活對應特定的瀏覽器 GUI 類型。範本性質多半與編輯頁面中的特定 HTML 輸入值有關。但是 edit-start.template 及 edit-end.template 例外，這兩個範本所含之 HTML 輸入值多半適用於頁面佈局。表 14-2 中將說明各個範本名稱及其與 GUI 類型之關聯性。部分範本乃作為屬性開始、結束及分隔之用。這些範本適用於各種通訊通道，可至下列路徑存取：

/etc/opt/SUNWps/desktop/default/ChannelName_Provider/html

例如，行事曆通道編輯頁面的範本存放在：

/etc/opt/SUNWps/desktop/default/CalendarProvider/html

表 14-2  通訊通道編輯頁面範本  

範本

說明

edit-start.template

提供編輯頁面的開始 HTML 表格。

edit-checkbox.template

提供核取方塊項目之通用範本。

edit-separate.template

用來區分顯示設定檔屬性及 SSO 屬性。

edit-end.template

編輯頁面的結束 HTML 表格。

edit-password.template

提供密碼項目之通用範本。

edit-string.template

提供文字項目之通用範本。

edit-select.template

提供選取項目之通用範本。

edit-selectoption.template

提供選取選項之通用範本。如此會讓該選項亦可透過顯示設定檔動態產生。

edit-link.template

提供範本用來產生連結，方便使用者編輯其客戶的顯示屬性。

顯示設定檔範例

此範例顯示某些特定 SSO 配接卡屬性如何與對應的顯示設定檔屬性一起作用，讓一般使用者能夠變更通訊通道編輯頁面中的特定功能輸入項，藉此變更通訊通道的配置方式及其在一般使用者的 Portal Desktop 上的顯示方式。

程式碼範例 14-2 中的 SSO 配接卡範本乃針對範例郵件通道用進行示範。SSO 配接卡範本內含兩項合併屬性：

合併屬性可供一般使用者自行指定。管理員會決定將哪些屬性合併，亦即決定讓一般使用者編輯哪些屬性。

程式碼範例 14-2  範例 SSO 配接卡範本  

default|imap:///&configName=MAIL-SERVER-TEMPLATE

    &encoded=password

    &default=protocol

    &default=clientProtocol

    &default=type

    &default=subType

    &default=ssoClassName

    &default=smtpServer

    &default=clientPort

    &default=host

    &default=port

    &merge=username

    &merge=userpassword

    &clientProtocol=http

    &type=MAIL-TYPE

    &subType=sun-one

    &ssoClassName=com.sun.ssoadapter.impl.JavaMailSSOAdapter

    &smtpServer=example.sun.com

    &clientPort=80

    &host=company22.example.com

    &port=143

程式碼範例 14-3 包含通道的 ssoEditAttributes 之顯示設定檔 XML 片段。

當管理員在 SSO 配接卡範本中設定 merge 屬性後，即可在顯示設定檔內編輯該屬性，以便重新配置該屬性在編輯頁面中的顯示方式，以及一般使用者能夠編輯的程度。管理員可藉由編輯適當的顯示設定檔集合，決定一般使用者應提供的必要資訊。例如，在本範例中，管理員可將 User Name 改成問句：「What is your user name?」。 string 屬性顯示類型的設定方式，通常是放在 “|” 符號之前。不過管理員也可以將此屬性變更為 password 類型或者其他類型。

程式碼範例 14-3  範例郵件通道顯示設定檔 XML 片段  

<Channel name="SampleMailChannel" provider="MailProvider">

<Properties>

<Collection name="ssoEditAttributes">

    <String name="username" value="string|User Name:"/>

    <String name="userpassword" value="password|User Password:"/>

</Collection>

在此範例中，一般使用者會在郵件通道編輯頁面中看到以下標題的文字欄位：

允許一般使用者設定通訊通道類型的多重實例

一般使用者或管理員可建立多種類型的通訊通道。一般使用者如要建立多種類型的通訊通道，需使用 [特性] 頁面上的 [建立新通道] 連結。

管理員可針對組織、角色或群組建立多重通道。當管理員建立好特定元件的多重執行實例 (例如通訊錄元件的第二執行實例) 後，即可讓一般使用者在自己的「Portal Desktop」上配置第二通訊錄通道。

管理員可針對各個新通訊通道類型分別建立 SSO 配接卡範本，亦可使用一個 SSO 配接卡範本為各通道建立多個 SSO 配接卡配置。如需詳細資訊，請參閱 SSO 配接卡說明文件，詳如附錄 H，「SSO 配接卡範本與配置」。

依據管理員所完成的配置工作量，一般使用者也許不需要輸入太多配置。管理員可以利用應用程式喜好設定編輯功能來配置這些設定 (請參閱應用程式喜好設定編輯：配置通訊通道編輯頁面)。

要建立兩個通訊錄通道，需使各個通道參照不同的 SSO 配接卡範本。接著就可以將兩個通訊錄通道添加至剛剛訪問過的可視頁面。或者，您可以建立一個 SSO 配接卡範本及兩個 SSO 配接卡配置 (動態產生)。SSO 配接卡範本會將伺服器設定定義為使用者可定義的值 (merge)，如此一來 SSO 配接卡配置即可指定該等伺服器設定。

要配置不同伺服器的通訊錄供一般使用者視其需要配置伺服器，其步驟如下：

  1. 在 SSO 配接卡範本中，將伺服器資訊指定成使用者可定義、合併。如需詳細資訊，請參閱附錄 H，「SSO 配接卡範本與配置」
  2. 在通道顯示設定檔 ssoEditAttributes 集合中，指定可編輯的屬性。如需詳細資訊，請參閱應用程式喜好設定編輯：配置通訊通道編輯頁面；有關顯示設定檔的特定資訊，請參閱「Sun Java System Portal Server 6 2004Q2 Desktop Customization Guide」。

管理員代理伺服器驗證：結束一般使用者憑證配置

您可以為通訊錄通道、行事曆通道和郵件通道啟用管理員代理伺服器認證。若延伸支援 Sun Java System Portal Server 和 Sun Java System 傳訊服務 (Messaging Server 及 Calendar Server) 之間的代理伺服器認證，一般使用者在輸入其憑證時便不再需要造訪通道的編輯頁面：使用者名稱與使用者密碼。此時使用管理員憑證而非一般使用者憑證，它們儲存於 SSO 配接卡範本中。在範本中，管理員的使用者 ID 係存成 proxyAdminUid 屬性值，而管理員密碼則存成 proxyAdminPassword 屬性值。每當使用者啟動通道時，這些值便會用來在通道及其各自的後端伺服器之間建立連線。使用者的命名屬性還傳送至後端伺服器。有關使用管理員代理伺服器認證的命名屬性之詳細資訊，請參閱 userAttribute 屬性，詳如表 14-3。

代理伺服器認證無法配置為供 Sun Java System Instant Messaging Server、Microsoft Exchange Server 或 IBM Lotus Notes 伺服器使用。

注意：多位一般使用者導向同一郵件帳戶之潛在可能

Identity Server 與 Portal Server 允許管理員在組織中使用相同的使用者 ID 設定使用者。例如，組織可以有兩個子組織，每個子組織有一個名為 enduser22 的一般使用者。若 Sun Java System 通訊通道啟用了一個管理員代理伺服器認證，且一般使用者命名屬性設定為預設 uid，之後兩個使用者皆可以存取相同的後端使用者帳戶。管理員代理伺服器認證能讓管理員變更 SSO 配接卡範本中的使用者命名屬性。例如，您可以變更屬性為每個員工的唯一屬性，例如員工編號，以確保入口網站一般使用者可以存取正確的後端伺服器帳戶。

代理伺服器認證配置方法簡介

為啟用通訊錄、行事曆及郵件通道的管理員代理伺服器認證，您需透過 Sun Java System Identity Server 管理主控台存取 SSO 配接卡範本，此外還需存取 Sun Java System 通訊伺服器。更具體而言，您需要：

代理伺服器認證與單次登入 (SSO) 配接卡範本

編輯 SSO 配接卡範本以啟用管理員代理伺服器認證
  1. 透過網際網路瀏覽器登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [服務配置] 標籤，使導覽窗格顯示出可配置的服務清單。
  3. 選取 SSO 配接卡以顯示用於在資料窗格中配置 SSO 配接卡的頁面。
  4. 按一下對應通道的字串，以啟用該通道的管理員代理伺服器認證。
  5. 按一下配置描述欄位。
  6. 刪除並鍵入管理代理伺服器認證的必要資訊：

代理伺服器認證與通訊伺服器

設定 Sun Java System Messaging Server 中之管理員代理伺服器認證
  1. 登入 Sun Java System Messaging Server 軟體主機成為超級使用者。
  2. 鍵入下列代碼：

    3. messaging-server-install-dir/msg-instance-name/configutil -o service.http.allowadminproxy -v yes

  3. 重新啟動 Messaging Server。

    4. 請參閱「Sun Java System Messaging Server 管理員指南」中有關執行 configutil 並重新啟動伺服器的詳細指示。

設定 Calendar Server 中之管理員代理伺服器認證
  1. 登入 Sun Java System Calendar Server 軟體主機成為超級使用者。
  2. 使用選擇的編輯程式開啟以下檔案：

    3. calendar-server-install-dir/cal/bin/config/ics.conf

  3. 設定下列屬性如：

    4. service.http.allowadminproxy = "yes"

  4. 重新啟動行事曆伺服器。

    5. 有關重新啟動伺服器的詳細說明，請參閱「Calendar Server 管理員指南」。

配置「無認證的 Portal Desktop」使用之唯讀通訊通道

無認證 (無認證匿名) Portal Desktop支援唯讀通訊通道。

唯讀通訊通道實情與考量

您可以配置透過無認證匿名 Portal Desktop，以唯讀方式存取通訊錄、行事曆及郵件通道。一般使用者只要存取「Portal Desktop」即可透過唯讀通訊通道存取資訊，亦即在網際網路瀏覽器中輸入下列 URL 即可：

http://hostname.domain:port/portal/dt，例如 http://psserver.company22.example.com:80/portal/dt

一般使用者無需登入，即可存取管理員所配置的任何唯讀通訊通道。不過一般使用者通常無法編輯此類通道。有關無認證的Portal Desktop的詳細資訊，包括啟用匿名登入的方法，請參閱「Sun Java System Portal Server 6 2004Q2 Desktop Customization Guide」。

行事曆通道是由多位使用者最常共用的通道，以下步驟用於配置唯讀行事曆通道。在此範例中，共用的行事曆屬於使用者程式庫。公共唯讀行事曆的標題為 Library Schedule。下列的行事曆設定示範了其中一種可能的方式。如需有關設定 Sun Java System Calendar Server 使用者的更多資訊，請參閱「Sun Java System Calendar Server 管理員指南」中 csuser 指令的 create userid 選項。

若要設定行事曆使用者

  1. 發出例如下列的指令之後，即可建立行事曆使用者：

    2. csuser -g Library -s Admin -y libadmin -l en -m libadmin@library.com -c librarySchedule create libadmin

    其中，使用者 libadmin 的名字為 Library，姓氏為 Admin，密碼為 libadmin，喜好設定的語言為 en (英文)，電子郵件位址為 libadmin@library.com，而行事曆 ID 則是 librarySchedule。

  2. 將存取權限設定為所有人皆可讀取：

    3. libadmin:librarySchedule

    您可以使用 cscal 公用程式來設定存取權限，而一般使用者則可以使用 Calendar Express 設定存取權限。

配置唯讀通訊通道

  1. 針對一般使用者設定進行配置－在此例中即指無認證匿名設定－並建立行事曆 SSO 配接卡配置。
    1. 透過網際網路瀏覽器，登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
    2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
    3. 按一下 [檢視] 下拉清單中的 [使用者]。
    4. 視需要將畫面捲動到無認證匿名使用者，然後按一下其旁邊的箭頭，使無認證匿名頁面顯示於資料窗格中。

      5. 現在您可以將 SSO 配接卡服務新增至無認證匿名使用者。

    5. 在無認證匿名頁中按一下 [檢視] 下拉清單中的 [服務]，以顯示可用的服務。
    6. 按一下 [新增] 。
    7. 按一下 SSO 配接卡的核取方塊
    8. 按一下 [儲存]。
  2. 針對該無認證匿名使用者建立一項行事曆 SSO 配接卡配置。
    1. 如果尚未登入，請登入 Sun Java System Identity Server 管理主控台。
    2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
    3. 在 [檢視] 下拉清單中選取 [服務]，顯示可配置的服務清單。
    4. 按一下 SSO 配接卡旁的箭頭，資料窗格中即出現 [SSO 配接卡] 頁面。
    5. 在空白的配置描述欄位中，鍵入群組導向式的 SSO 配接卡配置字串 (帶有使用者 ID 及密碼)。稍後將提出一典型配置供您參考。此字串中可配置的屬性，會因您對於 Sun Java System Portal Server SSO 配接卡範本的配置方式而異。依預設，SSO 配接卡範本會預期使用者指定下列資訊：
    6. host
    7. port
    8. client port
    9. uid
    10. password

      11. 若當您準備進行配置時發現配置描述欄位已有設定，在您以下列格式輸入字串前，請選取該欄位中所有的文字並將其刪除。

      default|undef://?uid:password@host:port/?
      configName=      configuration-name
      &configDesc=configuration-description

      例如：

      default|undef://?libadmin:libadmin@example.com:3080/?
      configName=sunOneCalendar_librarySchedule
      &configDesc=SUN-ONE-CALENDAR

    11. 按一下 [新增] 。
    12. 按一下 [儲存]。
  3. 根據新建立的 SSO 配接卡配置，建立無認證匿名使用者的新行事曆通道。
    1. 如果尚未登入，請登入 Sun Java System Identity Server 管理主控台。
    2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
    3. 按一下 [檢視] 下拉清單中的 [使用者]。
    4. 視需要將畫面捲動到無認證匿名使用者，然後按一下其旁邊的箭頭，使無認證匿名頁面顯示於資料窗格中。

      5. 現在您可以為無認證匿名使用者建立新行事曆通道。

    5. 在無認證匿名頁中按一下 [檢視] 下拉清單中的 [Portal Desktop]，以顯示 [編輯] 連結。
    6. 按一下 [編輯] 連結。
    7. 按一下 [通道與容器管理] 連結。
    8. 向下捲動到 [通道] 段落，然後按一下 [新增] 。
    9. 在 [通道名稱] 欄位中輸入一個名稱。例如：

      10. LibraryScheduleChannel

    10. 請從提供者下拉式清單中選取正確的提供者。在本例中，正確的提供者為 Calendar Provider。
    11. 按一下 [確定] 之後，您將會回到 [通道與容器管理] 頁。

      12. 現在您可以編輯通道特性。

    12. 向下捲動畫面至 [通道] 部分，按一下您新建通道旁邊的 [編輯特性]。例如：

      13. LibraryScheduleChannel

    13. 視情況編輯欄位。例如：
      • 標題：Library Schedule
      • 說明：Library Schedule
      • ssoAdapter:sunOneCalendar_librarySchedule
      • loadSubscribedCalendars:false (無核取標記)
      • 可編輯：false (無核取標記)
    14. 視需要捲動畫面，按一下 [儲存]。

      15. 現在您可以將新行事曆通道新增至無認證匿名使用者的 [Portal Desktop] 上。

    15. 在靠近頁面的頂端按一下 [頂端]，您將會回到[通道與容器管理] 頁。
    16. 向下捲動到 [容器通道] 區段，按一下您要用來加入新通道的容器連結。例如 MyFrontPageTabPanelContainer。請勿點選旁邊的 [編輯屬性] 連結。
    17. 在 [通道管理] 標題下，按一下您剛剛建立通道的名稱。例如，位於 [現有通道] 清單中的 LibraryScheduleChannel。
    18. 按一下 [可用] 與 [可視] 清單旁的 [新增] 按鈕。如此即可讓使用者看見並使用此通道，無需再做任何配置。
    19. 向上捲動頁面按一下 [通道管理] 標題下的 [儲存]。
    20. 重新啟動 web 容器。

配置 Microsoft Exchange Server 或 IBM Lotus Notes

除了支援 Sun Java System Messaging Server 及 Sun Java System Calendar Server 的通訊通道以外，Sun Java System Portal Server 6 2004Q2 亦支援 Microsoft Exchange Server 以及 IBM Lotus Notes 伺服器。

您可以配置 Microsoft Exchange Server 使其與 Sun Java System Portal Server 一同運作，讓一般使用者可以存取 Microsoft Outlook Web Access 解決方案。一般使用者只要在 Portal Desktop 上的各個通道中，按一下 [啟動通訊錄]、[啟動行事曆] 或 [啟動郵件] 即可。

同樣的，您也可以配置 IBM Lotus Notes 伺服器，使其配合 Sun Java System Portal Server 一同運作，讓一般使用者透過通訊錄、行事曆及郵件通道存取 IBM Lotus Domino Webmail 解決方案。

備註     

Microsoft Exchange Server 及 IBM Lotus Notes 伺服器不支援管理員代理伺服器認證或單次登入。此乃受限於單次登入的限制，當一般使用者啟動連接這兩種伺服器之一的通道時，需重新輸入憑證才能連線。

配置 Microsoft Exchange Server 的通訊錄、行事曆及郵件

  1. 以網域管理員的身份登入您的網域主控站 (PDC)。
  2. 依序選取 [開始]、[程式集]、[管理工具]、[網域使用者管理程式]，以使用者名稱 MAXHost 建立帳戶。
  3. 選取 [群組] 並將 MAXHost 加入 [管理員] 及 [網域管理] 群組。
  4. 確定 MAXHost 可從本端登入 MAIL_HOST、網域控制台及 MAX_HOST。
  5. 設定密碼。
  6. 以 MAXHost 登入您的 Exchange 5.5 (MAIL_HOST)。
  7. 進入 [開始]、[程式集]、Microsoft Exchange、Microsoft Exchange 管理員。
  8. 針對每位一般使用者設定電子信箱使用權限。
  9. 啟用權限標籤的方法是，進入 [工具]、[選項]、[權限]，啟用 [顯示所有物件的權限頁面]。
  10. 連按兩下使用者名稱。
  11. 選取權限標籤，再從權限頁面選取 [新增]，將 MAXHost 加入但角色維持 [使用者] 不變。

    12. 重複步驟 9 至 11，逐一設定所有需要存取通訊通道的使用者。

  12. 將 ocxhost.zip 檔解壓縮並置入下列目錄：

    13. /Portal-server-install-dir/SUNWps/export。

    檔案解壓縮後，會看到下列檔案格式：

    Archive:ocxhost.zip

    creating:ocxhost

    creating:ocxhost/international

    inflating:ocxhost/international/ocxhostEnglishResourceDll.dll

    inflating:ocxhost/ocxhost.exe

  13. 依下列步驟註冊 ocxhost：
    1. 找出 ocxhost.exe。
    2. 選取 [開始]，然後選取 [執行]。
    3. 在 [執行] 視窗中鍵入：

      4. ocxhost.exe /multipleuse

  14. 如要設定 ocxhost 公用程式的屬性：
    1. 使用 dcomcnfg 公用程式來配置 ocxhost 公用程式的必要 DCOM 設定。方法是：
      1. 選取 [開始]，然後選取 [執行]。
      2. 鍵入 dcomcnfg 然後選取 [確定]。
    2. 在 [分散式 COM 配置屬性] 對話方塊中：
      1. 選取 [預設特性] 標籤：
      2. 勾選電腦上 [啟用分散式 COM] 核取方塊。
      3. 將預設的 [認證層級] 設定為 [連接]。
      4. 將預設的 [模擬層級] 設定為 [識別]。
      5. 選取 [應用程式] 標籤。
      6. 在 [特性] 對話框中連按兩下 ocxhost 公用程式。

        7. 出現 ocxhost 屬性視窗。

      7. 在 [位置] 標籤下勾選 [在此電腦上執行應用程式]。
      8. 在 [安全性] 標籤下設定 [使用自訂存取權限]、[使用自訂啟動權限] 及 [使用自訂配置權限]。
      9. 選取 [編輯] 分別編輯 [存取]、[啟動] 及 [配置] 設定，確定存取控制清單 (ACL) 內含下列使用者：
      10. 互動
      11. 每人
      12. 系統
      13. 在 ocxhost 屬性視窗內的 [識別] 標籤下，選取其中一個使用者。
      14. 按一下 [瀏覽] 並找出 MAXHost。
      15. 輸入密碼並確認密碼。
    3. 按一下 [確定]。

      4. ocxhost DCOM 元件現在已配置完成，可以與 Exchange 伺服器進行通訊。

配置 Lotus Domino 伺服器啟用通訊錄、行事曆及郵件

  1. 依序選取 [開始]、[程式集]、[Lotus 應用程式] 及 [Lotus 管理員]，以開啟 Lotus 管理員。
  2. 進入 [管理]、[配置]、[伺服器]、[目前伺服器文件]。
  3. 在 [安全性] 標籤中，進行下列設定：
    1. 在 [Java/COM 限制] 下，設定 [執行限定 Java/Javascript/COM]，並將 [執行非限定 Java/Javascript/COM] 設為 *。
    2. 在 [安全設定] 下：
      • 將 [比較 Notes 公開金鑰與目錄中儲存者] 設為 [否]。
      • 將 [允許 Notes 匿名連線] 設為 [否]。
      • 將 [Notes ID 密碼] 勾選為 [停用]。
    3. 在 [伺服器存取] 下，將 [僅允許此目錄所列的使用者存取伺服器] 設為 [否]。
    4. 在 [web 伺服器存取] 下，將 [web 伺服器認證] 設定為較低安全性的 [更多名稱變異]。
  4. 在 [連接埠] 標籤中：
    1. 選取 [Notes 網路連接埠] 標籤，確定 TCPIP 已啟用。
    2. 選取 [網際網路連接埠] 標籤及 Web 標籤。
      1. 確定 TCP/IP 連接埠狀態為 [啟用]。
      2. 在 [認證] 選項下，確定名稱、密碼及匿名設定為 [是]。
    3. 選取 [目錄] 標籤，確定：
      • TCP/IP 連接埠狀態為 [啟用]。
      • 認證選項項目 [名稱]、[密碼] 及 [匿名] 設為 [是]。
      • SSL 連接埠狀態為 [停用]。
    4. 選取 [郵件] 標籤，確定：
      • TCP/IP 連接埠狀態為 [啟用]。
      • 認證選項 [名稱]、[密碼] 及 [匿名] 設定如下：

        •  

        郵件 (IMAP)

        郵件 (POP)

        郵件 (SMTP 輸入)

        SMTP (輸出)

        名稱及密碼

        是

        是

        否

        不適用

        匿名

        不適用

        不適用

        是

        不適用

    5. 選取 IIOP 標籤，確定：
      • TCP/IP 連接埠狀態為 [啟用]。
      • 認證選項項目 [名稱]、[密碼] 及 [匿名] 設為 [是]。
      • TCP/IP 連接埠號碼非 0。應設定為 63148。
      • SSL 連接埠狀態為 [停用]。
  5. 選取 [網際網路通訊協定] 標籤及 IIOP 子標籤。確定 [執行緒數目] 至少為 10。
  6. 儲存並關閉。
  7. 在 Domino 伺服器主控台中鍵入下列指令，重新啟動伺服器：

    8. restart server

    重新啟動伺服器使上述設定生效。

  8. 在主控台中鍵入以下指令，啟用 DIIOP 伺服器：

    9. load diiop

  9. 檢查 diiop_ior.txt 是否已產生於下列位置：

    10. C:\Lotus\Domino\Data\domino\html\diiop_ior.txt

  10. 在主控台中鍵入以下指令，啟用 HTTP 服務：

    11. load http

    • 連接埠 80 如被另一服務佔用，HTTP 服務將無法啟動。停止正於連接埠 80 執行的服務，再於主控台中重試以下指令：load http

      • 或者

    • 使用現有的服務。若要執行此操作，請將 diiop_ior.txt 檔案複製到在連接埠 80 上執行的 web 伺服器的根目錄或主目錄中。您可以在 notes.ini 檔案中同時包括 HTTP 服務以及 DIIOP 服務，以確保當您啟動伺服器時，這兩種服務亦會啟動。

配置 Lotus Notes

要透過 Sun Java System Portal Server 郵件與行事曆通道存取 Lotus Notes 系統，需將另一個檔案加入 Sun Java System Portal Server。其檔案名為 NCSO.jar。必須從 Lotus Notes 產品光碟或 IBM 網站下載。

此檔案為 IBM 的 Domino Designer 及 Domino Server 產品所附，存放在 domino\java 子目錄中。亦可透過下列網站下載而得：

http://www-10.lotus.com/ldd/toolkits

找到 Lotus Domino Toolkit 連結，再前往 Java/Corba R5.0.8 更新連結。

備註

下載檔案為 .exe 檔，執行後可擷取此檔及其他檔案。

參照後續介紹四個 web 容器的章節，將 NCSO.jar 檔置入 web 容器 (web 伺服器或應用程式伺服器) 的全域類別路徑下。四個 web 容器的其中三個容器之 NCSO.jar 檔案放在 /usr/share/lib 中。下列表格將會後續步驟進行摘要說明。下表藉由指出放置 NCSO.jar 檔的位置，摘要說明將 JAR 檔置入全域類別路徑之程序：可放置在 System Classpath 或是在 Portal WAR。表格也已指出是否需要特別說明。如果需要，會在本區段稍後將說明納入。

Web 容器

系統類別路徑

Portal WAR

特殊指示

Sun Java System Web Server

是

是

不適用

Sun Java System Application Server

是

是

不適用

BEA WebLogic Server

是

否

如何更新系統類別路徑

IBM WebSphere Application Server

否

是

如何剪除 JAR 檔

執行下列步驟時，需具備 web 容器的管理權限。此外亦需具備 web 容器說明文件的存取權限，以便參照各種 web 容器處理程序與指令的詳細資訊。有關 Sun Java System web 容器的詳細資訊，請參閱「Sun Java System Application Server 管理員指南」或「Sun Java System Web Server Enterprise Edition Administrators Guide」。

Sun Java System Web Server

Sun Java System Application Server

BEA WebLogic Server

IBM WebSphere Application Server

Sun Java System Web Server
  1. 將 NCSO.jar 置入下列 Sun Java System Portal Server 目錄：

    2. /usr/share/lib

  2. 更新 web 容器類別路徑以包括：

    3. /usr/share/lib/NCSO.jar

    1. 啟動 Sun Java System Web Server 管理主控台。
    2. 選取 Sun Java System Web Server 實例。
    3. 按一下 [管理]。
    4. 選取 Java 標籤。
    5. 選取 [JVM 路徑設定]。
    6. 將 /usr/share/lib/NCSO.jar 加入類別路徑字尾。
    7. 選取 [確定]。
    8. 選取 [採用]。
  3. 重新啟動 Sun Java System Web Server，但通常非強制重新開機，如此較有利於實際操作。
NCSO.jar 檔案操作位置
  1. 將 NCSO.jar 檔案置入下列目錄：

    2. Portal-server-install-dir/SUNWps/web-src/WEB-INF/lib

  2. 以下列指令重新佈署 web 應用程式：

    3. /Portal-server-install-dir/SUNWps/bin/deploy redeploy

  3. 重新啟動 web 容器。
Sun Java System Application Server
  1. 將 NCSO.jar 置入下列 Sun Java System Portal Server 目錄：

    2. /usr/share/lib

  2. 使用 Sun Java System Application Server 管理主控台更新 web 容器類別路徑，使其包含 /usr/share/lib/NCSO.jar。
    1. 啟動 Sun Java System Application Server 管理主控台。
    2. 選取網域。
    3. 選取伺服器實例。
    4. 在伺服器實例檢視畫面中，選取 [JVM 設定] 標籤。
    5. 在 [JVM 設定] 標籤下選取 [路徑設定]。
    6. 將 /usr/share/lib/NCSO.jar 加入類別路徑字尾清單。
    7. 選取 [儲存]。
    8. 在該實例的 [一般] 標籤下，選取 [套用變更]。
    9. 選取 [重新啟動]。
NCSO.jar 檔案操作位置
  1. 將 NCSO.jar 檔案置入下列目錄：

    2. Portal-server-install-dir/SUNWps/web-src/WEB-INF/lib

  2. 以下列指令重新佈署 web 應用程式：

    3. /Portal-server-install-dir/SUNWps/bin/deploy redeploy

    其中 Portal-server-install-dir 表示 Portal Server 的原始安裝目錄。

  3. 重新啟動 web 容器。
BEA WebLogic Server
  1. 將 NCSO.jar 置入下列 Sun Java System Portal Server 目錄：

    2. /usr/share/lib

  2. 使用指令行更新 web 容器類別路徑，使其包含 /usr/share/lib/NCSO.jar。
    1. 將目錄變更為 web 容器安裝目錄：

      2. web-container-install-dir/bea/wlserver6.1/config

      其中 web-container-install-dir 表示 web 容器的原始安裝目錄。

    2. 將目錄變更為包含網域實例的目錄：

      3. mydomain

    3. 使用任意編輯程式，編輯 startWebLogic.sh 檔。
    4. 將 /usr/share/lib/NCSO.jar 加在 CLASSPATH 結尾之後。

      5. 備註   

      startWebLogic.sh 檔可以包含多重 CLASSPATH 定義。找出變數的最後定義，並將下列字串新增至 CLASSPATH 的最後：

      /usr/share/lib/NCSO.jar

    5. 重新啟動 web 容器。
IBM WebSphere Application Server
  1. 從 NCSO.jar 檔中剪除 org/w3c/dom/ 及 org/xml/sax/ 下的類別並重新壓縮 JAR 檔。

    2. 這些類別應包括：

    • org/w3c/dom/Document.class
    • org/w3c/dom/Node.class
    • org/xml/sax/InputSource.class
    • org/xml/sax/SAXException.class

      • 這項作業可透過許多方法執行。在此提供您兩個範例。請選用最適合您的方法：

    • 以下方法需要手動執行 JAR 檔案的解壓縮及重新壓縮：
    • 下載檔案並置入以下目錄：

      • /tmp/ncsoprune/work

    • 在該目錄中將 JAR 檔案解壓縮。
    • 移除前四個類別。
    • 重新壓縮檔案。
    • 以下方法需執行程序檔，藉此自動執行 JAR 壓縮及解壓縮邏輯。
    • 下載檔案並置入以下目錄：

      • /tmp/ncsoprune/work

    • 執行下列程序檔：

      • #!/bin/ksh

      JAR=/usr/j2se/bin/jar

      JAR_FILE=NCSO.jar

      RM=/usr/bin/rm

      BASE_DIR=/tmp/ncsoprune

      WORK_DIR=${BASE_DIR}/work

      # cd to director of jar file

      cd $WORK_DIR

      # unjar

      $JAR xvf $JAR_FILE

      # prune classes

      $RM $WORK_DIR/org/w3c/dom/Document.class

      $RM $WORK_DIR/org/w3c/dom/Node.class

      $RM $WORK_DIR/org/xml/sax/InputSource.class

      $RM $WORK_DIR/org/xml/sax/SAXException.class

      # jar

      $JAR cvf $BASE_DIR/$JAR_FILE META-INF com lotus org

  2. 將重新壓縮後的 NCSO.jar 檔案置入下列目錄：

    3. Portal-server-install-dir/SUNWps/web-src/WEB-INF/lib

  3. 以下列指令重新佈署 web 應用程式：

    4. /Portal-server-install-dir/SUNWps/bin/deploy redeploy

    其中 Portal-server-install-dir 表示 Portal Server 的原始安裝目錄。

  4. 重新啟動 web 容器。

在預設組織下新建使用者

  1. 透過網際網路瀏覽器，登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
  2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
  3. 在 [檢視] 下拉清單中選取 [使用者]，開啟 [使用者] 頁面。
  4. 按一下 [新增] 以在資料窗格中顯示 [新使用者] 頁面。
  5. 選取要指派給使用者的服務。

    6. 選取最小 Portal 桌面及 SSO 配接卡。

  6. 輸入使用者資訊。
  7. 按一下 [建立]。

    8. 新使用者的名稱即出現在導覽窗格的 [使用者] 清單中。

配置郵件提供者使其配合啟用 HTTPS 的 Messaging Server 運作

郵件通道自動支援 HTTP 通訊協定，但不自動支援更安全的 HTTPS 通訊協定。不過，Sun Java System Messaging Server 若支援 HTTPS，即可依據本節的下列步驟配置郵件提供者，使其配合 Sun Java System Messaging Server 適當運作。這些步驟不適用於 Microsoft Exchange Server 及 IBM Lotus Notes 伺服器。

Web 容器實情與考量

配置郵件提供者使其支援 HTTPS 以存取 Sun Java System Messaging Server 時，web 容器方面的步驟會因實際使用的 web 容器而異：Sun Java System Web Server、Sun Java System Application Server、BEA WebLogic Server 或 IBM WebSphere Application Server。無論採用何種 web 容器，都需具備管理權限。此外亦需要能夠存取 web 容器說明文件，以便參照有關建立可靠資料庫、新增憑證及重新啟動 web 容器等的詳細資訊。這些作業及其他有關 Sun Java System web 容器之詳細資訊，請參閱「Sun Java System Application Server Administrators Guide to Security 」或者「Sun Java System Web Server Enterprise Edition Administrators Guide」。

配置郵件提供者使其配合支援 HTTPS 的 Messaging Server 運作

  1. 建立可靠資料庫供執行 Sun Java System Portal Server 的 web 容器使用。如需詳細資訊，請參閱前一段內容所述之適當說明文件。
  2. 如尚未安裝信賴憑證管理中心 (TCA) 的 SSL 憑證，請立即安裝。
  3. 重新啟動 web 容器，但通常非強制重新開機，如此較有利於實際操作。
  4. 新增 HTTPS 專用的 SSO 配接卡範本。本範例中使用的範本名稱為 SUN-ONE-MAIL-SSL，由於其名稱中包含安全通訊協定 SSL，故屬於描述性的。

    5. 備註       

    配置 SSO 配接卡範本及相關 SSO 配接卡配置的方法很多。後述步驟為您示範較典型的配置。這些步驟說明如何建立新的範本及新配置而不只是編輯現有的範本及配置，因為這樣做會比較安全。

    如果您覺得使用編輯選項比較好，亦可採用編輯方式。不過，您在編輯時如有變更 SSO 配接卡範本名稱及 SSO 配接卡配置，亦需要編輯郵件通道的屬性，變更其中的 SSO 配接卡名稱。

    SSO 配接卡範本或 SSO 配接卡配置中需要編輯的兩個項目如下：

    • clientProtocol
    • clientPort

    在本範例中建立新的 SSO 配接卡範本時，clientProtocol 屬性乃設定為預設特性。因此該屬性會出現在 SSO 配接卡範本中，而非 SSO 配接卡配置。clientProtocol 必須從 http 變更為 https。此屬性的編輯後範本片段如下：

    clientProtocol=https

    在本範例中，clientPort 屬性設定為 merge 屬性。因此會出現在 SSO 配接卡配置中 (請參閱步驟 5)。若將 clientPort 屬性設為 預設特性，則會出現在 SSO 配接卡範本中。用戶端連接埠應變更為專為 HTTPS 保留的連接埠。在此使用連接埠 443，這是 HTTPS 通訊協定所使用的預設連接埠號碼。此屬性的編輯後範本片段如下：

    &clientPort=443

    1. 透過網際網路瀏覽器登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
    2. 按一下 [服務配置] 標籤，使導覽窗格顯示出可配置的服務清單。
    3. 按一下 SSO 配接卡旁的箭頭，資料窗格中即出現 [SSO 配接卡] 頁面。
    4. 請鍵入範本名稱，然後從功能表中選取現有的範本。
    5. 按一下 [下一步]。
    6. [範本屬性] 頁面隨即顯示。
    7. 依需要修改屬性。

      8. 程式碼範例 14-4 為一個提供您參考的典型配置。您實際輸入的範本可能會有所不同。例如，您可能會輸入不同的 configName 屬性類型值，除非您要用 SUN-ONE-MAIL-SSL 名稱。此外，您設為預設及合併的屬性有可能和本範例有所出入，需視您的網站需求而定。

    8. 完成後按一下 [儲存]。

      9. 程式碼範例 14-4  HTTPS 使用之郵件 SSO 配接卡範本 Messaging Server

      default|imap:///?configName=SUN-ONE-MAIL-SSL

          &encoded=password

          &default=protocol

          &default=clientProtocol

          &default=type

          &default=subType

          &default=enableProxyAuth

          &default=proxyAdminUid

          &default=proxyAdminPassword

          &default=ssoClassName

          &merge=host

          &merge=port

          &merge=uid

          &merge=password

          &merge=smtpServer

          &merge=clientPort

          &clientProtocol=https

          &enableProxyAuth=false

          &proxyAdminUid=[PROXY-ADMIN-UID]

          &proxyAdminPassword=[PROXY-ADMIN_PASSWORD]

          &type=MAIL-TYPE

          &subType=sun-one

          &ssoClassName=com.sun.ssoadapter.impl.JavaMailSSOAdapter

          &default=enablePerRequestConnection

          &enablePerRequestConnection=false

      在此，開頭為 IMAP 通訊協定的字串可能不止一個。只要接受即可。

  5. 新增 HTTPS 專用的新 SSO 配接卡配置。本範例中使用的配置名稱是 sunOneMailSSl，特意仿照各 SSO 配接卡範本所使用的名稱。

    6. 備註

    請參閱前述步驟中的備註，步驟 4。

    1. 透過網際網路瀏覽器，登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
    2. 按一下 [識別管理] 標籤，在導覽窗格中顯示[檢視] 下拉清單。
    3. 按一下 [檢視] 下拉清單中的[服務]。
    4. 向下捲動導覽窗格，找到[單次登入配接卡配置] 標題，按一下 SSO 配接卡旁的箭頭，資料窗格中即出現 SSO 配接卡頁面。
    5. 按一下空白配置描述欄位，即位於[新增] 及[移除] 按鈕上方的欄位。
    6. 按一下 SSO 配接卡配置底下的[新增] 以新增 SSO 配接卡配置。
    7. [新配置] 頁面隨即顯示。
    8. 請鍵入配置名稱，然後從功能表中選取 SSO 配接卡範本。
    9. 按一下 [下一步]。
    10. [配置屬性] 頁面隨即顯示。
    11. 依需要修改屬性。
    12. 完成後按一下 [儲存]。
  6. 將新的郵件通道加入「Portal Desktop」。

    7. 步驟 4 和步驟 5 說明如何建立新的 SSO 配接卡範本及 SSO 配接卡配置，這兩個步驟都屬於建立新通道的部分。在此步驟中，您要開放通道供一般使用者使用。

    新通道的命名準則只有一個，就是具描述性，因此這裡使用的範例名稱是 SunOneMailSSLChannel。

    1. 透過網際網路瀏覽器，登入 Sun Java System Identity Server 主控台 (http://hostname:port/amconsole)，例如 http://psserver.company22.example.com:80/amconsole
    2. 按一下 [識別管理] 標籤，在導覽窗格中顯示 [檢視] 下拉清單。
    3. 在 [檢視] 下拉清單中選取 [服務]，顯示可配置的服務清單。
    4. 在 Portal Server 配置標題下，按一下 Portal 桌面旁的箭頭，資料窗格中即出現 [Portal 桌面] 頁面。
    5. 視需要捲動畫面，按一下 [通道與容器管理] 連結。
    6. 向下捲動到通道標題，按一下 [新增] 。
    7. 在 [通道名稱] 欄位中，鍵入新通道的網站名稱。例如 SunOneMailSSLChannel。
    8. 在 [提供者] 下拉功能表中，選取 MailProvider。
    9. 按一下 [確定]，如此會返回 [通道與容器管理] 網頁，其中包含您剛建立好的通道。
    10. 向下捲動至通道標題，按一下您新建的通道名稱旁之 [編輯屬性]；在本範例中，此新建的通道名為 SunOneMailSSLChannel。
    11. 向下捲動到標題欄位，選取並刪除任何目前存在的文字，例如 mail，然後鍵入提供者標題。名稱舉例如 SSL Mail Account。
    12. 在描述欄位中，選取並刪除任何目前存在的文字，例如 mail，然後鍵入提供者描述。在此使用與前項子步驟相同的標題來表示提供者描述：SSL Mail Account。
    13. 向下捲動頁面，選取並刪除 [SSO 配接卡] 欄位中的任何文字，例如 sunOneMail，然後鍵入步驟 5 中使用的同一 SSO 配接卡配置名稱，亦即本範例中的 sunOneMailSSL。
    14. 向下捲動並按一下 [儲存]。
    15. 向上捲動頁面，按一下 top，亦即 Container Path 後接的第一個項目。
    16. 向下捲動到 [容器通道] 標題，按一下您要用來加入新通道的容器連結。例如 MyFrontPageTabPanelContainer。請勿點選旁邊的 [編輯屬性] 連結。
    17. 向下捲動到 [通道管理] 標題，視需要在 [現有通道] 框架中捲動，按一下您新建的通道名稱將之選取。

      18. 請記住，本範例的通道名稱是 SunOneMailSSLChannel。

    18. 按一下 [可用] 與 [可視] 清單旁的 [新增] 按鈕。

      19. 如此即可讓使用者看見並使用此通道，無需再做任何配置。

    19. 向上捲動頁面，按一下 [通道管理] 標題下的 [儲存]。

      20. 現在您應該可以登入並使用 HTTPS 啟用型傳訊伺服器。



上一頁      目錄      索引      下一頁     

Copyright 2004 Sun Microsystems, Inc. 版權所有。