配置 Web 預覽伺服器
您可以配置 Web 預覽伺服器和 proxy-config.xml 檔。
開始之前
重要: 本主題不適用於 WebSphere® Application Server 傳統版、Liberty 或 Liberty Core。僅適用於 Web 預覽伺服器。
程序
- 在「伺服器」視圖中,按兩下 Web 預覽伺服器以開啟伺服器編輯器。 您可以使用「概觀」及「安全」頁面來配置 Web 預覽伺服器。
- 在「概觀」頁面的「一般資訊」區段中,編輯伺服器名稱、主機名稱及執行時期環境。
- 在「通訊設定」區段中,指定要用於「Web 預覽伺服器」的預設埠號。 註: 如果預設埠已在使用中,Web 預覽伺服器會自動指派另一個可用的埠號。
- 在「發佈」區段中,選取下列其中一個設定:
選項 敘述 絕不自動發佈 工作台永不將檔案發佈至伺服器。 當資源變更時自動發佈 如果一個與伺服器相關聯的檔案所發生的變更已儲存,而且已過了「發佈間隔」設定中的完整時間間隔,工作台就會發佈。這是預設值。 建置事件之後自動發佈 如果一個需要建置且與伺服器相關聯的檔案所發生的變更已儲存,而且已過了「發佈間隔」設定中的完整時間間隔,工作台就會發佈。 發佈間隔(以秒為單位) 工作台在伺服器上發佈檔案之前的秒數。不過,如果在這個時間間隔完成之前,您又對檔案進行後續變更,就會延遲發佈,因為計時器已重設。只有在過了完整時間間隔之後,工作台才會發佈至伺服器。如果您將發佈間隔設為 0 秒,則儲存檔案的變更之後就會立即發佈檔案。 - 在「逾時」區段中,設定完成要求所需的時間量。
- AJAX Proxy 區段中包含的表格顯示存取 URL 及其相對應已解析的目標 URL。AJAX Proxy 區段有預設 Proxy 規則可處理存取 URL 直欄中列出的萬用字元 (proxy/http/*),可用於代理任何 URL。例如,您可以在 Web 瀏覽器中使用此 http://localhost:8080/proxy/http/google.com URL 來載入 Google 網頁。透過 Proxy 對映此要求與直接對 http://www.google.com 發出要求,結果都一樣。 提示: 您可以用滑鼠右鍵按一下 AJAX Proxy URL 表格中的一列,並複製「存取 URL」,例如 proxy/us/en, 再貼到 JavaScript 程式碼中。
- 按一下配置 Proxy URL 鏈結來編輯 proxy-config.xml。
- 在「AJAX Proxy 配置」編輯器中,新增 Proxy 規則以對映至遠端網域。選取 Proxy 規則節點,然後按一下新增。
- 在「新增項目」視窗中,選取下列其中一個項目,並在編輯器中編輯其屬性:
選項 敘述 對映 根據環境定義路徑,將送入的要求對映至目標 URL。 指定環境定義路徑屬性及選用的 URL 屬性。例如,您可以將 /ibmproducts 的環境定義路徑設為 URL http://www.ibm.com/products。
如果送入的 Proxy URL 是 http://mywebsite.com/ibmproducts/us/en,Proxy 會將要求轉遞至 http://www.ibm.com/products/us/en。 在您套用相符的存取原則之前,Proxy 會解析環境定義路徑對映。提供兩個預設 Proxy 對映支援快速原型設計,即 http/* 和 us/en。
Meta 資料 指定 Proxy 的一般配置內容,例如 HTTP 相關的參數。Proxy 編輯器提供一些常見的 meta 資料選項及預設的名稱/值配對: - forward-http-errors
- 依預設,AJAX Proxy 只轉遞大於或等於 200 且小於 400 的 HTTP 狀態碼。落在此範圍外的狀態碼會自動變更為「404 找不到檔案」錯誤。您可以將 forward-http-errors 參數設為 true,以隨著訊息轉遞大於或等於 400 的 HTTP 代碼。
- unsigned_ssl_certificate_support
- 未簽署的憑證通常用於受保護的 REST 服務。當啟用 unsigned_ssl_certificate_support 時,AJAX Proxy 會接受任何 SSL 憑證。 此選項在測試和除錯時很有用。 請勿在正式作業環境中使用此選項。
- basic-auth-support
- 如果目標服務使用基本鑑別,請將此選項設為 true。 HTTP 狀態碼 401(未獲授權)會導致「403:禁止」HTTP 代碼,除非該特定要求已啟用 basic-auth-support 屬性。
- maxconnectionsperhost
- maxconnectionperhost 是廣域值,指定任何主機或埠組合保持作用中的連線數上限。 此值預設為 2。如果應用程式存取兩個以上的遠端網站來取得內容,請提高此值。
- maxtotalconnections
- maxtotalconnections 是 Proxy 支援的連線總數上限。預設值為 5。您選擇的值必須足以支援您可能同時收到的連線數。在實務上,應該考量 Web 儲存器如何配置及儲存器支援的同時連線數。
- socket-timeout
- socket-timeout 定義建立連線之後等待資料的預設 Socket 逾時(毫秒)。預設的逾時值為 0,可解讀為無限逾時。
- retries
- retries 參數定義 AJAX Proxy 在放棄建立連線之前執行的 Socket 重試次數。 預設值為 2。
- connection-timeout
- connection-timeout 定義建立連線之前的時間(毫秒)。 如果未指定值,則會使用預設值 60000。如果使用 0,此值會解讀成未使用逾時。
原則 定義給定的 URL 型樣的存取原則。 - 在 ACF 欄位中,開啟或關閉作用中的內容過濾。作用中的內容過濾會從瀏覽器顯示的應用程式內容中,移除可能惡意的作用中內容。
- 在 URL 屬性欄位中指定型樣。針對每一個送入的要求,Proxy 會以最符合的 URL 來套用原則。如果找不到相符的原則,Proxy 會拒絕要求。如果找到原則,則會套用 policy 元素的子元素來檢查是否接受要求。
- 開啟或關閉基本鑑別盤查的支援。
您可以編輯下列原則子元素:- 動作方法
- 至少指定一個支援的 HTTP 方法。AJAX Proxy 支援 GET、POST、PUT、HEAD 或 DELETE 要求。
- Cookie
- 定義 Cookie 名稱的清單,以識別您希望 Proxy 轉遞至目標網域的 Cookie。為了轉遞 Cookie,Proxy 會根據定義的 Cookie 名稱來過濾 Cookie 標頭的值。
- HTTP 標頭
- 定義您希望 Proxy 轉遞至目標網域的標頭名稱清單。標頭名稱可以包含萬用字元。
- MIME 類型
- 指定接受的 MIME 類型清單。MIME 類型是指 Proxy 從目標伺服器收到的回應。如果至少指定一個 MIME 類型,則 Proxy 只會接受 Content-Type 回應標頭符合其中一個指定的 MIME 類型的回應。如果未指定 MIME 類型,則 Proxy 會接受所有回應。
- 使用者
- 指定使用者或使用者群組的清單。比方說,如果您指定 AllAuthenticatedUsers,Proxy 會驗證要求是由已鑑別使用者所傳送。
- 「AJAX Proxy 金鑰儲存庫」區段顯示 AJAX Proxy 使用的金鑰儲存庫的相關資訊,例如金鑰儲存庫路徑和類型。
如果目標伺服器在 URL 上使用未授信 SSL 憑證,您可以在金鑰儲存庫中新增或移除 SSL 憑證,以利用 AJAX Proxy 從這些 URL 擷取資訊。
如果 URL 指向使用未授信憑證的伺服器,當您匯入此 URL 的 SSL 憑證之後,您就可以使用 AJAX Proxy 來存取此 URL,而不會收到錯誤訊息。
- 選擇性的: 如果已使用從另一個供應商取得的軟體來變更金鑰儲存庫密碼,請在金鑰儲存庫密碼欄位中更新密碼。
- 在金鑰儲存庫路徑欄位所指定的金鑰儲存庫中新增或移除 SSL 伺服器憑證。
- 按一下管理金鑰儲存庫項目。「管理金鑰儲存庫」視窗會開啟,並顯示現行金鑰儲存庫項目的清單,依別名識別每一個項目。
- 如果要移除金鑰儲存庫項目,請從金鑰儲存庫項目清單中選取項目,然後按一下移除項目。
- 如果要新增金鑰儲存庫項目,請按一下新增項目。 這時會開啟「匯入憑證」視窗。
- 在項目別名欄位中,指定新金鑰儲存庫項目的別名。
- 指定您想要從伺服器還是本端系統匯入 SSL 憑證。
- 從伺服器將憑證匯入至金鑰儲存庫
- 輸入伺服器的 URL,從其中匯入 SSL 憑證。
- 將本端憑證匯入至金鑰儲存庫
- 按一下瀏覽憑證,在本端系統上找出您要匯入的 SSL 憑證。
- 按一下確定以儲存變更,並關閉「匯入憑證」視窗。在「管理金鑰儲存庫」視窗中,按一下確定,將您所有的變更儲存至金鑰儲存庫。
- 在「安全」頁面中,配置下列設定。
區段 說明 一般 啟用或停用 Web 應用程式的安全;檢閱已部署在 Web 預覽伺服器的現行專案。 註: 您必須對部署在 Web 預覽伺服器的 Web 應用程式啟用安全。 您可以在想要部署至伺服器的 Web 專案所包含的 WebContent/WEB-INF/web.xml 檔中配置安全。使用者和群組 管理 Web 預覽伺服器上登錄的使用者和群組。 - 在伺服器上登錄新的使用者。
- 從伺服器移除使用者。
- 在伺服器上登錄新的群組。
- 在已登錄的群組中新增或移除使用者。
- 從伺服器移除群組。
安全角色 管理 Web 預覽伺服器上登錄的安全角色。 - 在伺服器上登錄安全角色。
- 從伺服器移除安全角色。
- 將安全角色對映至使用者。
- 從使用者移除安全角色。
- 將安全角色對映至群組。
- 從群組移除安全角色。
- 儲存變更。
上層主題: 在「Web 預覽伺服器」上測試
上層主題: 配置伺服器以進行測試和發佈