配置連接器

使用「安裝程式」將連接器檔案安裝在系統之後,必須再設定標準的和應用程式特有的連接器配置內容。

設定配置內容

連接器有兩種配置內容類型: 標準配置內容和連接器特有配置內容。 執行連接器之前,必須先使用「系統管理程式 (SM)」來設定這些內容的值。

標準配置內容

標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。下表針對附錄的配置內容,提供此連接器特定的資訊。
內容 說明
CharacterEncoding

此連接器不使用這個內容。

Locale

因為此連接器尚未國際化,無法變更這個內容的值。 請參閱連接器的版本注意事項,判斷目前支援的語言環境。

因為此連接器僅支援 InterChange Server (ICS) 當作整合分配管理系統,所以相關的配置內容僅適用於 ICS。

您至少必須設定下列標準連接器配置內容:

連結器特有的配置內容

連接器特有配置內容提供連接器代理程式於執行時期所需的資訊。 連接器特有內容會提供一種方法,以變更連接器代理程式內的靜態資訊或邏輯,而不必重新編碼及重新建置代理程式。

表 30 列出連結器特有的配置內容。 請參閱後續幾節的內容說明。 請注意,部分內容又包含其他內容。 + 字元指出項目在內容階層中的位置。

表 30. 連接器特有配置內容
名稱 可能值 預設值 必要的
DataHandlerMetaObjectName 資料處理常式 Meta 物件名稱 MO_DataHandler_ Default
JavaProtocolHandlerPackages 有效的 Java 通訊協定處理常式套件 com.ibm.net.ssl. internal.www.protocol
ProtocolHandlerFramework 此為階層式內容,沒有值
+ProtocolHandlers 此為階層式內容,沒有值
++Handler1 此為階層式內容。如需子內容的相關資訊,請參閱Handler1
ProtocolListenerFramework 此為階層式內容,沒有值。
+WorkerThreadCount 1 或更大的整數,表示可用的接聽器執行緒數量。 10
+RequestPoolSize 大於 WorkerThreadCount 的整數,表示資源儲存區大小。 20
+ProtocolListeners 此為階層式內容,沒有值

++Listener1 唯一命名的通訊協定接聽器
+++Protocol httphttps
+++ListenerSpecific 接聽器所需的或唯一的內容 請參閱ListenerSpecific

ProxyServer 此為階層式內容,沒有值
+HttpProxyHost HTTP Proxy 伺服器的主機名稱
+HttpProxyPort HTTP Proxy 伺服器的埠號 80
+HttpNonProxyHosts 需要直接連線的 HTTP 主機
+HttpsProxyHost HTTPS Proxy 伺服器的主機名稱
+HttpsProxyPort HTTPS Proxy 伺服器的埠號 443
+HttpsNonProxyHosts 需要直接連線的 HTTPS 主機
+SocksProxyHost Socks Proxy 伺服器名稱
+SocksProxyPort Socks Proxy 伺服器埠
+HttpProxyUsername Http Proxy 伺服器使用者名稱
+HttpProxyPassword Http Proxy 伺服器密碼
+HttpsProxyUsername Https Proxy 伺服器使用者名稱
+HttpsProxyPassword Https Proxy 伺服器密碼
SSL 此為階層式內容,沒有值
+SSLVersion SSLSSLv2SSLv3TLSTLSv1 SSL
+SSLDebug truefalse false
+KeyStoreType 任何有效的金鑰儲存庫類型 JKS
+KeyStore 金鑰儲存庫檔的路徑
+KeyStorePassword 金鑰儲存庫中私密金鑰的密碼
+KeyStoreAlias 金鑰儲存庫中金鑰組的別名
+TrustStore 信任儲存庫檔的路徑
+TrustStorePassword 信任儲存庫的密碼
+UseClientAuth true false false

DataHandlerMetaObjectName

此為資料處理常式用來設定配置內容的 Meta 物件名稱。

預設值 = MO_DataHandler_Default

JavaProtocolHandlerPackages

這個內容的值提供 Java Protocol Handler 套件。 連接器會使用這個內容的值來設定系統內容 java.protocol.handler.pkgs。

預設值 = com.ibm.net.ssl.internal.www.protocol

ProtocolHandlerFramework

「通訊協定處理常式組織架構」使用這個內容來載入及配置通訊協定處理常式。 此為階層式內容,沒有值。

預設值 = 無。

ProtocolHandlers

此階層式內容沒有值。第一層子項代表獨立的通訊協定處理常式。

預設值 = 無。

Handler1

HTTP-HTTPS 通訊協定處理常式的名稱。 請注意,此為階層式內容。 不同於接聽器,通訊協定處理常式不會重複,每一個通訊協定可能只有一個處理常式。 以下表 31 顯示 HTTP-HTTPS 通訊協定處理常式的子內容。 + 字元指出項目在內容階層中的位置。


