JMX REST Connector

可以利用使用 JDK,從本端或遠端使用的安全 JMX 連接器。它通過 REST 型連接器來啟用 JMX 用戶端的遠端存取,且需要 SSL 和基本使用者安全配置。

啟用這項特性

如果要啟用「JMX REST 連接器」特性,請在 server.xml 檔的 featureManager 元素內,新增下列的元素宣告:
<feature>restConnector-1.0</feature>

支援的 Java™ 版本

  • JavaSE-1.6
  • JavaSE-1.7
  • JavaSE-1.8

開發相依於這項特性的特性

如果您要開發的特性相依於「JMX REST 連接器」特性,請將下列項目包含在您新特性的特性資訊清單檔 Subsystem-Content 標頭中:
com.ibm.websphere.appserver.restConnector-1.0; type="osgi.subsystem.feature"

啟用這項特性的特性

特性配置元素

您可以在 server.xml 檔中使用下列元素,來配置「JMX REST 連接器」特性:

administrator-role
獲指派伺服器管理者角色的使用者及/或群組集合。
administrator-role > group
說明:獲指派角色的群組。
必要:false
資料類型:string
administrator-role > user
說明:獲指派角色的使用者。
必要:false
資料類型:string
authCache
控制鑑別快取作業。
屬性名稱 資料類型 預設值 說明
allowBasicAuthLookup boolean true 容許依使用者 ID 和雜湊式密碼查閱。
initialSize int

下限:1

50 鑑別快取所支援的項目起始數目。
maxSize int

下限:1

25000 鑑別快取所支援的項目數目上限。
timeout 精準度是毫秒的時間量 600s 在移除快取中的項目之前的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
authentication
控制內建鑑別服務配置。
屬性名稱 資料類型 預設值 說明
allowHashtableLoginWithIdOnly boolean false 容許在雜湊表內容中僅具有一個身分的應用程式登入。請僅在您有需要此項的應用程式,而且有其他方法可驗證身分時,才使用這個選項。
cacheEnabled boolean true 啟用鑑別快取。
basicRegistry
簡式 XML 型使用者登錄。
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
ignoreCaseForAuthentication boolean false 容許不區分大小寫的使用者名稱鑑別。
realm string BasicRegistry 網域範圍名稱代表使用者登錄。
basicRegistry > group
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name string   「基本使用者登錄」中的群組名稱。
basicRegistry > group > member
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name string   「基本使用者登錄」群組中的使用者名稱。
basicRegistry > user
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name string   「基本使用者登錄」中的使用者名稱。
password 單向雜湊表,或可逆的編碼密碼(字串)   「基本使用者登錄」中的使用者密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。
channelfw
定義通道和鏈結管理設定。
屬性名稱 資料類型 預設值 說明
chainQuiesceTimeout 精準度是毫秒的時間量 30s 靜止鏈結時的預設等待時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
chainStartRetryAttempts int

下限:0

60 每個鏈結進行重試的次數。
chainStartRetryInterval 精準度是毫秒的時間量 5s 啟動重試之間的時間間隔。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
warningWaitTime 精準度是毫秒的時間量 10s 通知遺漏原廠配置之前的等待時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
classloading
廣域類別載入
屬性名稱 資料類型 預設值 說明
useJarUrls boolean false 要使用 jar: 或 wsjar: URL 來參照保存檔中的檔案
httpAccessLogging
HTTP 存取日誌包含所有入埠 HTTP 用戶端要求的記錄。
屬性名稱 資料類型 預設值 說明
enabled boolean true 啟用存取記載。
filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。
id string   唯一的配置 ID。
logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。
maxFileSize int

下限:0

20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFiles int

下限:0

