Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Edge UI に移行する

このセクションでは、LDAP や SAML などの IDP を使用して Classic UI から Edge UI に移行するためのガイダンスを提供します。

詳しくは以下をご覧ください。

移行を実行できるユーザー

Edge UI に移行するには、Edge を最初にインストールしたユーザーまたは root ユーザーとしてログインする必要があります。Edge UI のインストーラを実行した後は、すべてのユーザーがそれを構成できます。

Classic UI から Edge UI に移行する前に、次の一般的なガイドラインをお読みください。

既存の Classic UI ノードをバックアップする
更新する前に、既存の Classic UI サーバーをバックアップすることをおすすめします。
ポート/ファイアウォール
デフォルトでは、Classic UI はポート 9000 を使用します。Edge UI はポート 3001 を使用します。
新しい VM
Edge UI は、Classic UI と同じ VM にインストールできません。

Edge UI をインストールするには、構成に新しいマシンを追加する必要があります。Classic UI と同じマシンを使用する場合は、Classic UI を完全にアンインストールする必要があります。
ID プロバイダ（LDAP または SAML）
Edge UI は、SAML または LDAP の IDP を使用してユーザーを認証します。
- LDAP: LDAP の場合、外部 LDAP IDP を使用するか、Edge とともにインストールされる内部 OpenLDAP 実装を使用できます。
- SAML: SAML IDP は外部 IDP である必要があります。
詳細については、IDP をインストールして構成するをご覧ください。
同じ IDP
このセクションでは、移行後も同じ IDP を使用することを前提としています。たとえば、現在 Classic UI で外部 LDAP IDP を使用している場合は、Edge UI でも外部 LDAP IDP を引き続き使用します。

内部 LDAP 実装（OpenLDAP）を IDP として使用する構成で、Classic 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 が有効になっている場合、API の基本認証は、デフォルトですべての LDAP ユーザーに対して引き続き機能します。Edge で Basic 認証を無効にするの説明に従って、必要に応じて Basic 認証を無効にできます。
Management API の OAuth2 認証
トークンベースの認証は、SSO を有効にすると有効になります。
新規ユーザー/パスワードフロー
パスワードフローは Edge UI で機能しなくなるため、API を使用して新しいユーザーを作成する必要があります。

外部 LDAP 実装を IDP として使用する構成で、Classic UI から Edge UI に移行する場合は、次のガイドラインを使用します。

LDAP 構成
こちらの手順に沿って Edge UI をインストールします。サイレント構成ファイルで直接バインディングまたは間接バインディングを構成できます。
Management Server の構成
Apigee SSO を有効にした後、/opt/apigee/customer/application/management-server.properties ファイルで定義されているすべての外部 LDAP プロパティを削除し、Management Server を再起動する必要があります。
Management API の基本認証
基本認証はマシンユーザーに対しては機能しますが、LDAP ユーザーに対しては機能しません。CI/CD プロセスでシステムへのアクセスに基本認証が引き続き使用されている場合は、これらが重要になります。
Management API の OAuth2 認証
LDAP ユーザーは、トークンのみを使用して Management API にアクセスできます。

Edge UI に移行する場合、SAML IDP のインストール手順に変更はありません。