test

Sun Java System Communications Express 6 2005Q4 管理指南

設定 Access Manager 單次登入

本節提供有關如何設定 Communications Express 和 Messenger Express 以便使用 Access Manager 單次登入相互通訊的資訊。

如果您已經選擇將 Sun Java System LDAP Schema v.2 用做模式模型，則需要在 Communications Express 中啟用 Access Manager，以使用 Access Manager 的單次登入機制，從而獲取有效的使用者階段作業。

若要讓 Communication Express 使用者使用 Access Manager 單次登入存取 Messenger Express 提供的郵件模組，則需要使用 msg-svr_install_root/sbin /configutil 中的 configutil 工具來修改 Messenger Express 特定參數。由於安裝程式不會設定 Messenger Express 特定參數，因此請務必在安裝後明確設定這些參數。如需有關使用 configutil 工具的更多資訊，請參閱「Sun Java System Messaging Server 管理指南」第 4 章「配置一般郵件傳送功能」。

設定 Access Manager 單次登入時，可以在相同的或不同的 Web 容器實例中，以 SSL 和非 SSL 模式均可以部署 Communications Express 和 Access Manager。在不同的 Web 容器實例中部署 Access Manager 和 Communications Express 時，您需要在部署 Communications Express 的系統上配置 Access Manager 遠端 SDK。下面列出的是在不同 Web 容器實例中，以 SSL 和非 SSL 模式部署 Access Manager 和 Communications Express 之部署分析藍本。

Procedure在具有 Access Manager 的 Communications Express 中啟用單次登入

步驟

  1. 開啟 uwc-deployed-path/WEB-INF/config/uwcauth.properties 檔案。

  2. 在 uwcauth.properties 檔案中修改下列 Communications Express 參數，以啟用 Access Manager 單次登入。

    參數 

    用途 

    uwcauth.identity.enabled

    指定是否啟用 Access Manager。 

    最初在配置程式中設定值。 

    將屬性設定為 true，可啟用 Access Manager。

    將屬性設定為 false，可停用 Access Manager。

    uwcauth.identity.login.url

    指定 Access Manager 登入 URL 的參數。 

    例如，uwcauth.identity.login.url= http://siroe.example.com:85 /amserver/UI/login。

    uwcauth.identity.cookiename 

    指定 Access Manager 使用的 cookie 名稱。 

    uwcauth.identity.cookiename 的值應該與 Access Manager 配置程式中指定的值相對應。

    Access Manager 使用的預設 cookie 名稱是 iPlanetDirectoryPro。

    uwcauth.identity.binddn 

    指定 amadmin 的完整 DN。 

    例如， 

    uid=amAdmin, ou=People, o=siroe.example.com, o=example.com。

    備註：uwcauth.identity.binddn 和 uwcauth.identity.bindcred 值應該與安裝 Access Manager 時輸入的值相對應。

    例如，uwcauth.identity.binddn=uid=amAdmin, ou=People, o=siroe.example.com, o=example.com 和 uwcauth.identity.bindcred=password。

    uwcauth.identity.bindcred 

    指定 amadmin 的密碼。 

    uwcauth.http.port 

    指定於非 SSL 連接埠上配置 Communications Express 時，Communications Express 偵聽的連接埠號碼。 

    預設連接埠號碼是 80。

    uwcauth.https.port 

    指定於 SSL 連接埠上配置 Communications Express 時，Communications Express 偵聽的 HTTPS 連接埠號碼。 

    預設 HTTPS 連接埠號碼是 443。

    identitysso.singlesignoff 

    指定單次登出狀態。 

    如果設定為 true，則在使用者登出時會完全損毀 Access Manager 階段作業，並且參與該 Access Manager 階段作業的所有應用程式都會登出。

    如果設定為 false，則僅會損毀 Communications Express 階段作業，並且使用者將進入在 identitysso.portalurl 中配置的 URL。

    預設狀態是 true。

    identitysso.portalurl 

    指定要將 Communications Express 重新導向至的 URL。 

    如果啟用了 Access Manager 並將單次登出設定為 false，則會將 Communications Express 重新導向至指定給 identitysso.portalurl 的 URL。

    依預設，Communications Express 將被重新導向至 http://www.sun.com。

  3. 設定 Communications Express 進行 Access Manager 單次登入時，將參數 uwcauth.messagingsso.enable 的值設定為 false。

    Communications Express 現在即可使用 Access Manager 的單次登入機制，獲取有效的使用者階段作業。

Procedure在相同的 Web 容器實例中部署 Access Manager 和 Communications Express

步驟

  1. 開啟 IS-SDK-BASEDIR/lib/AMConfig.properties 檔案。

    /opt/SUNWam/lib 即是 IS-SDK-BASEDIR 的範例。

  2. 確定在 AMConfig.properties 檔案中設定了下列特性：

    com.iplanet.am.jssproxy.trustAllServerCerts=true

    AMConfig.properties 位於 IS-SDK-BASEDIR/lib

    例如，/opt/SUNWam/lib。

  3. 重新啟動 Web 容器，使變更生效。

    在相同的 Web 容器實例中以 SSL 模式部署的 Access Manager 和 Communications Express，現在即可使用 Access Manager 的單次登入機制，以獲取有效的使用者階段作業。

