本節說明如何使用以下內容,從傳統版 UI 遷移至 Edge UI: IDP,例如 LDAP 或 SAML。
如需詳細資訊,請參閱:
哪些人可以執行遷移作業
如要遷移至 Edge UI,您必須以最初安裝 邊緣使用者或超級使用者執行 Edge UI 安裝程式後,任何使用者都可以設定 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」。
- 相同的 ID 提供者
本節假設您會在遷移後使用相同的 IdP。舉例來說,如果您在 目前將外部 LDAP IDP 與傳統版 UI 搭配使用,則您將繼續使用 和 Edge UI 之間的外部 LDAP IDP
使用內部 LDAP IdP 進行遷移
請按照以下指南操作,從傳統版 UI 遷移至 Edge UI: 使用「內部」LDAP 實作 (OpenLDAP) 做為 IdP:
- 間接繫結設定
使用以下指令安裝 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
- 管理 API 的基本驗證
啟用 Apigee 單一登入功能後,API 的基本驗證功能預設會繼續為所有 LDAP 使用者運作。您可以選擇停用基本驗證功能,如在 Edge 上停用基本驗證一文所述。
- 管理 API 的 OAuth2 驗證
啟用 SSO 後,系統就會啟用憑證驗證功能。
- 新使用者/密碼流程
由於 Edge 中無法再使用密碼流程,因此您必須使用 API 建立新使用者 第一種是使用無代碼解決方案 AutoML 透過使用者介面建立機器學習模型
使用外部 LDAP IDP 進行遷移
請按照以下指南操作,從傳統版 UI 遷移至 Edge UI: 設定使用「外部」 LDAP 實作做為 IdP:
- LDAP 設定
使用以下指令安裝 Edge UI 操作說明。您可以在靜默設定檔中設定直接或間接繫結。
- 管理伺服器設定
啟用 Apigee 單一登入 (SSO) 後,請移除所有 外部 LDAP 定義屬性 (請參閱
/opt/apigee/customer/application/management-server.properties
檔案,然後重新啟動 Management Server。 - 管理 API 的基本驗證
基本驗證功能適用於電腦使用者,但不適用於 LDAP 使用者。如果貴機構 你的 CI/CD 程序仍使用基本驗證功能來存取系統。
- 管理 API 的 OAuth2 驗證
LDAP 使用者只能透過權杖存取管理 API。
使用外部 SAML IDP 進行遷移
遷移至 Edge UI 時,安裝操作說明不會有任何異動 。