本節說明如何使用 LDAP 或 SAML 等 IDP，從傳統版 UI 遷移至 Edge UI。
如需詳細資訊，請參閱：
誰可以執行遷移作業
如要遷移至 Edge UI，您必須以原先安裝 Edge 的使用者或超級使用者身分登入。執行 Edge UI 的安裝程式後，任何使用者都可以進行設定。
事前準備
從傳統版 UI 遷移至 Edge UI 前，請先詳閱下列一般指南：
- 備份現有的傳統版 UI 節點
Apigee 建議您先備份現有的傳統版 UI 伺服器，再進行更新。
- 通訊埠/防火牆
傳統版 UI 預設使用通訊埠 9000。Edge UI 使用通訊埠 3001。
- 新增 VM
Edge UI 無法與傳統版 UI 安裝在同一個 VM。
如要安裝 Edge UI，您必須在設定中新增機器。如要使用與傳統版 UI 相同的機器，則必須完全解除安裝傳統版 UI。
- 識別資訊提供者 (LDAP 或 SAML)
Edge UI 會使用 SAML 或 LDAP IDP 驗證使用者：
- LDAP：如果是 LDAP，您可以使用外部 LDAP IDP，也可以使用與 Edge 一併安裝的內部 OpenLDAP 實作。
- SAML：SAML IDP 必須是外部 IDP。
詳情請參閱「安裝及設定 IDP」。
- 相同 IDP
本節假設您在遷移後會使用相同的 IDP。舉例來說，如果您目前使用外部 LDAP IDP 搭配傳統版 UI，則會繼續使用外部 LDAP IDP 搭配 Edge UI。
使用內部 LDAP IDP 遷移
在採用內部 LDAP 實作 (OpenLDAP) 做為 IDP 的設定中，從傳統版 UI 遷移至 Edge UI 時，請遵循下列規範：
- 間接繫結設定
請按照這些操作說明安裝 Edge UI，並對自動設定檔進行下列變更：
將 LDAP 設為使用搜尋和繫結 (間接)，如以下範例所示：
SSO_LDAP_PROFILE=indirect SSO_LDAP_BASE_URL=ldap://localhost:10389 SSO_LDAP_ADMIN_USER_DN=uid=admin,ou=users,ou=global,dc=apigee,dc=com SSO_LDAP_ADMIN_PWD=Secret123 SSO_LDAP_SEARCH_BASE=dc=apigee,dc=com SSO_LDAP_SEARCH_FILTER=mail={0} SSO_LDAP_MAIL_ATTRIBUTE=mail - Management API 的基本驗證
啟用 Apigee SSO 後，所有 LDAP 使用者預設仍可使用 API 的基本驗證功能。您可以選擇停用基本驗證，詳情請參閱「在 Edge 停用基本驗證」。
- Management API 的 OAuth2 驗證
啟用 SSO 時，系統會啟用權杖式驗證。
- 新使用者/密碼流程
您必須使用 API 建立新使用者，因為密碼流程將無法在 Edge UI 中運作。
使用外部 LDAP IDP 遷移
在採用「外部」LDAP 實作做為 IDP 的設定中，從傳統版 UI 遷移至 Edge UI 時，請遵循下列指南：
- LDAP 設定
請按照這些操作說明安裝 Edge UI。您可以在靜默設定檔中設定直接或間接繫結。
- 管理伺服器設定
啟用 Apigee SSO 後，請移除
/opt/apigee/customer/application/management-server.properties檔案中定義的所有外部 LDAP 屬性，然後重新啟動管理伺服器。 - Management API 的基本驗證
基本驗證適用於機器使用者，但不適用於 LDAP 使用者。如果您的 CI/CD 程序仍使用基本驗證存取系統，這些資訊就非常重要。
- Management API 的 OAuth2 驗證
LDAP 使用者只能使用權杖存取 Management API。
使用外部 SAML IDP 遷移
遷移至 Edge UI 時，SAML IDP 的安裝操作說明不會有任何變更。