附錄 A iim.conf 中的 Instant Messaging 配置參數 描述您可為 Instant Messaging 元件配置的設定。
附錄 Bhttpbind.conf 中的 Instant Messaging XMPP/HTTP 閘道配置參數 描述您可為 XMPP/HTTP 閘道 配置的設定。
附錄 CInstant Messaging imadmin 工具參考 描述用於管理 Instant Messaging 的 imadmin 指令。
附錄 DInstant Messaging API 提供 Instant Messaging 所使用的 API 簡介。
附錄 EInstant Messaging LDAP 模式 定義為 Instant Messaging 的 LDAP 模式所做的修改。
本章在以下幾節說明 iim.conf 檔案中的 Instant Messaging 配置參數:
Instant Messaging 將配置設定儲存在配置目錄 (im-cfg-base) 的 iim.conf 檔案中。
Solaris:
/etc/opt/SUNWiim/default/config/iim.conf
Linux:
/etc/opt/sun/im/default/config/iim.conf
如果您已建立多個 Instant Messaging 實例,則 /default 目錄的名稱會根據實例而有所不同。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例。
此檔案是 ASCII 純文字檔案,其中每一行均定義一個伺服器參數及其值:
參數及其值是由等號 (=) 分隔,等號之前或之後可以包含空格與定位字元。
數值可以用雙引號 (" ") 括起。如果參數允許多值,則必須將整個值字串用雙引號括起。
註釋行必須要以驚嘆號 (!) 作為一行的第一個字元。註釋行是作為提供資訊之用,而且會被伺服器所忽略。
如果參數出現不只一次,則列出的最後參數值將會覆蓋先前的值。
反斜線 (\) 是用於接續後面內容,並指出值的內容超過一行。
每行會終止於行終止符號 (\n、\r 或 \r\n)。
鍵由行中第一個非空格字元開始到第一個 ASCII 等號 (=) 或分號 (;) 為止的所有字元組成。 如果該鍵以分號結束,則鍵之後會接著「lang-」和指定解譯此值所使用語言的標記。語言標籤後面會接著等號 (=)。所有等號之前或之後的空白字元將會被忽略。行中所有剩餘的字元將會變為相關值字串的一部份。
值字串中的多重值以逗號 (,) 分隔。
如果值內有任何特殊字元,如逗號、空格、換行、定位字元、雙引號或反斜線,那麼整個值必須前後加上雙引號。此外,每個值中的換行鍵、返回字元、定位字元、反斜線和雙引號必須以反斜線 (\) 指定。
如果您變更了 iim.conf 檔案,則必須更新 Instant Messaging 伺服器才能使新的配置設定生效。
iim.conf 檔案會由安裝程序初始化,而且只能夠依照本手冊所述的方法加以修改。
表 A–1 列出並描述一般配置參數。
表 A–1 一般配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim.comm.modules |
iim_server、iim_mux |
使用通訊模組。可能的值為 iim_server 與 iim_mux。預設值為 iim_server, iim_mux,表示同時使用伺服器與多重訊號組合器。iim_mux 值適用於多重訊號組合器。 |
iim.smtpserver |
localhost |
將郵件傳送到一般使用者的 SMTP 伺服器,這些一般使用者已設定選項將其訊息以電子郵件轉寄或將訊息轉寄至呼叫器。 |
iim.instancedir |
/opt |
安裝目錄根。 |
iim.instancevardir |
Solaris:/var/opt/SUNWiim/default Linux:/var/opt/sun/im/default |
將目錄設定為包含執行階段檔案,包括一般使用者設定檔資料庫、記錄和伺服器與多重訊號組合器在執行階段建立的其他檔案。如果您建立了多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。 |
iim.user |
inetuser 用於 LDAP 部署。 root 用於入口網站部署。 |
伺服器程序執行的一般使用者名稱。 |
iim.group |
inetgroup 用於 LDAP 部署。 root 用於入口網站部署。 |
伺服器程序執行時所使用的群組。 |
iim.jvm.maxmemorysize |
256 |
允許執行伺服器的 JVM 所使用的最大堆疊大小,單位為 MB。用於建構 Java 指令的 -mx 引數。 |
iim.mail.charset |
無 |
此參數指定郵件的標頭是否為 ASCII 格式且未經過編碼。 參數中包含用於對離線警示郵件訊息標頭進行編碼的字元集的名稱。 例如:iim.mail.charset=iso-2022-jp |
iim.jvm.command |
/usr/j2se/bin/java |
Java Runtime Executable (JRE) 的位置。 |
iim.identity.basedir |
/opt |
Sun JavaTM System Access Manager 的預設安裝目錄,也稱做基底目錄。 |
iim.identity.jre |
/usr/java_1.3.1_04 |
JRE 的位置,Access Manager 使用此 JRE 執行其所有程序。 |
iim.portal.deployuri |
/portal |
用於在 Access Manager 中部署 Portal Server war 檔案的 URI。 |
iim.portal.host |
imhostname |
執行 Portal Server 的伺服器主機名稱。如果使用非預設的連接埠號碼時,指定連接埠號碼。 |
iim.portal.protocol |
http |
用於存取 Portal Server 的通訊協定。 |
iim.policy.cache.validity |
10 |
定義單一使用者訊息的快取有效間隔 (單位為分鐘)。 Instant Messaging 伺服器儲存上次快取單一一般使用者資訊的日期。如果在由此參數決定的間隔之後存取一般使用者的資訊,伺服器將重新快取一般使用者的資訊,並重設 LocalUser 物件的快取日期。 |
iim.policy.modules |
iim_ldap |
依據預設,使用 LDAP 進行策略儲存。將值變更為 identity,則表示使用 Sun Java System Access Manager 進行策略儲存。 |
iim.policy.resynctime |
720 |
定義所有一般使用者資訊的快取有效間隔 (單位為分鐘)。 Instant Messaging 伺服器會定期清除所有快取的一般使用者資訊,以便移除舊有的一般使用者資訊。此參數指定清除所快取一般使用資訊的頻率。 |
iim.userprops.store |
file |
依據預設,當您執行 configure 公用程式時,如果您選擇不使用 Access Manager 進行策略儲存,那麼使用者特性會儲存在使用者特性檔案中。如果您選擇使用 Access Manager 進行策略儲存,則預設值為 ldap。變更值即會變更使用者特性的儲存位置。如果您將此值從 file 變更為 ldap,則必須執行 imadmin assign_services,以將必要的物件類別增加至目錄中的使用者項目。 此參數只有在已安裝線上狀態和 Instant Messaging 服務的服務定義時才有意義。 |
表 A–2 列出並描述 Instant Messaging 在 LDAP、使用者註冊和使用者來源配置中所使用的參數。
表 A–2 LDAP、使用者註冊和來源配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim_ldap.host |
localhost:389 |
Instant Messaging 伺服器進行一般使用者認證所使用的 LDAP 伺服器名稱與連接埠。 |
iim_ldap.searchbase |
o=internet |
用作在 LDAP 伺服器上搜尋一般使用者和群組之基礎的字串。 |
iim_ldap.usergroupbinddn |
無 (伺服器執行匿名搜尋) |
指定用於連結 LDAP 伺服器以進行搜尋的 DN。 |
iim_ldap.usergroupbindcred |
無 (伺服器執行匿名搜尋) |
指定與 iim_ldap.usergroupbinddn DN 一起使用以進行 LDAP 搜尋的密碼。 |
iim_ldap.loginfilter |
(&(|(objectclass=inetorgperson)(objectclass=webtopuser))(uid={0})) |
一般使用者登入期間使用的搜尋篩選器。整個篩選器作為一行輸入。 |
iim_ldap.usergroupbyidsearchfilter |
(|(&(objectclass=groupofuniquenames)(uid={0}))(&(|(objectclass=inetorgperson)(objectclass=webtopuser))(uid={0}))) |
用於在由 ID 指定的基礎下搜尋目錄中的一般使用者和群組的搜尋篩選器。整個篩選器作為一行輸入。 |
iim_ldap.usergroupbynamesearchfilter |
(|(&(objectclass=groupofuniquenames)(cn={0})) (&(|(objectclass=inetorgperson)(objectclass=webtopuser))(cn={0}))) |
用於在由名稱指定的基礎下搜尋目錄中的一般使用者和群組的搜尋篩選器。 |
iim_ldap.allowwildcardinuid |
False |
判定當執行搜尋時,是否應為 UID 啟用萬用字元。由於多數的目錄安裝都指明 UID 僅進行精確搜尋,因此預設值為 False。除非將 UID 指定為進行子字串搜尋,否則將此值設定為 True 可能會影響效能。 |
iim_ldap.userclass |
inetOrgPerson,webtopuser |
用於指定項目屬於某個一般使用者的 LDAP 類別。 |
iim_ldap.groupclass |
groupOfUniqueNames |
用於指定項目屬於某個群組的 LDAP 類別。 |
iim_ldap.groupbrowsefilter |
(objectclass=groupofuniquenames) |
用於在指定搜尋庫下瀏覽目錄中所有群組的搜尋篩選器。 |
iim_ldap.searchlimit |
40 |
搜尋所傳回的輸入項目的最大值。-1 表示搜尋已在此伺服器上停用,0 則表示未限制的搜尋。 |
iim_ldap.userdisplay |
cn |
用於顯示一般使用者名稱的 LDAP 屬性。 |
iim_ldap.groupdisplay |
cn |
用於顯示群組名稱的 LDAP 屬性。 |
im_ldap.useruidattr |
uid |
用作一般使用者的 UID 的 LDAP 屬性。 |
im_ldap.groupmemberattr |
uniquemember |
提供群組成員清單的 LDAP 屬性。 |
iim_ldap.usermailattr |
|
包含一般使用者佈建的電子郵件地址的 LDAP 屬性。電子郵件傳送給離線一般使用者時使用。 |
iim_ldap.userattributes |
無 |
包含 LDAP 使用者項目的自訂屬性清單的 LDAP 屬性。 |
iim_ldap.groupattributes |
無 |
包含 LDAP 群組項目的自訂屬性清單的 LDAP 屬性。 |
iim_ldap.groupmemberurlattr |
無 |
動態群組的成員身份屬性,包含 LDAP 篩選器或 LDAP URL。 |
iim_ldap.useidentityadmin |
當您執行 configure 公用程式時,如果您選擇針對策略使用 Access Manager 部署,則預設值為 true。否則,預設值為 false。 |
如果值為 true,則 Access Manager 管理員憑證將會用來連結 Directory Server。 |
iim.register.enable |
無 |
如果為 TRUE,則伺服器允許新的 Instant Messaging 一般使用者使用 Instant Messenger 進行註冊 (將自己增加至目錄)。 |
iim_ldap.register.basedn |
無 |
如果啟動自我註冊功能,則此參數值為 LDAP 目錄中人員項目儲存位置的 DN。例如: "ou=people,dc=siroe,dc=com" |
iim_ldap.register.domain |
無 |
將在其中增加新使用者的網域。例如,directory.siroe.com。 |
表 A–3 列出並描述 log4j 式記錄和 iim.conf 參數式記錄的記錄配置參數。
表 A–3 記錄配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim.log.iim_server.severity |
INFO |
伺服器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log.iim_server.url |
im-runtime-base/log/xmppd.log |
伺服器記錄檔案的位置。必須定期刪除此檔案的內容,以免佔滿磁碟空間。 |
iim.log.iim_mux.severity |
INFO |
多重訊號組合器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log.iim_mux.url |
im-runtime-base/log/mux.log |
多重訊號組合器記錄檔的位置。必須定期刪除此檔案的內容,以免佔滿磁碟空間。 |
iim.log.iim_mux.maxlogfiles |
10 |
儲存的多重訊號組合器記錄檔的最大檔案數。一旦超過此數字,則刪除最舊的多重訊號組合器記錄檔。 |
iim.log.iim_mux.maxlogfilesize |
10 MB |
此參數包含了多重訊號組合器記錄檔大小的最大值。如果記錄檔超過此參數中所指定的大小,便會建立新的記錄檔。 |
iim.log.iim_server.maxlogsize |
此參數包含了伺服器記錄檔大小的最大值。如果記錄檔超過此參數中所指定的大小,便會建立新的記錄檔。 |
|
iim.log.iim_wd.severity |
INFO |
監視程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log.agent-calendar.severity |
INFO |
行事曆代理程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、 WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log4j.config |
im-cfg-base |
指定 log4j 配置檔案的位置和名稱。如果此參數沒有值,則記錄程式將在 im-cfg-base 中尋找 log4j.conf 。 如果記錄程式在 im-cfg-base 中找不到 log4j.conf,則會使用參數式的記錄方法來替代 log4j。 |
表 A–4 列出並描述 Instant Messaging 伺服器配置參數。
表 A–4 一般 Instant Messaging 伺服器配置參數
參數 |
預設值 |
說明 |
|
---|---|---|---|
iim_server.autosubscribe |
FALSE |
表示伺服器是否自動授權訂閱。可能的值為 TRUE 和 FALSE。若為 TRUE,訂閱請求後面會自動跟有伺服器產生的訂閱回應。然後伺服器將已修改的值勤人傳送至訂閱者和訂閱者新增為連絡人的使用者。若要使用此功能,使用者與連絡人必須位於相同的網域。 |
|
iim_server.domainname |
主機的網域名稱 |
您希望此伺服器支援的邏輯 Instant Messaging 伺服器網域名稱。此為網路中其他伺服器用以識別此伺服器的名稱。它同時也是此伺服器用來讓其他伺服器識別其一般使用者時所使用的名稱。此名稱不一定是執行 Instant Messaging 伺服器之系統的完全合格網域名稱。 例如,如果系統 iim.xyz.com 是 xyz.com 公司唯一的 Instant Messaging 伺服器,則網域名稱有可能會是 xyz.com。 |
|
iim_server.port |
5269 |
伺服器所連結的 IP 位址和連接埠,伺服器也從此偵聽來自其他伺服務的連線。對於多址主機而言,如果您只需要使用一個特定的 IP 位址,則 IP 位址設定非常有用。如果未列出 IP 位址,它將表示 localhost 上的 INADDR_ANY 值。 |
|
iim_server.useport |
TRUE |
表示伺服器是否在伺服器對伺服器通訊埠上偵聽。可能的值為 TRUE 和 FALSE。如果為 TRUE,則伺服器會在 iim_server.port 所定義的連接埠上進行偵聽,或是在連接埠 5269 上偵聽 (如果未明確定義)。 |
|
iim_server.clienttimeout |
15 |
指定伺服器捨棄不在使用中的用戶端連線之前所等待的時間間隔 (單位為分鐘)。例如,當機器關閉時。可接受的最小值為 5。 |
|
iim_server.usesso |
當您執行 configure 公用程式時,如果您選擇針對 SSO 使用 Access Manager 部署,則預設值為 1。否則,預設值為 0。 |
此參數可指示伺服器在認證期間是否依靠 SSO 提供者。SSO 提供者是伺服器用來透過 SSO 服務驗證階段作業 ID 的模組。 Instant Messaging 伺服器能夠使用 Access Manager Session API 驗證由用戶端傳送的階段作業 ID。 此參數的值可以是 0、1 或 -1。 0 - 不使用 SSO 提供者。 1 - 先使用 SSO 提供者,如果 SSO 驗證失敗,則預設為 LDAP。 -1 - 僅使用 SSO 提供者而不嘗試 LDAP 認證 (即使 SSO 驗證失敗)。 iim_server.usesso 參數與 iim_server.ssoprovider 參數配合使用。 |
|
iim_server.ssoprovider |
無 |
指定實作 com.sun.im.provider.SSOProvider 介面的類別。如果 iim_server.usesso 不等於 0,且未設定此選項,則伺服器會使用預設的基於 Access Manager 的 SSO 提供者。 |
|
iim.policy.modules |
當您執行 configure 公用程式時,如果您選擇針對策略使用 Access Manager 部署,則預設值為 identity。否則,預設值為 iim_ldap。 |
如果值為 identity,則表示使用 Sun Java System Access Manager 進行策略儲存。如果值為 iim_ldap,則表示使用目錄進行儲存。 |
|
iim.userprops.store |
file |
如果值為 file,則表示使用者特性會儲存在使用者特性檔案中。如果值為 ldap,則表示使用目錄進行儲存。 |
|
iim_server.msg_archive |
false |
此參數會指定歸檔提供者是否應該啟用或停用。將此值設定為 false 可停用所有歸檔。將此值設定為 true 則可啟用所有歸檔,包括 Portal、電子郵件和您要使用的自訂歸檔提供者。 |
|
iim_server.msg_archive.provider |
無 |
此參數包含歸檔提供者的清單。此參數允許多值,而每個值是以逗號 (,) 分隔。 如果您使用 Portal Server Search 式歸檔,則值應為 com.iplanet.im.server.IMPSArchive。如果您使用電子郵件歸檔,則值應為 com.iplanet.im.server.EmailIMArchive。 |
|
iim_server.conversion |
false |
此參數會指定是否應當啟用訊息轉換。它指定「訊息轉換提供者」配置清單是否應該用於訊息轉換。 |
|
iim_server.conversion.provider |
無 |
此參數包含用於訊息轉換之「訊息轉換提供者」清單。 此參數允許多值,而每個值是以逗號 (,) 分隔。 |
|
iim_server.servertimeout |
-1 |
伺服器可配置為:在遠端伺服器處於非使用中狀態時自動關閉由遠端伺服器開啟的連線。這個動作可以透過定期計算遠端伺服器最後請求伺服器的時間來執行。如果遠端伺服器最後請求的時間超過 iim_server.servertimeout 參數值,與遠端伺服器的連線將會終止。 參數值以分鐘計算。 |
|
iim_server.enable |
true |
此值定義是否啟用 Instant Messaging 伺服器。如果此參數設定為 false,則會啟用 Instant Messaging 多重訊號組合器。 |
|
iim_server.conversion.external.command |
無 |
此參數包含用於訊息轉換的外部指令。 |
|
iim_server.stat_frequency |
1 |
此參數包含伺服器將活動摘要記錄至記錄檔中的頻率。只有在伺服器最低記錄嚴重性設定為 INFO 或更低,伺服器才會將活動的摘要記錄到記錄檔。此值以分鐘為單位。 |
|
iim_server.certnickname |
Server-Cert |
此值應該包含您在安裝憑證時所輸入的憑證名稱。 此憑證名稱區分大小寫。 |
|
iim_server.sslkeystore |
無 |
包含伺服器的 Java 金鑰庫 (JKS) 的相對路徑和檔案名稱。例如:
|
|
iim_server.keystorepasswordfile |
sslpassword.conf |
此值應該包含其中含有金鑰資料庫密碼之檔案的相對路徑和名稱。此檔案應該包含下列指令行: Internal (Software) Token:password 其中 password 是保護金鑰資料庫的密碼。 |
|
iim_server.requiressl |
false |
如果為 true,則伺服器會終止在設定初始串流階段作業後沒有請求 TLS 連線的任何連線。連線可來自用戶端、其他伺服器和伺服器元件,如 XMPP/HTTP 閘道和代理程式,但多重訊號組合器除外。 |
|
iim_server.trust_all_cert |
false |
如果此值為 true,則伺服器會信任所有憑證,也會將憑證資訊新增到記錄檔。 |
為了使網路中的多重 Instant Messaging 伺服器之間能夠彼此通訊,您需要將您的伺服器配置為使本身能夠與將會與其連線的其他伺服器、每個協同伺服器或是協作伺服器協調一致。協同伺服器可利用其 Instant Messaging 網域名稱、主機和連接埠號碼、伺服器 ID 以及密碼識別本身的身份。
將會提供每個協作伺服器一個符號名稱,而該名稱是由字母與數字組成的字串,例如 coserver1。 使用您可以指定多重伺服器的符號命名慣例。
當以此方式配置 Instant Messaging 伺服器時,您可以形成較大的 Instant Messaging 社群。因此,每個伺服器上的一般使用者可執行以下作業:
與所有其他伺服器上的一般使用者通訊
使用其他伺服器上的會議室
訂閱其他伺服器上的新聞通道 (取決於存取權限)
表 A–5 列出並描述多重伺服器配置參數。
表 A–5 多重伺服器配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim_server.serverid |
無 |
此伺服器用來識別本身給所有其他伺服器的字串。 |
iim_server.password |
無 |
此伺服器用來認證其本身給所有其他伺服器的密碼。 |
iim_server.coservers |
無 |
包含可與此伺服器連線的伺服器符號名稱的清單,其中以逗號分隔。允許任何有意義的名稱,但是名稱必須符合您在 *.serverid、*.password 和 *.host 參數中所使用的名稱。 範例: iim_server.coservers=coserver1,coserver2 或 iim_server.coservers=abc,xyz,ntc |
iim_server.coserver1 .serverid |
無 |
名稱 coserver1 所代表的協作伺服器用來認證此伺服器的識別字串。例如,如果您在 iim_server.coservers 清單中使用 abc,則其 serverid 的相對名稱將會是 iim_server.abc.serverid。 |
iim_server.coserver1 .password |
無 |
名稱 coserver1 所代表的協作伺服器用來認證此伺服器的密碼。例如,如果您在 iim_server.coservers 清單中使用 abc,則其密碼的相對名稱將會是 iim_server.abc.password。 |
iim_server.coserver1 .host |
無 |
要連線的 IP 位址與連接埠,可供此伺服器上的一般使用者與名稱 coserver1 所代表的伺服器上的一般使用者通訊。 例如,如果您在 iim_server.coservers 清單中使用 abc,則其主機的相對名稱將會是 iim_server.abc.host。 格式為 name: port 或 IPaddress: port。 |
iim_server.coserver1 .requiressl |
False |
表示當與由 coserver1 識別的伺服器通訊時,此伺服器是否應需要 TLS。可能的值為 TRUE 和 FALSE。 |
表 A–6 列出並描述多重訊號組合器配置參數。
表 A–6 多重訊號組合器配置參數
參數 |
預設值 |
說明 |
|
---|---|---|---|
iim_mux.listenport |
多重訊號組合器名稱或 IP 位址:5222 |
IP 位址或 FQDN 與多重訊號組合器偵聽 Instant Messenger 傳入請求的偵聽連接埠。值格式為 IPaddress:port 或 multiplexorname: port。如果未列出 IP 位址或網域名稱,則參數值假設為 localhost 中的 INADDR_ANY。 如果您變更此值,應同時變更 im.html 和 im.jnlp 檔案,使得它們能夠符合連接埠值。 |
|
iim_mux.serverport |
45222 |
多重訊號組合器與之通訊的 Instant Messaging 伺服器和連接埠。值格式為 servername:port 或 IPaddress: port。 |
|
iim_mux.numinstances |
1 |
多重訊號組合器實例的數量。此參數僅對 Solaris 平台有效。 |
|
iim_mux.maxthreads |
5 |
每個多重訊號組合器實例的最大執行緒數目。 |
|
iim_mux.maxsessions |
2000 |
每個多重訊號組合器程序的最大並行連線數。 |
|
iim_mux.usessl |
off |
如果該值設定為 on,則在交換任何應用程式資料前,多重訊號組合器需要在每個它接受的連線中進行 SSL 訊號交換。 |
|
iim_mux.secconfigdir |
/etc/opt/SUNWiim/default/config |
此目錄包含金鑰和憑證資料庫。此外,它通常也包含安全性模組資料庫。如果您建立多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。 |
|
iim_mux.keydbprefix |
無 |
此值應該包含金鑰資料庫檔名前綴。金鑰資料庫檔名必須以 key3.db 結尾。 如果金鑰資料庫包含前綴,例如,This-Database-key3.db,則此參數的值為 This-Database。 |
|
iim_mux.certdbprefix |
無 |
此值應該包含憑證資料庫檔名前綴。憑證資料庫檔名必須以 cert7.db 結尾。 如果憑證資料庫包含前綴,例如,Secret-stuff-cert7.db,則此參數值為 Secret-stuff。 |
|
iim_mux.secmodfile |
secmod.db |
此值應該包含安全模組檔案的名稱。 |
|
iim_mux.certnickname |
Multiplexor-Cert |
此值應該包含您在安裝憑證時所輸入的憑證名稱。 此憑證名稱區分大小寫。 |
|
iim_mux.keystorepasswordfile |
/etc/opt/SUNWiim/default/config/sslpassword.conf |
此值應該包含其中含有金鑰資料庫密碼之檔案的相對路徑和名稱。此檔案應該包含下列指令行:
其中 password 是保護金鑰資料庫的密碼。 如果您建立多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。 |
|
iim_mux.stat_frequency |
600 |
此值應包含多重訊號組合器將活動摘要記錄至記錄檔中的頻率。最小值為 10 秒。 |
|
iim_mux.enable |
true |
如果值為 true,則多重訊號組合器將為此實例而執行。如果值為 false,則多重訊號組合器將不會為此實例而執行。 |
表 A–7 列出您用來管理 Instant Messaging 重新導向伺服器的參數。
表 A–7 重新導向伺服器參數
參數 |
預設值 |
說明 |
---|---|---|
iim_server.redirect.provider |
無 |
實作 com.sun.im.provider.Redirector 介面的重新導向提供者名稱或類別清單,以逗號分隔。此參數的任何值都會將伺服器實例定義為重新導向伺服器。支援的值包括 db、roundrobin、regex,以及實作 com.sun.im.provider.Redirector 介面的類別名稱。 |
iim_server.redirect.to |
無 |
此重新導向伺服器會將用戶端連線重新導往的節點的清單,以逗號分隔。節點名稱可以是任何字母數字式字串。此清單可以是 iim_server.redirect.to.nodename.host 中定義的主機超集合。 |
iim_server.redirect.to.nodename.host |
無 |
其中 nodename 是 iim_server.redirect.to 中的節點名稱。nodename 必須具有此屬性,才能供重新導向伺服器使用。 |
iim_server.redirect.to.nodename.usessl |
False |
如果為 true,則 nodename 被配置為使用舊有 SSL。如需詳細資訊,請參閱在 Instant Messaging 中使用 TLS 與舊有 SSL 的摘要。 |
iim_server.redirect.db.users |
im-db-base/redirect.db |
重新導向資料庫的名稱和位置。 |
iim_server.redirect.db.partitions |
im-cfg-base/redirect.partitions |
重新導向分割區檔案的名稱和位置。 |
iim_server.redirect.db.partitionsize |
5000 |
分割區中使用者的最大數。 |
iim_server.redirect.roundrobin.partitions |
im-cfg-base/redirect.partitions |
重新導向分割區檔案的名稱和位置。 |
iim_server.redirect.pollfrequency |
|
重新導向伺服器與在 redirect.hosts 檔案中定義的主機所建立連線之間的問隔。重新導向伺服器會輪詢這些主機,以判定它們是否在線上,以及是否能夠接受用戶端連線。 |
表 A–8 列出您用來管理 Instant Messaging 歸檔的參數。
表 A–8 歸檔參數
參數 |
預設值 |
說明 |
---|---|---|
iim_arch.title.attr |
Title |
此參數包含等同於 Portal Server Search 之預設模式中 Title 欄位的欄位名稱。 |
iim_arch.keyword.attr |
Keyword |
此參數包含等同於 Portal Server Search 之預設模式中 Keyword 欄位的欄位名稱。 |
iim_arch.readacl.attr |
ReadACL |
此參數包含等同於 Portal Server 搜尋之預設模式中 ReadACL 欄位的欄位名稱。 |
iim_arch.description.attr |
說明 |
此參數包含等同於 Portal Server Search 之預設模式中 Description 欄位的欄位名稱。 |
iim_arch.fulltext.attr |
Full-Text |
此參數包含等同於 Portal Server Search 之預設模式中 Full-text 欄位的欄位名稱。 |
iim_arch.category.attr |
Category |
此參數包含等同於 Portal Server Search 之預設模式中 Category 欄位的欄位名稱。 |
iim_arch.readacl.admin |
無 |
此參數包含管理員 DN。以「;」分隔的多個值。 |
iim_arch.readacl.adminonly |
false |
此參數會包含 true 或 false。 true - 只有參數 iim_arch.readacl.admin 所指定的管理員 DN 會新增至 ReadACL 欄位,而覆寫 ReadACL 欄位的預設運作方式。 false - 參數 iim_arch.readacl.admin 所指定的管理員 DN 會新增至 ReadACL 欄位,以補充預設運作方式。 |
iim_arch.categories |
all |
此參數包含可以歸檔的訊息類型清單。 其值可能是: poll alert chat conference news 指定的多重值可以逗號分隔 (,)。 |
iim_arch.categoryname |
無 |
如果沒有指定任何種類的種類名稱,則會使用此參數值作為種類名稱。 |
iim_arch.alert.categoryname |
無 |
此參數包含含有已歸檔之警示訊息的種類名稱。 不需要指定一個種類給警示訊息。 |
iim_arch.poll.categoryname |
無 |
此參數包含含有已歸檔之輪詢訊息的種類名稱。 不需要指定一個種類給輪詢訊息。 |
iim_arch.conference.categoryname |
無 |
此參數包含含有已歸檔之會議訊息的種類名稱。 不需要指定一個種類給會議訊息。 |
iim_arch.chat.categoryname |
Name |
此參數包含含有已歸檔之聊天訊息的種類名稱。 不需要指定一個種類給聊天訊息。 |
iim_arch.news.categoryname |
無 |
此參數包含含有已歸檔之新聞訊息的種類名稱。 不需要指定一個種類給新聞訊息。 |
iim_arch.conference.quiettime |
5 |
此參數包含空間 (公開和私用) 中兩個連續訊息之間靜音的最長持續時間,超過此時間後 RD 會過期,並會建立一個新的 RD 來歸檔訊息。此值以分鐘為單位。 |
iim_arch.poll.maxwaittime |
15 |
此參數包含輪詢資料在伺服器中緩衝的 (最長) 時間。此值以分鐘為單位。 |
iim_arch.ignoreexplicitdeny |
true |
此參數會包含 true 或 false。 true - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料。每次當不對這些訊息進行歸檔時,會將此資訊記錄到 xmppd.log 檔案中。 false - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料,且會將此訊息新增到 Portal Server Search 資料庫中。 備註:如果您沒有明確拒絕存取空間或新聞通道,則預設存取權限為 READ、WRITE 或 MANAGE。也可授予某些一般使用者 NONE 存取權限。 |
iim_arch.portal.search |
無 |
此參數的值應為 Portal Server Search servlet 的 URL。例如:http://www.example.com/portal/search 如果此參數不存在,則「歸檔提供者」會依照存在於系統上的 AMConfig.properties 檔案,決定 Portal Server Search URL 的值。 |
iim_arch.portal.admindn |
無 |
此參數的值應為管理使用者的 DN 。例如:uid=amadmin,ou=People,o=internet 當 Portal Server Server 中文件層級安全性開啟時,則需要此參數。 |
iim_arch.portal.adminpassword |
無 |
此參數的值應該為管理使用者的密碼 (由 iim_arch.portal.admindn 參數指定)。 當 Portal Search Server 中文件層級安全性開啟時,則需要此參數。 |
iim_arch.portal.search.database |
無 |
此參數的值應為 Instant Messaging 伺服器儲存已歸檔訊息之資料庫的名稱。如果未定義此參數,則所有的訊息會儲存在 Portal Server Search 的預設資料庫中。 |
iim_arch.admin.email |
空字串 |
管理員電子郵件地址的清單,以逗號分隔。 |
iim_arch.alert.admin.email |
無 |
所有已歸檔的警示訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換警示訊息的 iim_arch.admin.email 。 |
iim_arch.chat.admin.email |
無 |
所有已歸檔的聊天訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換聊天訊息的 iim_arch.admin.email 。 |
iim_arch.conference.admin.email |
無 |
所有已歸檔的會議訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換會議訊息的 iim_arch.admin.email 。 |
iim_arch.poll.admin.email |
無 |
所有已歸檔的輪詢訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換輪詢訊息的 iim_arch.admin.email 。 |
iim_arch.news.admin.email |
無 |
所有已歸檔的新聞訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換新聞訊息的 iim_arch.admin.email 。 |
iim_arch.email.archiveheader.name |
無 |
進階 RFC 822 標頭的名稱。 |
iim_arch.email.archiveheader.value |
all |
對應於 iim_arch.email.archiveheader.name 標頭名稱的值。 |
監視程式會監視伺服器程序,若確定伺服器未在執行,則會嘗試重新啟動伺服器。請參閱管理監視程式程序
表 A–9 列出並描述監視程式配置參數。
表 A–9 監視程式配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim_wd.enable |
true |
啟用監視程式功能。若要重設此參數或停用監視程式,應將此值設為 false。 若要避免衝突,如果您正在使用作業系統管理主控台監視 Instant Messaging 伺服器,則應停用該監視程式。 |
iim_wd.period |
300 (秒) |
監視程式會定期輪詢伺服器以檢查伺服器是否正在執行。此參數設定兩個狀態輪詢之間的間隔。 |
iim_wd.maxRetries |
3 |
設定關閉或重新啟動伺服器之前監視程式嘗試聯絡 Instant Messaging 伺服器的次數。最大重試次數為十次。 |
表 A–10 中的參數可配置伺服器如何與 Sun Java Enterprise System Monitoring Framework 互動。
表 A–10 監視參數
參數 |
預設值 |
說明 |
---|---|---|
iim_server.monitor.enable |
false |
供 Sun Java Enterprise System Monitoring Framework 使用。如果為 true,則伺服器配置為允許 mfwk 使用其活動。否則,伺服器不會讓其活動可供使用。 |
iim_server.monitor.htmlport |
無 |
如果有指定,則在指定的連接埠上開啟 JMX HTML 配接卡連接埠。依照預設,此連接埠未啟用,因為開啟此連接埠會帶來安全風險。 |
代理程式 (如行事曆代理程式) 使 Instant Messaging 伺服器的功能得以實現,並能增強其與其他 Sun Java System 伺服器互通的功能。
表 A–11 列出並描述代理程式配置參數。
表 A–11 代理程式配置參數
參數 |
預設值 |
說明 |
---|---|---|
jms.consumers |
無 |
與行事曆代理程式一起使用。包含警示的名稱。此參數的值必須設定為: cal_reminder |
jms.consumer.cal_reminder.destination |
無 |
與行事曆代理程式一起使用。警示目標。這必須和 ics.conf 檔案中 caldb.serveralarms.url 配置參數的值相同。例如, enp:///ics/customalarm |
jms.consumer.cal_reminder.provider |
無 |
與行事曆代理程式一起使用。提供者的名稱。一般而言,這會設定為 ens。此參數的值必須與 jms.providers 參數中的名稱相同。 |
jms.consumer.cal_reminder.type |
無 |
與行事曆代理程式一起使用。要設定的警示類型。此參數的值必須設定為: topic |
jms.consumer.cal_reminder.param |
無 |
與行事曆代理程式一起使用。警示參數。此參數的值必須設定如下 (包括引號): "eventtype=calendar.alarm" |
jms.consumer.cal_reminder.factory |
無 |
與行事曆代理程式一起使用。註冊其本身以使用新行事曆提醒訊息的偵聽者。此參數的值必須設定為: com.iplanet.im.server.JMSCalendarMessageListener |
jms.providers |
無 |
與行事曆代理程式一起使用。提供者的名稱。一般而言,此參數的值設定為 ens。此值必須與 jms.consumer.cal_reminder.provider 參數的值相同。 |
jms.provider.ens.broker |
無 |
與行事曆代理程式一起使用。ENS 的主機名稱和 ENS 偵聽內送請求使用的連接埠號碼。設定為 ics.conf 檔案 service.ens.port 參數中指定的連接埠。預設為 57997。例如: jms.provider.ens.broker=cal.example.com:57997 |
jms.provider.ens.factory |
無 |
與行事曆代理程式一起使用。用於建立主題連線物件的工廠類別。此參數的值必須設定如下:在單行上輸入值: com.iplanet.ens.jms.EnsTopicConnFactory |
iim_agent.enable |
False |
如果為 TRUE,會啟用 Instant Messaging 代理程式。將值設定為 FALSE,或將參數從 iim.conf 中移除,可停用所有代理程式。 |
iim_agent.agent-calendar.enable |
無 |
與行事曆代理程式一起使用。若為 TRUE 或 iim.conf 中沒有,則會載入專門啟用行事曆代理程式的元件。 |
agent-calendar.jid |
無 |
行事曆代理程式的 JID。 |
agent-calendar.password |
無 |
定義行事曆代理程式連線至 Instant Messaging 伺服器的密碼。 |
iim_server.components |
無 |
將行事曆代理程式描述為 Instant Messaging 伺服器的元件。此參數的值必須設定為: agent-calendar |
Instant Messaging 將 XMPP/HTTP 閘道的配置設定儲存在 httpbind.conf 檔案中。此附錄的以下章節描述配置參數和檔案:
只要您修改 httpbind.conf 檔案,您必須使用您的 Web 容器或應用程伺服器提供的工具重新啟動 XMPP/HTTP 閘道。
根據預設,configure 公用程式會在預設伺服器例項的「配置目錄」(im-cfg-base) 內建立 httpbind.conf 檔案,例如:
Solaris:
/etc/opt/SUNWiim/default/config/httpbind.conf
Linux:
/etc/opt/sun/im/default/config/httpbind.conf
如果您已建立多個 Instant Messaging 的實例,/default 目錄的名稱會隨著實例改變。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例。configure 公用程式只會在預設實例的 im-cfg-base 目錄中建立此檔案。
httpbind.conf 檔案是 ASCII 純文字檔案,其中的每一行定義了閘道參數及其值:
參數及其值是由等號 (=) 分隔,等號之前或之後可以允許包含空格與標籤。
數值可以用雙引號 (" ") 括起。如果參數允許多值,則必須將整個值字串以雙引號括起。
註釋行必須要以驚嘆號 (!) 作為一行的第一個字元。註釋行是作為提供資訊之用,而且會被伺服器所忽略。
如果參數出現不只一次,則列出的最後參數值將會覆蓋先前的值。
反斜線 (\) 是用於接續後面內容,並指出值的內容超過一行。
每行會終止於行終止符號 (\n、\r 或 \r\\n)。
鍵值包含行中開頭為第一個非空格字元到第一個 ASCII 等號 (=) 或分號 (;) 的所有字元。 如果該鍵值以分號結束,則鍵值之後會是「lang-」和指定解譯此值所使用語言的標記。語言標記後面會接著等號 (=)。所有等號之前或之後的空白字元將會被忽略。行中所有剩餘的字元將會變為相關值字串的一部份。
值字串中的多重值會使用逗號 (,) 分隔。
如果值內有任何特殊字元,如逗號、空格、新行、定位字元、雙引號或反斜線,那麼整個值必須前後加上雙引號。此外,每個值中的換行鍵、返回字元、定位字元、反斜線和雙引號必須以反斜線 (\) 指定。
如果您變更 httpbind.conf,則必須重新整理閘道的 Web 容器,讓新的配置設定生效。
httpbind.conf 檔案是由 configure 公用程式初始化,並僅應根據本指南所述修改。
表 B–1 描述 httpbind.conf 中的配置參數。
表 B–1 httpbind.conf 中的 XMPP/HTTP 閘道配置參數
參數 |
預設值 |
說明 |
---|---|---|
httpbind.pool.nodeId |
N/A |
如果 httpbind.pool.support 設為 true,此參數為伺服器池中的伺服器節點指定完整的 URL。此 URL 不應指向負載平衡器,而應指向 Instant Messaging 伺服器實例。 |
httpbind.pool.support |
false |
此參數定義閘道是否在伺服器池部署中。如果未指定 httpbind.pool.nodeId,則此參數值會設為 false。 此參數的值可以是:
|
httpbind.config |
N/A |
包含閘道可做為配置鍵值的 ID 鍵值清單 (以逗號分隔),或 gwdomain-id,以決定閘道應使用哪一些網域、主機、主機密碼和元件 JID。如需 ID 鍵值的詳細資訊,請參閱表 B–2。 |
httpbind.content_type |
text/xml; charset=utf-8 |
content-type HTTP 標頭的預設值,當閘道將回應傳回用戶端時會使用此預設值。 |
httpbind.hold |
N/A |
根據 JEP 124 中的定義,指定用戶端請求中 hold 屬性的最大允許值。 如果用戶端指定的值高於請求中的閘道,將使用閘道值。否則,將使用用戶端請求中的值。 |
httpbind.inactivity |
180 |
用戶端非使用中的最長時間 (以秒為單位),閘道在這段時間之後會終止用戶端連線。 |
httpbind.log4j.config |
N/A |
閘道將用於記錄的 log4j 配置檔的位置。如果您將此值保留為空白,則會關閉閘道的記錄。記錄程式的名稱為「httpbind」(log4j.logger.httpbind)。 |
httpbind.polling |
1 (秒) |
用戶端在傳送另一個請求前必須等待的最小時間 (以秒為單位)。 |
httpbind.requests |
2 |
用戶端可向閘道同步運作請求的數目。如果此參數的值小於用戶端請求中 JEP 124 hold 屬性的值,此參數值將設為 hold+1。不要將此值設定為 1,因為如此會使效能嚴重降低。如需詳細資訊,請參? httpbind.hold。 |
httpbind.round_trip_delay |
1 (秒) |
往返的逾時之外所允許視為網路延遲的額外時間長度 (以秒為單位)。此值設定過高會使效能降低。 |
httpbind.wait_time |
120 (秒) |
預設的時間秒數,閘道會在這段時間內將回應傳送到用戶端。如果用戶端等待時間設定的值高於閘道等待時間,則使用閘道的等待時間。 |
表 B–2 描述用於定義 httpbind.config 參數中每個 ID 的鍵值。表 gwdomain-id 中所述的每個鍵值為 httpbind.config 中指定的網域識別碼。
表 B–2 httpbind.config ID 鍵值
鍵值 |
說明 |
---|---|
gwdomain-id.domains |
此 ID 的網域清單,以逗號分隔。 |
gwdomain-id.hosts |
此 ID 的主機清單,以空格分隔。每個主機均必須能夠服務 gwdomain-id .domains 中所列的網域。此清單協助在網域之間提供容錯移轉。如果請求中未提及明確的路由主機,則此鍵值中所列的其中一個主機將用於服務該請求。 |
gwdomain-id.componentjid |
用於連線主機的元件 JID。 |
gwdomain-id.password |
用於連線主機的密碼。 |
本章在以下幾節說明用於管理 Instant Messaging 的 imadmin 指令:
您可以使用 imadmin 公用程式來啟動、停止與更新 Instant Messaging 伺服器和多重訊號組合器。以超級使用者 root 或在配置期間指定的一般使用者身份執行 imadmin。
您必須從安裝 Instant Messaging 伺服器的主機中呼叫 imadmin 公用程式。
依照預設,imadmin 會安裝於下列位置:
im-svr-base/sbin
表 C–1 列出並描述與 imadmin 指令相關的指令。
表 C–1 imadmin 指令和說明
指令 |
說明 |
---|---|
imadmin assign_services |
如果 iim.policy.modules 設定為 identity,則此指令會將 Instant Messaging 和身份認證服務指派給您所指定基底 DN 下的現有使用者。DN 應為儲存使用者項目之組織的基底 DN。 如果 iim.policy.modules 設定為 iim_ldap,且 iim.userprops.store 設定為 ldap,則此指令會將物件類別 (sunIMUser 和 sunPresenceUser) 新增至目錄中的使用者項目。Instant Messaging 需要這些物件類別,以便在 LDAP 中儲存特性。 |
imadmin status (以前為 imadmin check) |
檢查元件 (server、multiplexor、agent-calendar 與 watchdog) 是否在正常執行並顯示結果。如果您未指定元件,imadmin 公用程式會傳回所有元件的相關資訊。 |
imadmin start |
啟動已啟用的元件。 |
imadmin stop |
停止已啟用的元件。 |
imadmin refresh |
更新已啟用的元件。 |
imadmin start server |
只啟動伺服器。 |
imadmin stop server |
只停止伺服器。 |
imadmin refresh server |
只更新伺服器。 |
imadmin start multiplexor |
只啟動多重訊號組合器。 |
imadmin stop multiplexor |
只停止多重訊號組合器。 |
imadmin refresh multiplexor |
只更新多重訊號組合器。 |
imadmin start agent-calendar |
僅啟動行事曆代理程式。 |
imadmin stop agent-calendar |
只停止行事曆代理程式。 |
imadmin refresh agent-calendar |
只更新行事曆代理程式。 |
imadmin start watchdog |
只啟動監視程式。 |
imadmin stop watchdog |
只停止監視程式。 |
imadmin refresh watchdog |
只更新監視程式。 |
imadmin version |
顯示版本。 |
imadmin [選項] [動作] [元件]
表 C–2 列出並描述 imadmin 指令的選項。
表 C–2 imadmin 指令的選項
選項 |
說明 |
---|---|
-c alt-config-file |
將 start 和 refresh 動作搭配使用,用以指定 /etc/opt/SUNWiim/config/iim.conf 檔案以外的不同配置檔案。 |
-h |
顯示有關 imadmin 指令的。 |
表 C–3 列出並描述發出各種 imadmin 指令後執行的動作。
表 C–3 imadmin 指令的動作
選項 |
說明 |
---|---|
status (以前為 imadmin check) |
傳回關於 Instant Messaging 元件 (server、 multiplexor、agent-calendar 和 watchdog) 的資訊。執行此動作無需提供 [component]。 |
start |
設定 classpath,Java 堆疊大小並啟動所有指定的元件。 |
stop |
停止所有指定元件的常駐程式。 |
refresh |
停止並啟動指定的元件。用於配置變更之後。 |
表 C–4 列出並描述 imadmin 指令的元件。
表 C–4 imadmin 指令的元件
選項 |
說明 |
---|---|
agent-calendar |
表示行事曆代理程式 (agent-calendar)。 |
multiplexor |
僅表示多重訊號組合器。 |
server |
表示 Instant Messaging 伺服器。 |
watchdog |
表示監視程式。 |
本章在以下章節中說明 Instant Messaging 使用的 API:
Instant Messaging 所提供的 Java API 可以用來開發延伸或整合模組。安裝的 Instant Messenger 元件均有提供這些 API 的詳細文件,檔案形式為 Javadocs 產生的 HTML 檔案。Javadoc 檔案安裝於 im-svr-base/html/apidocs/ 目錄。若要檢視 API 文件,將瀏覽器指向 codebase/apidocs,其中 codebase 為 Instant Messenger 資源代碼庫。
以下為 Instant Messaging API:
位於相同主機或遠端主機中的應用程式會使用 Instant Messaging API 來存取 Instant Messaging 服務,例如「線上狀態」、「會議」、「通知」、「輪詢」和「新聞」通道。
Instant Messaging 服務 API 可用於:
Java 式或 Web 式用戶端,例如入口網站通道。
啟用其他用戶端類別的「橋接器」或「閘道」。
Instant Messenger 與 Presence 整合在現有的應用程式中。
將新聞 Feed 顯示為 Instant Messenger 新聞。
Messenger Bean 是一種動態載入模組,用於延伸 Instant Messenger 功能。Messenger Bean 會新增動作偵聽程式 (例如按鈕、功能表項目) 和項目偵聽程式 (例如現有 Instant Messenger 視窗中的核取方塊和切換按鈕)。當收到一般使用者輸入,且 Bean 特定的動作是根據一般使用者的輸入,則會呼叫項目偵聽程式。Bean 能夠新增自己的設定面板,並將 Bean 特定特性儲存在伺服器上。Instant Messenger 收到任何事件 (例如新警示訊息),Bean 都會得到通知。
使用 Messenger Bean 的應用程式包括以下功能:
一般使用者在應用程式和會議中使用語音或影像的能力。
能夠擷取並處理會議的記錄。例如,所收到或傳送之警示的內容,以供歸檔之用。
服務提供者介面 API 提供了延伸 Instant Messaging 伺服器功能的能力。服務提供者介面包含以下獨立 API:
「歸檔提供者」是一個軟體模組,通常提供與歸檔或稽核系統的整合。每個配置的「歸檔提供者」會在每個伺服器程序中啟動。
「歸檔提供者」會在下列的伺服器程序中呼叫:
當傳送即時訊息時,例如警示、輪詢、聊天、新聞或會議訊息。
認證事件期間,例如登入或登出。
線上狀態有所變化時。
在訂閱事件期間。例如,當某人加入或離開會議室,或是訂閱或取消訂閱新聞通道時。
使用歸檔提供者 API 的應用程式如下:
Instant Messaging 歸檔
Instant Messaging 中預設的 Instant Messaging 歸檔以歸檔提供者 API 為基礎。如需 Instant Messaging 歸檔的詳細資訊,請參閱第 18 章, 管理 Instant Messaging 的歸檔。
記錄使用統計作為調整大小之用的應用程式。
可以在每個訊息或每個經歷伺服器的訊息部份中呼叫「訊息轉換程式」。「訊息轉換程式」可能會將訊息部份保留不變,或修改或移除訊息部份。文字部分會視為 Java 字串物件予以處理。「訊息轉換程式」會將其他附件以位元組流的形式處理,並傳回潛在不同的位元組流。如果附件已刪除的話,則不傳回任何資料。
使用 Message Conversion API 的應用程式包括以下功能:
病毒檢查與移除
轉換引擎整合
訊息內容篩選
認證提供者 API 能夠在不使用 Access Manager 密碼式或記號式認證服務的環境中部署 Instant Messaging。只要一般使用者請求認證,便會呼叫此 API,此 API 可與 LDAP 認證結合使用
使用認證提供者 API 執行透過 Access Manager 進行的單次登入(SSO)。此 API 也可用於與其他認證系統整合。
此附錄說明對 Instant Messaging 的 LDAP 模式所做的修改。
下表列出為 Instant Messaging 新增至模式和該目錄中之項目的 LDAP objectclasses。
表 E–1 Instant Messaging Objectclasses
名稱 |
說明 |
---|---|
sunIMUser |
包含使用者特性。 當您執行 imadmin assign_services 指令時,新增至所指定基底 DN 下的使用者項目。 |
sunPresenceUser |
包含使用者線上狀態特性。 當您執行 imadmin assign_services 指令時,新增至所指定基底 DN 下的使用者項目。 |
sunIMNews |
包含新聞通道特性。 如果 userprops.store 設為 ldap,當建立新的新聞通道時,會將新聞通道的項目新增至目錄。新聞通道項目將包含 sunIMNews objectclass。 |
sunIMConference |
包含會議室特性。 如果 userprops.store 設為 ldap,當建立新的會議室時,會將會議室的項目新增至目錄。會議室項目將包含 sunIMConference objectclass。 |