配置 Web 預覽伺服器

您可以配置 Web 預覽伺服器和 proxy-config.xml 檔。

開始之前

重要: 本主題不適用於 WebSphere® Application Server 傳統版、Liberty 或 Liberty Core。僅適用於 Web 預覽伺服器。

程序

  1. 在「伺服器」視圖中,按兩下 Web 預覽伺服器以開啟伺服器編輯器。 您可以使用「概觀」及「安全」頁面來配置 Web 預覽伺服器。
  2. 在「概觀」頁面的「一般資訊」區段中,編輯伺服器名稱、主機名稱及執行時期環境。
  3. 在「通訊設定」區段中,指定要用於「Web 預覽伺服器」的預設埠號。
    註: 如果預設埠已在使用中,Web 預覽伺服器會自動指派另一個可用的埠號。
  4. 在「發佈」區段中,選取下列其中一個設定:
    選項 敘述
    絕不自動發佈 工作台永不將檔案發佈至伺服器。
    當資源變更時自動發佈 如果一個與伺服器相關聯的檔案所發生的變更已儲存,而且已過了「發佈間隔」設定中的完整時間間隔,工作台就會發佈。這是預設值。
    建置事件之後自動發佈 如果一個需要建置且與伺服器相關聯的檔案所發生的變更已儲存,而且已過了「發佈間隔」設定中的完整時間間隔,工作台就會發佈。
    發佈間隔(以秒為單位) 工作台在伺服器上發佈檔案之前的秒數。不過,如果在這個時間間隔完成之前,您又對檔案進行後續變更,就會延遲發佈,因為計時器已重設。只有在過了完整時間間隔之後,工作台才會發佈至伺服器。如果您將發佈間隔設為 0 秒,則儲存檔案的變更之後就會立即發佈檔案。
  5. 在「逾時」區段中,設定完成要求所需的時間量。
  6. 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 程式碼中。
  7. 按一下配置 Proxy URL 鏈結來編輯 proxy-config.xml。
  8. 在「AJAX Proxy 配置」編輯器中,新增 Proxy 規則以對映至遠端網域。選取 Proxy 規則節點,然後按一下新增。
  9. 在「新增項目」視窗中,選取下列其中一個項目,並在編輯器中編輯其屬性:
    選項 敘述
    對映 根據環境定義路徑,將送入的要求對映至目標 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 型樣的存取原則。
    1. 在 ACF 欄位中,開啟或關閉作用中的內容過濾。作用中的內容過濾會從瀏覽器顯示的應用程式內容中,移除可能惡意的作用中內容。
    2. 在 URL 屬性欄位中指定型樣。針對每一個送入的要求,Proxy 會以最符合的 URL 來套用原則。如果找不到相符的原則,Proxy 會拒絕要求。如果找到原則,則會套用 policy 元素的子元素來檢查是否接受要求。
    3. 開啟或關閉基本鑑別盤查的支援。
    您可以編輯下列原則子元素:
    動作方法
    至少指定一個支援的 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 會驗證要求是由已鑑別使用者所傳送。
  10. 「AJAX Proxy 金鑰儲存庫」區段顯示 AJAX Proxy 使用的金鑰儲存庫的相關資訊,例如金鑰儲存庫路徑和類型。 如果目標伺服器在 URL 上使用未授信 SSL 憑證,您可以在金鑰儲存庫中新增或移除 SSL 憑證,以利用 AJAX Proxy 從這些 URL 擷取資訊。 如果 URL 指向使用未授信憑證的伺服器,當您匯入此 URL 的 SSL 憑證之後,您就可以使用 AJAX Proxy 來存取此 URL,而不會收到錯誤訊息。
    1. 選擇性的: 如果已使用從另一個供應商取得的軟體來變更金鑰儲存庫密碼,請在金鑰儲存庫密碼欄位中更新密碼。
    2. 在金鑰儲存庫路徑欄位所指定的金鑰儲存庫中新增或移除 SSL 伺服器憑證。
      1. 按一下管理金鑰儲存庫項目。「管理金鑰儲存庫」視窗會開啟,並顯示現行金鑰儲存庫項目的清單,依別名識別每一個項目。
      2. 如果要移除金鑰儲存庫項目,請從金鑰儲存庫項目清單中選取項目,然後按一下移除項目。
      3. 如果要新增金鑰儲存庫項目,請按一下新增項目。 這時會開啟「匯入憑證」視窗。
      4. 在項目別名欄位中,指定新金鑰儲存庫項目的別名。
      5. 指定您想要從伺服器還是本端系統匯入 SSL 憑證。
        從伺服器將憑證匯入至金鑰儲存庫
        輸入伺服器的 URL,從其中匯入 SSL 憑證。
        將本端憑證匯入至金鑰儲存庫
        按一下瀏覽憑證,在本端系統上找出您要匯入的 SSL 憑證。
      6. 按一下確定以儲存變更,並關閉「匯入憑證」視窗。在「管理金鑰儲存庫」視窗中,按一下確定,將您所有的變更儲存至金鑰儲存庫。
  11. 在「安全」頁面中,配置下列設定。
    區段 說明
    一般 啟用或停用 Web 應用程式的安全;檢閱已部署在 Web 預覽伺服器的現行專案。
    註: 您必須對部署在 Web 預覽伺服器的 Web 應用程式啟用安全。 您可以在想要部署至伺服器的 Web 專案所包含的 WebContent/WEB-INF/web.xml 檔中配置安全。
    使用者和群組 管理 Web 預覽伺服器上登錄的使用者和群組。
    • 在伺服器上登錄新的使用者。
    • 從伺服器移除使用者。
    • 在伺服器上登錄新的群組。
    • 在已登錄的群組中新增或移除使用者。
    • 從伺服器移除群組。
    安全角色 管理 Web 預覽伺服器上登錄的安全角色。
    • 在伺服器上登錄安全角色。
    • 從伺服器移除安全角色。
    • 將安全角色對映至使用者。
    • 從使用者移除安全角色。
    • 將安全角色對映至群組。
    • 從群組移除安全角色。
  12. 儲存變更。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tconfigajaxtestserver.html