2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
httpDispatcher
「HTTP 分派器」配置。
屬性名稱 資料類型 預設值 說明
appOrContextRootMissingMessage string   找不到所要求的 URI 中的應用程式時要傳回用戶端的訊息。
enableWelcomePage boolean true 當沒有應用程式連結至環境定義根目錄 "/" 時,則啟用預設的 Liberty 設定檔歡迎使用頁面。預設值為 true。
httpDispatcher > trustedHeaderOrigin
說明:Web 伺服器外掛程式使用私密標頭來提供原始要求的相關資訊。這些標頭優先於 http 主機標頭,用以選取虛擬主機來處理要求。預設值是 '*',表示信任任何來源送入的私密標頭。請指定 'none' 以停用私密標頭並只依賴 http 主機標頭,或指定 IP 位址清單,以限制只處理特定信任來源的私密標頭。
必要:false
資料類型:string
httpEncoding
HTTP 傳輸編碼設定
屬性名稱 資料類型 預設值 說明
converter.Big5 string Cp950 Big5 中文轉換器
converter.EUC-JP string Cp33722C EUC 日文轉換器 (EUC-JP)
converter.EUC-KR string Cp970 EUC 韓文轉換器 (EUC-KR)
converter.EUC-TW string Cp964 EUC 中文(台灣)轉換器 (EUC-TW)
converter.EUC_KR string Cp970 EUC 韓文轉換器 (EUC_KR)
converter.GB2312 string EUC_CN GB2312 中文轉換器
converter.ISO-2022-KR string ISO2022KR ISO-2022 韓文轉換器 (ISO-2022-KR)
converter.Shift_JIS string Cp943C Shift_JIS 日文轉換器
encoding.ar string ISO-8859-6 阿拉伯文語言編碼 (ar)
encoding.be string ISO-8859-5 白俄羅斯文語言編碼 (be)
encoding.bg string ISO-8859-5 保加利亞文語言編碼 (bg)
encoding.bn string UTF-8 孟加拉文語言編碼 (bn)
encoding.ca string ISO-8859-1 加泰蘭文語言編碼 (ca)
encoding.cs string ISO-8859-2 捷克文語言編碼 (cs)
encoding.da string ISO-8859-1 丹麥文語言編碼 (da)
encoding.de string ISO-8859-1 德文語言編碼 (de)
encoding.el string ISO-8859-7 希臘文語言編碼 (el)
encoding.en string ISO-8859-1 英文語言編碼 (en)
encoding.es string ISO-8859-1 西班牙文語言編碼 (es)
encoding.et string ISO-8859-4 愛沙尼亞文語言編碼 (et)
encoding.eu string ISO-8859-1 巴斯克文語言編碼 (eu)
encoding.fa string ISO-8859-6 波斯文語言編碼 (fa)
encoding.fi string ISO-8859-1 芬蘭文語言編碼 (fi)
encoding.fo string ISO-8859-2 法羅文語言編碼 (fo)
encoding.fr string ISO-8859-1 法文語言編碼 (fr)
encoding.he string ISO-8859-8 希伯來文語言編碼 (he)
encoding.hi string UTF-8 北印度文語言編碼 (hi)
encoding.hr string ISO-8859-2 克羅埃西亞文語言編碼 (hr)
encoding.hu string ISO-8859-2 匈牙利文語言編碼 (hu)
encoding.hy string UTF-8 亞美尼亞文語言編碼 (hy)
encoding.is string ISO-8859-1 冰島文語言編碼 (is)
encoding.it string ISO-8859-1 義大利文語言編碼 (it)
encoding.iw string ISO-8859-8 希伯來文語言編碼 (iw)
encoding.ja string Shift_JIS 日文語言編碼 (ja)
encoding.ji string ISO-8859-8 意第緒文語言編碼 (ji)
encoding.ka string UTF-8 喬治亞文語言編碼 (ka)
encoding.ko string EUC-KR 韓文語言編碼 (ko)
encoding.lt string ISO-8859-2 立陶宛文語言編碼 (lt)
encoding.lv string ISO-8859-4 拉脫維亞文語言編碼 (lv)
encoding.mk string ISO-8859-5 馬其頓文語言編碼 (mk)
encoding.mr string UTF-8 馬拉地文語言編碼 (mr)
encoding.ms string ISO-8859-6 馬來文語言編碼 (ms)
encoding.mt string ISO-8859-3 馬爾他文語言編碼 (mt)
encoding.nl string ISO-8859-1 荷蘭文語言編碼 (nl)
encoding.no string ISO-8859-1 挪威文語言編碼 (no)
encoding.pl string ISO-8859-2 波蘭文語言編碼 (pl)
encoding.pt string ISO-8859-1 葡萄牙文語言編碼 (pt)
encoding.ro string ISO-8859-2 羅馬尼亞文語言編碼 (ro)
encoding.ru string ISO-8859-5 俄文語言編碼 (ru)
encoding.sa string UTF-8 梵文語言編碼 (sa)
encoding.sh string ISO-8859-2 塞爾維亞-克羅地亞文語言編碼 (sh)
encoding.sk string ISO-8859-2 斯洛伐克文語言編碼 (sk)
encoding.sl string ISO-8859-2 斯洛維尼亞文語言編碼 (sl)
encoding.sq string ISO-8859-2 阿爾巴尼亞文語言編碼 (sq)
encoding.sr string ISO-8859-5 塞爾維亞文語言編碼 (sr)
encoding.sv string ISO-8859-1 瑞典文語言編碼 (sv)
encoding.ta string UTF-8 泰米爾文語言編碼 (ta)
encoding.th string windows-874 泰文語言編碼 (th)
encoding.tr string ISO-8859-9 土耳其文語言編碼 (tr)
encoding.uk string ISO-8859-5 烏克蘭文語言編碼 (uk)
encoding.vi string windows-1258 越南文語言編碼 (vi)
encoding.yi string ISO-8859-8 意第緒文語言編碼 (yi)
encoding.zh string GB2312 中文語言編碼 (zh)
encoding.zh_TW string Big5 中文語言編碼 (zh_TW)
httpEndpoint
HTTP 端點的配置內容。
屬性名稱 資料類型 預設值 說明
accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。   端點的 HTTP 存取記載配置。
enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。
host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。
httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。
httpPort int

