遷移至新版 Edge UI

自 Apigee Edge for Private Cloud 4.54.00 起，傳統版 UI (edge-ui) 已移除，新版 Edge UI (edge-management-ui) 則為預設管理介面。本節提供從傳統版 UI 遷移至新版 Edge UI 的指南，包括使用 LDAP 或 SAML 等 IDP 的部署作業。

如需詳細資訊，請參閱：

誰可以執行遷移作業

如要遷移至新版 Edge UI，您必須以原先安裝 Edge 的使用者或超級使用者身分登入。執行新版 Edge UI 的安裝程式後，任何授權使用者都可以進行設定。

事前準備

從傳統版使用者介面遷移至新版 Edge 使用者介面前，請先詳閱下列一般指南：

  • 備份現有的傳統版使用者介面設定

    升級至 4.54.00 版前，Apigee 建議您備份現有的傳統使用者介面設定檔，以便將自訂設定 (例如 SMTP、TLS、工作階段逾時和品牌宣傳屬性) 轉移至 /opt/apigee/customer/application/management-ui.properties。

  • 通訊埠/防火牆

    根據預設，傳統版 UI 使用通訊埠 9000。新版 Edge UI 使用通訊埠 3001 (可使用 conf_uebe_port 設定)。

  • 移除傳統 UI

    如果要在先前代管舊版 UI 的節點上安裝新版 Edge UI，請先解除安裝舊版 UI (edge-ui)，再安裝新版 Edge UI (edge-management-ui)。

  • 驗證 (基本驗證、LDAP 或 SAML)

    在 Edge for Private Cloud 4.54.00 中，新版 Edge UI 支援基本驗證 (AUTH_MODE=basic) 和透過 Apigee SSO 進行外部 IDP 驗證 (AUTH_MODE=sso)：

    • 基本驗證：使用內部 OpenLDAP (apigee-openldap) 實作項目，不需要 SSO。
    • LDAP IDP (使用 Apigee SSO)：使用外部 LDAP IDP 或內部 OpenLDAP (apigee-openldap) 實作項目搭配 Apigee SSO。
    • SAML IDP (使用 Apigee SSO)：搭配 Apigee SSO 使用外部 SAML IDP。

    詳情請參閱「安裝及設定 IDP」。

  • 相同 IDP

    本節假設您在遷移後會使用相同的 IDP。舉例來說，如果您先前使用傳統版 UI 搭配外部 LDAP IDP，則會繼續使用新版 Edge UI 搭配外部 LDAP IDP。

使用內部 LDAP IDP 遷移

如果您使用內部 OpenLDAP (apigee-openldap) 實作，可以直接在新版 Edge UI 中使用基本驗證 (請參閱「設定新版 Edge UI」)，或按照下列指南，使用內部 LDAP 設定 Apigee SSO：

  • LDAP 和新版 Edge UI 設定

    使用「設定新版 Edge UI」、「安裝及設定 Apigee SSO」和「設定 LDAP IDP」安裝及設定新版 Edge UI 和 Apigee SSO。

  • 管理 API 的基本驗證

    啟用 Apigee SSO 後，所有 LDAP 使用者預設仍可使用 API 的基本驗證功能。您可以視需要停用基本驗證，詳情請參閱「在 Edge 上停用基本驗證」。

  • Management API 的 OAuth2 驗證

    啟用 Apigee SSO 時，系統會啟用權杖式驗證。

使用外部 LDAP IDP 遷移

在採用「外部」LDAP 實作做為 IDP 的設定中，從傳統版 UI 遷移至新版 Edge UI 時，請遵循下列指南：

  • LDAP 設定

    使用「設定 New Edge 使用者介面」、「安裝及設定 Apigee SSO」和「設定 LDAP IDP」，設定 Apigee SSO 和 New Edge 使用者介面。

  • 管理伺服器設定

    啟用 Apigee SSO 後，請從 /opt/apigee/customer/application/management-server.properties 檔案中移除所有舊版 Classic UI 外部 LDAP 屬性，然後重新啟動管理伺服器。

  • Management API 的基本驗證

    基本驗證適用於機器使用者，但不適用於外部 LDAP 使用者。如果您的 CI/CD 程序使用基本驗證機制存取系統，這項設定就非常重要。

  • Management API 的 OAuth2 驗證

    外部 LDAP 使用者會使用 OAuth2 權杖存取 Management API。

使用外部 SAML IDP 遷移

遷移至新版 Edge UI 時，SAML IDP 的安裝說明不會有任何變更。請參閱「設定 SAML IdP」。