AdminTask 物件的 ProxyManagement 指令群組
您可以使用 Jython 或 Jacl Scripting 語言,來管理 Proxy 配置。請利用 ProxyManagement 群組中的指令和參數,來配置 Web 模組的 Proxy 伺服器。
AdminTask 物件的 ProxyManagement 指令群組包括下列指令:
createWebModuleProxyConfig
createWebModuleProxyConfig 指令會為 Web 模組建立 Proxy 伺服器配置。目標物件
指定代表應用程式的部署物件,讓系統為該應用程式建立 Web 模組 Proxy 配置。
必要參數
- -deployedObjectProxyConfigName
- 指定您屬意之 Web 模組的名稱。(字串)
選用參數
- -enableProxy
- 指定系統是否啟用 Proxy 伺服器。指定 true,則會啟用 Proxy 伺服器。(布林)
- -transportProtocol
- 指定 Proxy 伺服器用來與 Web 模組通訊的通訊協定。有效值是 HTTP、HTTPS 和 ClientProtocol。(字串)
範例
批次模式下的用法範例:
- 使用 Jacl:
$AdminTask createWebModuleProxyConfig myApplication {-deployedObjectProxyConfigName MyWebModule -enableProxy true -transportProtocol HTTPS}
- 使用 Jython 字串:
AdminTask.createWebModuleProxyConfig('myApplication', '[-deployedObjectProxyConfigName MyWebModule -enableProxy true -transportProtocol HTTPS]')
- 使用 Jython 清單:
AdminTask.createWebModuleProxyConfig(myApplication, ['-deployedObjectProxyConfigName', 'MyWebModule', '-enableProxy', 'true', '-transportProtocol', 'HTTPS'])
互動模式下的用法範例:
- 使用 Jacl:
$AdminTask createWebModuleProxyConfig {-interactive}
- 使用 Jython:
AdminTask.createWebModuleProxyConfig('-interactive')
deleteWebModuleProxyConfig
deleteWebModuleProxyConfig 指令會移除 Web 模組的 Proxy 伺服器配置。目標物件
指定代表應用程式的部署物件,讓系統將 Web 模組 Proxy 配置從該應用程式移除。
必要參數
- -deployedObjectProxyConfigName
- 指定您屬意之 Web 模組的名稱。(字串)
選用參數
無範例輸出
指令不傳回輸出。
範例
批次模式下的用法範例:
- 使用 Jacl:
$AdminTask deleteWebModuleProxyConfig myApplication {-deployedObjectProxyConfigName MyWebModule}
- 使用 Jython 字串:
AdminTask.deleteWebModuleProxyConfig('myApplication', '[-deployedObjectProxyConfigName MyWebModule]')
- 使用 Jython 清單:
AdminTask.deleteWebModuleProxyConfig(myApplication, ['-deployedObjectProxyConfigName', 'MyWebModule'])
互動模式下的用法範例:
- 使用 Jacl:
$AdminTask deleteWebModuleProxyConfig {-interactive}
- 使用 Jython:
AdminTask.deleteWebModuleProxyConfig('-interactive')
getServerSecurityLevel
getServerSecurityLevel 指令會顯示安全 Proxy 伺服器的現行安全層次。目標物件
指定您屬意之安全 Proxy 伺服器的配置 ID。
選用參數
- -proxyDetailsFormat
- 指定對於 Proxy 伺服器的安全層次,您想顯示的詳細資料格式。指定 levels,則會將詳細資料顯示成每一項設定的安全層次。指定 values,則會將詳細資料顯示成每一個 Proxy 伺服器的實際設定。(字串)
範例輸出
指令會傳回安全 Proxy 伺服器的安全層次。如果指定選用參數,指令會顯示您所屬意之伺服器安全層次的其他資訊。
範例
批次模式下的用法範例:
- 使用 Jacl:
$AdminTask getServerSecurityLevel myProxyServer {-proxyDetailsFormat levels}
- 使用 Jython 字串:
AdminTask.getServerSecurityLevel('myProxyServer', '[-proxyDetailsFormat levels]')
- 使用 Jython 清單:
AdminTask.getServerSecurityLevel(myProxyServer, ['-proxyDetailsFormat', 'levels'])
互動模式下的用法範例:
- 使用 Jacl:
$AdminTask getServerSecurityLevel {-interactive}
- 使用 Jython:
AdminTask.getServerSecurityLevel('-interactive')
setServerSecurityLevel
setServerSecurityLevel 指令會修改安全 Proxy 伺服器的伺服器安全層次。目標物件
指定您屬意之安全 Proxy 伺服器的配置 ID。
選用參數
- -proxySecurityLevel
- 指定要套用至 Proxy 伺服器的安全層次。有效值包括 High、Medium 和 Low。(字串)您也可以利用這個參數,指定安全設定 ID 和值,以指定自訂安全設定,如下表中的定義所示:
表 1. 安全 Proxy 伺服器的安全設定. 此表格列出安全 Proxy 伺服器的安全設定。
ID 說明 有效值 administration 設定管理安全設定。 指定 local,則容許本端管理。指定 remote,則容許遠端管理。 routing 設定遞送安全設定。使用靜態遞送時,則指定透過一般配置檔,以指引排序中固有的遞送優先順序來執行遞送。您也可以透過最相符機制,來動態遞送要求,這種機制會決定特定要求所對應的已安裝應用程式或遞送規則。 指定 static,以使用靜態遞送,或指定 dynamic,以使用動態遞送。 startupPermissions 設定啟動許可權。在啟動之後,將伺服器程序回復成以非特許使用者身分執行,可以加強安全 Proxy 伺服器的整體安全層次。雖然安全 Proxy 伺服器必須以特許使用者身分啟動,但是將伺服器程序變更為以非特許使用者身分執行,可為本端作業資源提供額外的保護。 請指定 unprivileged,以非特許使用者身分來執行伺服器程序,或指定 privileged,以特許使用者身分來執行伺服器程序。 errorPageHandling 設定錯誤頁面處理方式。對於 Proxy 伺服器或應用程式伺服器所產生的錯誤,您可以定義每個錯誤碼或錯誤碼群組的自訂錯誤頁面。其作法是利用回應中的 HTTP 狀態碼,來產生應用程式的統一自訂錯誤頁面。為了安全起見,您可以確保錯誤頁面是從本端檔案系統讀取,而不是轉遞至自訂的遠端應用程式。 請指定 local,從本端檔案系統讀取錯誤頁面,或指定 remote,容許系統從遠端應用程式讀取錯誤頁面。
範例輸出
指令不傳回輸出。
範例
批次模式下的用法範例:
- 使用 Jacl:
$AdminTask setServerSecurityLevel proxyServerID {-proxySecurityLevel administration=local;routing=static;startupPermissions=unprivileged ;errorPageHandling=local}
- 使用 Jython 字串:
AdminTask.setServerSecurityLevel('proxyServerID', '[-proxySecurityLevel administration=local;routing=static;startupPermissions=unprivileged ;errorPageHandling=local]'))
- 使用 Jython 清單:
AdminTask.setServerSecurityLevel(proxyServerID, ['-proxySecurityLevel', 'administration=local;routing=static;startupPermissions=unprivileged ;errorPageHandling=local'])
互動模式下的用法範例:
- 使用 Jacl:
$AdminTask setServerSecurityLevel {-interactive}
- 使用 Jython:
AdminTask.setServerSecurityLevel('-interactive')