Procedure在不同的 Web 容器實例中部署 Access Manager 和 Communications Express

步驟

  1. 變更至 IS-INSTALL-DIR/bin

  2. 複製 Access Manager IS-INSTALL-DIR/bin/amsamplesilent 檔案。

    cp amsamplesilent amsamplesilent.uwc

  3. 編輯在上一步中建立的 amsamplesilent 副本。

    設定參數，以對應部署的詳細資訊。

    如果您要在 Web 容器 (例如 Sun Java System Web Server 或 Sun Java System Application Server) 中部署 Access Manager SDK，則請將 DEPLOY_LEVEL 設定為值 4，亦即選取「僅使用容器配置 SDK」選項。

  4. 將 AM_ENC_PWD 設定為在 Access Manager 安裝過程中使用的密碼加密金鑰值。

    加密金鑰儲存在參數 am.encryption.pwd 中，該參數位於：

    ${IS_INSTALL_DIR}/lib/AMConfig.properties

  5. 將 NEW_INSTANCE 設定為 true。

  6. 如果您要在 Sun Java System Web Server 中部署 Access Manager SDK，則請將 WEB_CONTAINER 設定為 WS6。

    如果您要在 Sun Java System Application Server 中部署 Access Manager SDK，則請將 WEB_CONTAINER 設定為 AS7 或 AS8。

  7. 如需有關 amsamplesilent 檔案中其他參數的更多詳細說明，以及有助於配置 Access Manager 遠端 SDK 參數的更多詳細說明，請參閱「Sun Java System Identity Server 管理指南」第 1 章「Identity Server 2004Q2 配置程序檔」。

  8. 在 Web 容器中配置 Access Manager SDK。

    確定 Access Manager 使用的 Directory Server 正在執行。

  9. 啟動將要部署 Access Manager SDK 的 Web 容器實例。

  10. 變更至 IS-INSTALL-DIR/bin。

  11. 執行下列指令：

    ./amconfig -s amsamplesilent.uwc

  12. 重新啟動 Web 容器實例，使配置生效。.

    在不同的 Web 容器實例中以 SSL 和非 SSL 模式部署的 Access Manager 和 Communications Express，現在即可使用 Access Manager 的單次登入機制，以獲取有效的使用者階段作業。

    備註 –

    請參閱調校 Communications Express，以取得有關部署 Communications Express 後啟用或停用 Access Manager 的說明。

Procedure在具有 Access Manager 的 Messenger Express 中啟用單次登入

步驟

  1. 執行 configutil 工具。

    msg-svr_install_root /sbin/configutil

    如果您已經將 Messenger Express 部署為 MEM，請確保 Messaging Server 中的下列參數值與 mshttpd (Messaging Server 的元件，位於 Messaging Server 的後端；MEM 位於 Messaging Server 的前端) 上的值相同：

    • local.webmail.sso.uwclogouturl

      • local.webmail.sso.uwchome

      • local.webmail.sso.uwcenabled

      • local.webmail.sso.uwcport

      • local.webmail.sso.singlesignoff

      • local.webmail.sso.uwccontexturi

      • local.webmail.sso.amcookiename

      • local.webmail.sso.amnamingurl

  2. 設定下列 Messenger Express 參數，讓 Communication Express 使用者能夠使用 Access Manager 單次登入存取 Messenger Express。

    參數 

    用途 

    local.webmail.sso.amnamingurl

    此配置可從 Access Manager 啟用單次登入。 

    參數應指向 Access Manager 執行命名服務的 URL。 

    例如，

    configutil -o local.webmail.sso.amnamingurl -v http://siroe.example.com:85 /amserver/namingservice

    local.webmail.sso.uwcenabled

    啟用 Communications Express 存取 Messenger Express。 

    若要停用，請將參數設定成 0。 

    local.webmail.sso.uwclogouturl

    指定 Messenger Express 用來使 Communications Express 階段作業失效的 URL。 

    如果您已經在 Messenger Express 中明確配置了 local.webmail.sso.uwclogouturl，則該值將用於登出。否則，Messenger Express 會根據請求標題中的 HTTP 主機來建構登出 URL。

    例如， 

    http://siroe.example.com:85/base/UWCmain?op=logout 

    如果未將 Communications Express 部署在 / 之下 (如 /uwc)，則此參數的值可能會顯示如下：

    http://siroe.example.com:85/uwc /base/UWCmain?op=logout

    local.webmail.sso.uwcport

    指定 Communications Express 的連接埠。 

    例如，85。 

    local.webmail.sso.uwccontexturi 

    指定部署 Communications Express 的 URI 路徑。 

    僅當未將 Communications Express 部署在 / 之下時，才應指定這個參數。

    例如，如果在 /uwc 中部署了 Communications Express，則 local.webmail.sso.uwccontexturi=uwc

    local.webmail.sso.amcookiename 

    指定 Access Manager 階段作業 cookie 名稱。 

    確保在 uwcauth.properties 檔案中，將 uwcauth.identity.cookiename 的值設定為 local.webmail.sso.amcookiename 的值。

    例如，iPlanetDirectoryPro

    local.webmail.sso.uwchome 

    指定存取首頁連結所需要的 URL。 

    一旦設定了 Messenger Express 特定參數，Communication Express 使用者就可以使用 Access Manager 單次登入來存取 Messenger Express。