表 31. HTTP-HTTPS 通訊協定處理常式配置內容
名稱 可能值 預設值 必要的
++HTTPHTTPSHandler 此為階層式內容,沒有值。
+++Protocol 處理常式實作的通訊協定種類。若為 HTTP 和 HTTPS,此值為 http
註:
如果不指定這個內容的值,連接器不會起始設定此通訊協定處理常式。
http
+++HTTPReadTimeout HTTP 特有的內容,指定從遠端主機讀取時的逾時間隔(毫秒)。如果未指定這個內容或設為 0,則 HTTP-HTTPS 通訊協定處理常式從遠端主機讀取時,將永遠暫停執行。 0

ProtocolListenerFramework

通訊協定接聽器組織架構使用這個內容來載入通訊協定接聽器。 此為階層式內容,沒有值。

WorkerThreadCount

這個內容必須是 1 或更大的整數, 可以建立可供通訊協定接聽器組織架構使用的接聽器工作程式執行緒數量。 如需進一步資訊,請參閱通訊協定接聽器。預設值 = 10

RequestPoolSize

這個內容必須是大於 WorkerThreadCount 的整數,可以設定通訊協定接聽器組織架構的資源儲存區大小。 組織架構最多可以同時處理 WorkerThreadCount + RequestPoolSize 個要求。

預設值 = 20

ProtocolListeners

此為階層式內容,沒有值。 這個內容的每一個第一層子項,分別代表一個獨立的通訊協定接聽器。

Listener1

通訊協定接聽器的名稱。可能有多個通訊協定接聽器。 請注意,此為階層式內容。 您可以建立這個內容的多個實例,也可以建立其他唯一命名的接聽器。 建立時,您可以變更接聽器特有的內容,但不是通訊協定內容。 多個接聽器的名稱必須是唯一的。 可能的名稱 (不是值):HTTPListener1HTTPSListener1

Protocol

這個內容指定此接聽器實作的通訊協定。 可能的值:httphttps

註:
如果不指定這個內容的值,連接器不會起始設定此通訊協定接聽器。

ListenerSpecific

對於指定的通訊協定接聽器而言,接聽器特有的內容是唯一的或必要的。 例如,HTTP 接聽器有一個接聽器特有的內容 Port,代表接聽器用來監視要求的埠號。 表 32 摘要說明 HTTP-HTTPS 接聽器特有的內容。 + 字元指出項目在內容階層中的位置。

表 32. HTTP 和 HTTPS 通訊協定特有的配置內容
名稱 可能值 預設值 必要的
+++HTTPListener1 HTTP 通訊協定接聽器的唯一名稱。此為 ProtocolListenerFramework -> ProtocolListeners 階層式內容的一個子項。 可能有多個接聽器:您可以建立此內容及其階層的另一個實例,藉此插入其他 HTTP 接聽器。
++++Protocol 若為 HTTP 通訊協定接聽器,則是 http
若為 HTTPS 通訊協定接聽器,則是 https
註:
如果不指定這個內容的值,連接器不會起始設定此通訊協定接聽器。