下限:-1

上限:65535

  用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpsPort int

下限:-1

上限:65535

  受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
id string   唯一的配置 ID。
onError
  • IGNORE
  • FAIL
  • WARN
WARN 無法啟動端點之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。   端點的 SSL 通訊協定選項。
tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。
httpEndpoint > accessLogging
說明:端點的 HTTP 存取記載配置。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
enabled boolean true 啟用存取記載。
filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。
logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。
maxFileSize int

下限:0

20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFiles int

下限:0

2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
httpEndpoint > httpOptions
說明:端點的 HTTP 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
keepAliveEnabled boolean true 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。
maxKeepAliveRequests int

下限:-1

100 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。
persistTimeout 精準度是秒鐘的時間量 30s 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
readTimeout 精準度是秒鐘的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
removeServerHeader boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。
writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
httpEndpoint > sslOptions
說明:端點的 SSL 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
sslRef string   預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。
suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
httpEndpoint > tcpOptions
說明:端點的 TCP 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
httpOptions
HTTP 通訊協定配置。
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
keepAliveEnabled boolean true 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。
maxKeepAliveRequests int

下限:-1

100 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。
persistTimeout 精準度是秒鐘的時間量 30s 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
readTimeout 精準度是秒鐘的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
removeServerHeader boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。
writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
httpProxyRedirect
配置埠重新導向。將 HTTP 要求從非安全埠(例如 80)重新導向至啟用 SSL 的安全埠(例如 443)時,使用「HTTP Proxy 重新導向」。
屬性名稱 資料類型 預設值 說明
enabled boolean true 這個屬性決定伺服器是否應重新導向這個配置元素中指定的埠。預設值是 true。
host string * 重新導向此埠時,要使用的主機名稱。送入的要求所指定的主機名稱必須符合此值,伺服器才會重新導向 HTTP 要求。預設值是 *(所有主機)。
httpPort int

下限:1

上限:65535

  重新導向時的來源(非安全)埠。此埠上送入的 HTTP 要求會重新導向至指定的 HTTPS 埠。
httpsPort int

下限:1

上限:65535

  重新導向時的目標(安全)埠。使用 HTTP 埠之送入的 HTTP 要求會重新導向至這個埠。
id string   唯一的配置 ID。
jaasLoginContextEntry
JAAS 登入環境定義項目配置。
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
loginModuleRef 最上層 jaasLoginModule 元素的參照清單(逗點區隔的字串)。 hashtable,userNameAndPassword,certificate,token JAAS 登入模組 ID 的參照。
name string   JAAS 配置項目的名稱。
jaasLoginModule
JAAS 配置中的登入模組。
屬性名稱 資料類型 預設值 說明
className string   JAAS 登入模組類別的完整套件名稱。
controlFlag
  • SUFFICIENT
  • REQUISITE
  • REQUIRED
  • OPTIONAL
