Apigee Edge for Private Cloud 4.54.00 以降では、従来の UI（edge-ui）が削除され、新しい Edge UI（edge-management-ui）がデフォルトの管理インターフェースになります。
このセクションでは、従来の UI から新しい Edge UI への移行に関するガイダンスを提供します。これには、
IDP を使用するデプロイも含まれます。
詳しくは以下をご覧ください。
移行を実行できるユーザー
新しい Edge UI に移行するには、Edge を最初にインストールしたユーザーまたは root ユーザーとしてログインする必要があります。新しい Edge UI のインストーラを実行すると、承認されたユーザーは誰でも構成できます。
始める前に
従来の UI から新しい Edge UI に移行する前に、次の一般的なガイドラインをお読みください。
- 既存の従来の UI 構成をバックアップする
4.54.00 にアップグレードする前に、既存の従来の UI 構成ファイルをバックアップして、カスタム設定（SMTP、TLS、セッションのタイムアウト、ブランディング プロパティなど）を
/opt/apigee/customer/application/management-ui.propertiesに移行することをおすすめします。 - ポート/ファイアウォール
デフォルトでは、従来の UI はポート 9000 を使用していました。新しい Edge UI はポート 3001 を使用します（
conf_uebe_portを使用して構成可能）。 - クラシック UI を削除する
従来の UI をホストしていたノードに新しい Edge UI をインストールする場合は、新しい Edge UI（
edge-management-ui）をインストールする前に、従来の UI（edge-ui）をアンインストールします。 - 認証（基本認証、LDAP、SAML）
Edge for Private Cloud 4.54.00 では、新しい Edge UI は、基本認証（
AUTH_MODE=basic）と Apigee SSO（AUTH_MODE=sso）による外部 IDP 認証の両方をサポートしています。- 基本認証: SSO を必要とせずに、内部 OpenLDAP
（
apigee-openldap）実装を使用します。 - LDAP IDP（Apigee SSO を使用）: 外部 LDAP IDP または内部 OpenLDAP（
apigee-openldap）実装を Apigee SSO で使用します。 - SAML IDP（Apigee SSO を使用）: Apigee SSO で外部 SAML IDP を使用します。
詳しくは、IDP をインストールして構成するをご覧ください。
- 基本認証: SSO を必要とせずに、内部 OpenLDAP
（
- 同じ 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 をインストールして構成します。
- Management API の基本認証
Apigee SSO が有効になっている場合、API の基本認証はデフォルトで引き続きすべての LDAP ユーザーに対して機能します。必要に応じて、Edge で基本認証を無効にするの説明に沿って 、基本 認証を無効にできます。
- Management API の OAuth2 認証
Apigee SSO を有効にすると、トークンベースの認証が有効になります。
外部 LDAP IDP を使用して移行する
IDP として 外部 LDAP 実装を使用する構成で、従来の UI から新しい Edge UI に移行する場合は、次のガイドラインを使用します。
- LDAP 構成
新しい Edge UI を構成する、 Apigee SSO をインストールして構成する、 LDAP IDP を構成するの手順に沿って、Apigee SSO と新しい Edge UI を構成します。
- Management Server の構成
Apigee SSO を有効にしたら、従来の UI の外部 LDAP プロパティを
/opt/apigee/customer/application/management-server.propertiesファイルから削除し、Management Server を再起動します。 - Management API の基本認証
基本認証はマシンユーザーに対しては機能しますが、外部 LDAP ユーザーに対しては機能しません。 CI/CD プロセスで基本認証を使用してシステムにアクセスする場合は、これが重要になります。
- Management API の OAuth2 認証
外部 LDAP ユーザーは、OAuth2 トークンを使用して Management API にアクセスします。
外部 SAML IDP を使用して移行する
新しい Edge UI に移行する場合、SAML IDP のインストール手順に変更はありません。SAML IDP を構成するをご覧ください。