++++BOPrefix 這個內容的值會傳遞到資料處理常式。
++++Host 接聽器會在這個內容的值所指定的 IP 位址上接聽。 如果不指定 Host,則預設為 localhost。 請注意,您可以針對執行接聽器的機器,指定主機名稱 (DNS 名稱) 或 IP 位址。 一部機器可能有多個 IP 位址或多個名稱localhost
++++Port 接聽器用來接聽要求的埠。如果未指定,則埠預設為 80 (HTTP) 443 (HTTPS)。如果在連接器內複製接聽器,則 Host 和 Port 內容的組合必須是唯一的,否則接聽器無法連結埠來接受要求。 HTTP 接聽器為 80
HTTPS 接聽器為 443
++++SocketQueueLength 進入的連線要求的佇列長度 (Socket 佇列)。指定在主機拒絕連線之前,一次可以儲存多少進入的連線。最大佇列長度取決於作業系統。 5
++++RequestWaitTimeout 接聽器執行緒在等待要求到達時,在主機和埠上暫停執行的時間間隔,以毫秒為單位。 如果在此間隔之前收到要求,接聽器就會開始處理。否則,接聽器執行緒會檢查是否已設定連接器關閉旗標。 如果已設定,連接器會終止。否則,繼續依 RequestWaitTimeout 間隔來暫停執行。 如果這個內容設為 0,則永遠暫停執行。如果未指定,則預設為 60000ms60000 (ms)
++++HTTPReadTimeout 接聽器從用戶端讀取要求時,暫停執行的時間間隔,以毫秒為單位。 如果此參數設為 0,接聽器會一直暫停執行,直到收到整個要求訊息為止。 0
++++HttpAsyncResponseCode 對於接聽器的非同步要求 HTTP 回應碼:
200 (OK)
202 (ACCEPTED)
202 (ACCEPTED)
++++URLsConfiguration 此為階層式內容,沒有值。其中,此接聽器支援的 URL 有一或多個配置,還可能包含 MIME 類型和 charset 值。 請注意,此為 ProtocolListenerFramework->ProtocolListeners -> HTTPListener1 階層式內容的子項內容。 如果未指定這個內容,接聽器會採用預設值。 ContextPath:/ Enabled:true Data handler MimeType:等於要求的 ContentType Charset:NONE。如需進一步資訊,請參閱HTTP 及 HTTPS 通訊協定接聽器處理程序
+++++URL1 此為階層式內容,沒有值。 其子項提供此接聽器支援的 URL 名稱。可能有多個支援的 URL。 請注意,您可以複製這個內容及其階層來插入其他的 URL。
++++++ContextPath 接聽器接收的 HTTP 要求的 URI。 在 URLsConfiguration 內容的 ContextPath 值之間,此值必須是唯一的。 否則,連接器會記載錯誤,且無法啟動。ContextPath 區分大小寫。不過,可能包含不區分大小寫的通訊協定、主機名稱及埠。 如果在 ContextPath 中指定通訊協定,則應該是 http。 如果指定主機,則應該等於 Host 接聽器內容的值。 如果指定埠,則應該等於 Port 接聽器內容的值。
++++++Enabled 這個內容的值決定連接器是否啟用母項 URL 階層式內容。 True
++++++TransformationRules 此為階層式內容,沒有值。含有一或多個轉換規則。

+++++++TransformationRule1 此為階層式內容,沒有值。 含有轉換規則。
++++++++ContentType 這個內容的值指定進入的要求的 ContentType, 此要求上應該套用特殊的處理 (資料處理常式 MIME 類型或 charset)。 如果 TransformationRuleN 階層式內容未指定 ContentType, 連接器會記載警告訊息,且忽略 TransformationRuleN 內容