REQUIRED 登入模組的控制旗標。有效值為 REQUIRED、REQUISITE、SUFFICIENT 和 OPTIONAL。
SUFFICIENT
根據 JAAS 規格,這個 LoginModule 是「足夠的」。不需要有 LoginModule 就能成功。如果鑑別成功,則不會呼叫其他 LoginModule,同時控制權會回到呼叫端。
REQUISITE
根據 JAAS 規格,這個 LoginModule 是 REQUISITE。必須要有 LoginModule 才能成功。如果鑑別失敗,則不會呼叫其他 LoginModule,同時控制權會回到呼叫端。
REQUIRED
根據 JAAS 規格,這個 LoginModule 是「必要的」。必須要有 LoginModule 才能成功。
OPTIONAL
根據 JAAS 規格,這個 LoginModule 是「選用的」。不需要有 LoginModule 就能成功。
id string   唯一的配置 ID。
libraryRef 最上層 library 元素的參照(字串)。   共用程式庫配置 ID 的參照。
jaasLoginModule > library
說明:共用程式庫配置 ID 的參照。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。
description string   管理者的共用程式庫說明
filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。   參照的檔案集 ID
name string   管理者的共用程式庫名稱
jaasLoginModule > library > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
jaasLoginModule > library > fileset
說明:參照的檔案集 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
jaasLoginModule > library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
jaasLoginModule > options
說明:「JAAS 登入」模組選項的集合
必要:false
資料類型:
library
共用程式庫
屬性名稱 資料類型 預設值 說明
apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。
description string   管理者的共用程式庫說明
filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。   參照的檔案集 ID
id string   唯一的配置 ID。
name string   管理者的共用程式庫名稱
library > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
library > fileset
說明:參照的檔案集 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
ltpa
「小型認證機構 (LTPA)」記號配置。
屬性名稱 資料類型 預設值 說明
expiration 精準度是分鐘的時間量 120m 記號到期之前的時間量(分鐘)。. 指定正整數加上時間單位,時間單位可以是小時 (h) 或分鐘 (m)。例如,指定 30 分鐘為 30m。您可以在單一項目中包括多個值。例如,1h30m 相等於 90 分鐘。
keysFileName 檔案的路徑 ${server.output.dir}/resources/security/ltpa.keys 包含記號金鑰之檔案的路徑。
keysPassword 可逆的編碼密碼(字串) {xor}CDo9Hgw= 記號金鑰的密碼。其值可以用明碼或編碼形式儲存。建議您將密碼編碼,請搭配使用 securityUtility 工具與編碼選項。
monitorInterval 精準度是毫秒的時間量 0ms 伺服器檢查 LTPA 記號金鑰檔更新項目的頻率。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
mimeTypes
所有 HTTP 虛擬主機共用的 MIME 類型定義
mimeTypes > type
說明:MIME 類型的定義,形式為 id=value。副檔名為 id,關聯類型為 value。
必要:false
資料類型:string
quickStartSecurity
簡式管理安全配置。
屬性名稱 資料類型 預設值 說明
userName string   定義為快速入門安全配置之一部分的單一使用者。這位使用者獲授予「管理者」角色。
userPassword 可逆的編碼密碼(字串)   定義為快速入門安全配置之一部分的單一使用者密碼。建議您將此密碼編碼。如果要這麼做,請搭配使用 securityUtility 工具與編碼選項。
remoteFileAccess
這個元素包含用來控制遠端連線所顯現之檔案存取層次的構件。
remoteFileAccess > readDir
說明:遠端用戶端可以讀取的目錄。可以有多個 readDir 元素,各元素分別代表可能指向變數或絕對路徑的單一目錄。預設值是 ${wlp.install.dir}、${wlp.user.dir} 和 ${server.output.dir}
必要:false
資料類型:目錄的路徑
remoteFileAccess > writeDir
說明:遠端用戶端可以讀取和寫入的目錄。可以有多個 writeDir 元素,各元素分別代表可能指向變數或絕對路徑的單一目錄。預設值是一組空白的目錄。
必要:false
資料類型:目錄的路徑
tcpOptions
定義 TCP 通訊協定設定。
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
trustAssociation
控制信任關聯攔截程式 (TAI) 的作業。
屬性名稱 資料類型 預設值 說明
failOverToAppAuthType boolean false 容許攔截程式回復為應用程式鑑別機制。
id string   唯一的配置 ID。
invokeForUnprotectedURI boolean false 控制是否針對未受保護的 URI 呼叫 TAI。
trustAssociation > interceptors
說明:唯一的配置 ID。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
className string   攔截程式類別的完整套件名稱。
enabled boolean true 啟用或停用攔截程式。
id string   唯一的配置 ID。
invokeAfterSSO boolean true 在單一登入 (SSO) 之後呼叫攔截程式。
invokeBeforeSSO boolean false 在單一登入 (SSO) 之前呼叫攔截程式。
libraryRef 最上層 library 元素的參照(字串)。   共用程式庫配置 ID 的參照。
trustAssociation > interceptors > library
說明:共用程式庫配置 ID 的參照。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
apiTypeVisibility string spec,ibm-api,api 這個程式庫的類別載入器將能夠看到的 API 套件類型,方式為下列項目之任何組合的逗點區隔清單:spec、ibm-api、api、third-party。
description string   管理者的共用程式庫說明
filesetRef 最上層 fileset 元素的參照清單(逗點區隔的字串)。   參照的檔案集 ID
name string   管理者的共用程式庫名稱
trustAssociation > interceptors > library > file
說明:參照的檔案 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
id string   唯一的配置 ID。
name 檔案的路徑   完整檔名
trustAssociation > interceptors > library > fileset
說明:參照的檔案集 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
caseSensitive boolean true 指出搜尋是否應該區分大小寫的布林值(預設值:true)。
dir 目錄的路徑 ${server.config.dir} 搜尋檔案的基本目錄。
excludes string   要從搜尋結果中且以逗點或空格區隔的檔名型樣清單,預設為不排除任何檔案。
id string   唯一的配置 ID。
includes string * 要併入搜尋結果中且以逗點或空格區隔的檔名型樣清單(預設值:*)。
scanInterval 精準度是毫秒的時間量 0 用以檢查檔案集之變更的掃描間隔,以時間單位字尾 h-小時、m-分鐘、s-秒、ms-毫秒的長整數來表示(例如 2ms 或 5s)。預設為已停用 (scanInterval=0)。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
trustAssociation > interceptors > library > folder
說明:參照的資料夾 ID
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
dir 目錄的路徑   要併到程式庫類別路徑中以便尋找資源檔的目錄或資料夾
id string   唯一的配置 ID。
trustAssociation > interceptors > properties
說明:攔截程式內容的集合。
必要:false
資料類型:
virtualHost
虛擬主機提供邏輯分組,可將 Web 應用程式配置成特定主機名稱。預設虛擬主機 (default_host) 適用於大部分簡易的配置。
屬性名稱 資料類型 預設值 說明
allowFromEndpointRef 最上層 httpEndpoint 元素的參照清單(逗點區隔的字串)。   指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。
enabled boolean true 啟用這個虛擬主機。
id string   唯一的配置 ID。
virtualHost > allowFromEndpoint
說明:指定一或多個 HTTP 端點的 ID,以限制虛擬主機只接受來自指定端點的入埠資料流量。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
accessLoggingRef 最上層 httpAccessLogging 元素的參照(字串)。   端點的 HTTP 存取記載配置。
enabled boolean true 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。
host string localhost 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。
httpOptionsRef 最上層 httpOptions 元素的參照(字串)。 defaultHttpOptions 端點的 HTTP 通訊協定選項。
httpPort int

