允許 Edge UI 存取本機 IP 位址

Edge UI 可能會在多個位置嘗試存取本機 IP 位址。這些本機 IP 位址可能對應到不應向外部使用者公開的私人或受保護資源：

  • Edge UI 中的 Trace 工具可向任何指定網址傳送及接收 API 要求。在某些部署情境中，Edge 元件與其他內部服務共同託管，惡意使用者可能會向私人 IP 位址提出要求，濫用追蹤工具的功能。
  • 從 OpenAPI 規格建立 API Proxy 時，規格會描述 API 的元素，例如基本路徑、路徑和動詞、標頭等。根據規格，惡意使用者可以指定參照私人 IP 位址的 Proxy 基本路徑。
  • 從本機檔案系統中的 WSDL 檔案建立 API Proxy 時。

基於安全考量，Edge UI 預設無法參照私人 IP 位址。私人 IP 位址清單包括：

  • 回送位址 (127.0.0.1 或 localhost)
  • 站點本機位址 (IPv4 - 10.0.0.0/8、172.16.0.0/12、192.168.0.0/16)
  • 任何本機位址 (解析為 localhost 的任何位址)。

如要啟用 Edge UI 存取私人 IP 位址，請設定下列權杖：

  • 追蹤工具的 conf_apigee-base_apigee.feature.enabletraceforinternaladdresses 屬性預設為停用。設為 true 即可啟用追蹤工具，存取私人 IP 位址。
  • 如果是 OpenAPI 規格，conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses 屬性預設為停用。設為 true 即可啟用私人 IP 位址的 OpenAPI 存取權。
  • 如果是 WSDL 檔案，conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses 屬性預設為停用。設為 true，即可啟用從私人 IP 位址上傳 WSDL 檔案的功能。

如要將這些屬性設為 true，請按照下列步驟操作：

  1. 在編輯器中開啟 ui.properties 檔案。如果檔案不存在，請建立檔案。
    vi /opt/apigee/customer/application/ui.properties
  2. 將下列屬性設為 true： 
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
conf_apigee-base_apigee.feature.enableopenapiforinternaladdresses="true"
conf_apigee-base_apigee.feature.enablewsdlforinternaladdresses="true"
  3. 將變更儲存至 ui.properties。
  4. 確認屬性檔案的擁有者是「apigee」使用者： 
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. 重新啟動 Edge UI： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Edge UI 現在可以存取本機 IP 位址。