在這個內容上指定特殊值
*/*,可讓通訊協定接聽器在任何 ContentType 上套用此規則。 請注意,如果接聽器發現共用 ContentType 的相同環境定義路徑有多個規則,接聽器會記載錯誤,且無法起始設定。


++++++++MimeType 呼叫資料處理常式來處理指定 ContentType 的要求時所用的 MIME 類型。
++++++++Charset 將指定 ContentType 的要求轉換成商業物件時所用的 Charset。

圖 18 顯示「連接器配置程式」中顯示的內容。

圖 18. HTTP(S) 通訊協定接聽器內容


ProxyServer

當網路使用 Proxy 伺服器時,請配置這個內容底下的值。 此為階層式內容,沒有值。 HTTP-HTTPS 通訊協定處理常式會使用這個內容底下指定的值。

圖 19 顯示「連接器配置程式」中出現的 ProxyServer 內容。

圖 19. ProxyServer 內容


HttpProxyHost

HTTP Proxy 伺服器的主機名稱。如果網路使用 Proxy 伺服器來處理 HTTP 通訊協定,請指定這個內容。

預設值 = 無

HttpProxyPort

連接器用來連接 HTTP Proxy 伺服器的埠號。

預設值 = 80

HttpNonProxyHosts

這個內容的值提供一或多部主機 (用於 HTTP),這些主機必須直接連接,並非透過 Proxy 伺服器來連接。 值可能是一份主機清單,每一部主機以 "|" 隔開。

預設值 = 無

HttpsProxyHost

HTTPS Proxy 伺服器的主機名稱。

預設值 = 無

HttpsProxyPort

連接器用來連接 HTTPS Proxy 伺服器的埠號。

預設值 = 443

HttpsNonProxyHosts

這個內容的值提供一或多部主機 (用於 HTTPS),這些主機必須直接連接,並非透過 Proxy 伺服器來連接。 值可能是一份主機清單,每一部主機以 "|" 隔開。

預設值 = 無

SocksProxyHost

Socks Proxy 伺服器的主機名稱。當網路使用 Socks Proxy 時,請指定這個內容。

註:
基礎的 JDK 必須支援 Socks。

預設值 = 無

SocksProxyPort

用來連接 Socks Proxy 伺服器的埠號。 當網路使用 Socks Proxy 時,請指定這個內容。

預設值 = 無

HttpProxyUsername

HTTP Proxy 伺服器的使用者名稱。如果要求的目標是 HTTP URL,且您指定 ProxyServer ->HttpProxyUsername, 則向 Proxy 進行鑑別時,HTTP-HTTPS 通訊協定處理常式會建立 Proxy-Authorization 標頭。 處理常式採用 CONNECT 方法來進行鑑別。

proxy-authentication 標頭為 base64 編碼,結構如下:


Proxy-Authorization: Basic
Base64EncodedString

處理常式會合併使用者名稱與密碼內容值,中間以冒號 (:) 隔開,建立 base64 編碼字串。

預設值 = 無

HttpProxyPassword

HTTP Proxy 伺服器的密碼。如需使用此值的詳細資訊,請參閱HttpProxyUsername

預設值 = 無

HttpsProxyUsername

HTTPS Proxy 伺服器的使用者名稱。如果要求的目標是 HTTPS URL,且您指定 ProxyServer ->HttpsProxyUsername, HTTP-HTTPS 通訊協定處理常式會建立 Proxy-Authorization 標頭,以利 Proxy 進行鑑別。 處理常式會合併 HttpsProxyUsername 與 HttpsProxyPassword 配置內容值,中間以冒號 (:) 隔開,建立 base64 編碼字串。

預設值 = 無

HttpsProxyPassword

HTTPS Proxy 伺服器的密碼。如需使用此值的詳細資訊,請參閱HttpsProxyUsername

預設值 = 無

SSL

指定這個內容底下的值來配置連接器的 SSL。 此為階層式內容,沒有值。

圖 20 顯示「連接器配置程式」中顯示的 SSL 內容。

圖 20. SSL 內容


SSLVersion

連接器使用的 SSL 版本。如需進一步資訊,請參閱 IBM JSSE 文件,瞭解支援的 SSL 版本。

預設值 = SSL

SSLDebug

如果這個內容的值設為 true, 連接器會將 javax.net.debug 系統內容的值設為 true。 IBM JSSE 利用這個內容來開啟追蹤機能。 如需進一步資訊,請參閱 IBM JSSE 文件。

預設值 = false

KeyStoreType

這個內容的值提供金鑰儲存庫和信任儲存庫的類型。 如需進一步資訊,請參閱 IBM JSSE 文件,瞭解有效的金鑰儲存庫類型。

預設值 = JKS

KeyStore

這個內容提供金鑰儲存庫檔的完整路徑。 如果未指定 KeyStore 及 (或) KeyStoreAlias 內容,則會忽略 KeyStorePassword、 KeyStoreAlias、TrustStore、TrustStorePassword 內容。 如果無法使用這個內容指定的路徑來載入金鑰儲存庫,連接器將無法啟動。 路徑必須是金鑰儲存庫檔的完整路徑。

預設值 = 無

KeyStorePassword

這個內容提供金鑰儲存庫中私密金鑰的密碼。

預設值 = 無

KeyStoreAlias

這個內容提供金鑰儲存庫中金鑰組的別名。 HTTPS 接聽器使用金鑰儲存庫中的這個私密金鑰。 呼叫的 HTTPS 服務需要用戶端鑑別時,HTTP-HTTPS 通訊協定處理常式也會使用金鑰儲存庫中的這個別名。 這個內容必須設為有效的 JSSE 別名。

預設值 = 無

TrustStore

這個內容提供信任儲存庫檔的完整路徑。 信任儲存庫用來儲存連接器信任的憑證。 信任儲存庫與金鑰儲存庫的類型必須相同。 您必須指定信任儲存庫檔的完整路徑。

預設值 = 無

TrustStorePassword

這個內容提供信任儲存庫的密碼。

預設值 = 無

UseClientAuth

這個內容指定是否使用 SSL 用戶端鑑別。 設為 true 時,HTTPS 接聽器會採取用戶端鑑別。

預設值 = false

建立多重通訊協定接聽器

您可以建立通訊協定接聽器的多個實例。 通訊協定接聽器配置為 ProtocolListenerFramework -> ProtocolListeners 連接器內容的子項內容。 ProtocolListenerFramework -> ProtocolListeners 的每一個子項, 代表連接器的一個獨特的通訊協定接聽器。 因此,您可以在 ProtocolListeners 內容下方配置新的子項內容,藉此建立其他通訊協定接聽器。 在新建立的接聽器內容中,請務必指定所有子項內容。 每一個接聽器必須採取唯一的命名。不過,您不必變更接聽器 Protocol 內容 (http https),對於一個接聽器的多個實例,這個內容都一樣。

註:
Protocol 內容扮演開關的角色,所以非常重要。 如果不要使用接聽器或處理常式,請將這個內容留白。

如果建立一個 HTTP 或 HTTPS 接聽器的多個實例, 則每一個實例必須指定不同的 Port 和 Host 內容。

一個處理常式無法建立多個實例。每一個通訊協定只能有一個處理常式。

Copyright IBM Corp. 1997, 2004