下限:-1

上限:65535

  用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
httpsPort int

下限:-1

上限:65535

  受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。
id string   唯一的配置 ID。
onError
  • IGNORE
  • FAIL
  • WARN
WARN 無法啟動端點之後要採取的動作。
IGNORE
伺服器在引起配置錯誤時,將不會發出任何警告和錯誤訊息。
FAIL
伺服器將在第一次出現錯誤時發出警告或錯誤訊息,然後停止伺服器。
WARN
伺服器在引起配置錯誤時,將會發出警告和錯誤訊息。
sslOptionsRef 最上層 sslOptions 元素的參照(字串)。   端點的 SSL 通訊協定選項。
tcpOptionsRef 最上層 tcpOptions 元素的參照(字串)。 defaultTCPOptions 端點的 TCP 通訊協定選項。
virtualHost > allowFromEndpoint > accessLogging
說明:端點的 HTTP 存取記載配置。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
enabled boolean true 啟用存取記載。
filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。
logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。
maxFileSize int

下限:0

20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。
maxFiles int

下限:0

2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
virtualHost > allowFromEndpoint > httpOptions
說明:端點的 HTTP 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
keepAliveEnabled boolean true 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。
maxKeepAliveRequests int

下限:-1

100 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。
persistTimeout 精準度是秒鐘的時間量 30s 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
readTimeout 精準度是秒鐘的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
removeServerHeader boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。
writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
virtualHost > allowFromEndpoint > sslOptions
說明:端點的 SSL 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
sslRef string   預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。
suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。
virtualHost > allowFromEndpoint > tcpOptions
說明:端點的 TCP 通訊協定選項。
必要:false
資料類型:
屬性名稱 資料類型 預設值 說明
inactivityTimeout 精準度是毫秒的時間量 60s 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。
soReuseAddr boolean true 啟用立即重新連結至沒有作用中接聽器的埠。
virtualHost > hostAlias
說明:使用 host:port 語法來建立主機和埠與此虛擬主機的關聯性。指定的主機可以是 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱、DNS 主機名稱,或 * 表示以萬用字元比對所有主機名稱。請注意,IPv6 位址必須以 [] 括住。
必要:false
資料類型:string

指示主題類型的圖示 參照主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_feature_restConnector-1.0
檔名:rwlp_feature_restConnector-1.0.html