Sun Java System Messaging Server 6.3 管理指南

6.1.2 配置 Messaging Server 以支援 SSO

四個 configutil 參數支援 Messaging Server SSO。這四個參數中,僅 local.webmail.sso.amnamingurl 是啟用 Messaging Server SSO 所必需的。若要啟用 SSO,請將此參數設定為 Access Manager 在其中執行命名服務的 URL。通常此 URL 為 http://server/amserver/namingservice。範例:


configutil -o local.webmail.sso.amnamingurl -v 
http://sca-walnut:88/amserver/namingservice

備註 –

Access Manager SSO 不會查看啟用較舊 SSO 機制的 local.webmail.sso.enablelocal.webmail.sso.enable 應保持 off 或未設定狀態;否則,將記錄警告訊息,表示缺少啟用舊 SSO 機制所需的配置參數。


您可以透過使用 configutil 指令修改 SSO 配置參數,如表 6–3 中所示。

表 6–1 Access Manager 單次登入參數

參數 

說明 

local.webmail.sso.amnamingurl

Access Manager 執行命名服務的 URL。用於透過 Access Manager 單次登入的強制變數。通常此 URL 為 http://server/amserver/namingservice

預設值:未設定。 

local.webmail.sso.amcookiename

Access Manager cookie 名稱。依預設,Access Manager 在名為 iPlanetDirectoryPro 的 cookie 中儲存其階段作業控點。如果配置使用其他 cookie 名稱,則該名稱需要在 Messaging Server 中做為此參數進行配置,以便 Messaging Server 瞭解執行單次登入時要查詢的內容。如果 IS 具有預設配置,則不得變更預設值。

預設值:iPlanetDirectoryPro

local.webmail.sso.amloglevel

AMSDK 記錄層級。Messaging Server 使用的 SSO 程式庫有其自己的記錄機制,與 Messaging Server 中的機制不同。此程式庫的訊息記錄在 msg-svr-base/log 下名為 http_sso 的檔案中。依預設,僅記錄 info 或更高層級的訊息,但可以透過將記錄層級設定為 1 至 5 (1 = errors、2 = warnings、3 = info、4 = debug、5 = maxdebug) 之間的值,來提高記錄層級。請注意,該程式庫與 Messaging Server 的訊息重要性概念不同,且將層級設定為 debug 會導致產生大量無意義的資料。另外,http_sso 記錄檔不由一般 Messaging Server 記錄代碼管理,且永遠不會被清除或自動重建。當設定的記錄層級高於預設層級時,系統管理員應負責清除此記錄檔。

預設值:3 

local.webmail.sso.singlesignoff

從 Messaging Server 單次登出至 Access Manager。Access Manager 是中央認證機構,且單次登出總是從 Access Manager 啟用至 Messaging Server。此選項可讓網站配置 Webmail 中的 [登出] 按鈕是否還讓使用者登出 Access Manager (同時儲存某些自訂工作)。依預設,此選項已啟用。如果此選項已停用,則登出預設 Webmail 用戶端的使用者將自動登回,因為只要 Access Manager cookie 存在並有效,登出就將參考根文件,而根文件將參考收件匣顯示。因此,選擇停用此選項的網站需要自訂登出 Webmail 時的動作。 

預設值:是