Zur neuen Edge-Benutzeroberfläche migrieren

Ab Apigee Edge for Private Cloud 4.54.00 wird die klassische Benutzeroberfläche (edge-ui) entfernt und die neue Edge-Benutzeroberfläche (edge-management-ui) ist die Standardverwaltungsoberfläche. In diesem Abschnitt finden Sie eine Anleitung zur Migration von der klassischen Benutzeroberfläche zur neuen Edge-Benutzeroberfläche, einschließlich Bereitstellungen, die einen IDP wie LDAP oder SAML verwenden.

Weitere Informationen finden Sie unter:

Wer kann die Migration durchführen?

Wenn Sie zur neuen Edge-Benutzeroberfläche migrieren möchten, müssen Sie als der Nutzer angemeldet sein, der Edge ursprünglich installiert hat, oder als Root-Nutzer. Nachdem Sie das Installationsprogramm für die neue Edge-Benutzeroberfläche ausgeführt haben, kann jeder autorisierte Nutzer sie konfigurieren.

Hinweis

Lesen Sie vor der Migration von der klassischen Benutzeroberfläche zur neuen Edge-Benutzeroberfläche die folgenden allgemeinen Richtlinien:

  • Vorhandene Konfiguration der klassischen Benutzeroberfläche sichern

    Bevor Sie auf 4.54.00 aktualisieren, empfiehlt Apigee, die vorhandenen Konfigurationsdateien der klassischen Benutzeroberfläche zu sichern, damit Sie benutzerdefinierte Einstellungen (z. B. SMTP-, TLS-, Zeitlimit für Sitzungen, und Branding-Properties) in /opt/apigee/customer/application/management-ui.properties übernehmen können.

  • Ports/Firewalls

    Standardmäßig wurde für die klassische Benutzeroberfläche Port 9000 verwendet. Die neue Edge-Benutzeroberfläche verwendet Port 3001 (konfigurierbar mit conf_uebe_port).

  • Klassische Benutzeroberfläche entfernen

    Wenn Sie die neue Edge-Benutzeroberfläche auf einem Knoten installieren, auf dem zuvor die klassische Benutzeroberfläche gehostet wurde, deinstallieren Sie die klassische Benutzeroberfläche (edge-ui), bevor Sie die neue Edge-Benutzeroberfläche (edge-management-ui) installieren.

  • Authentifizierung (Basisauthentifizierung, LDAP oder SAML)

    In Edge for Private Cloud 4.54.00 unterstützt die neue Edge-Benutzeroberfläche sowohl die Basis authentifizierung (AUTH_MODE=basic) als auch die Authentifizierung über einen externen IDP über Apigee SSO (AUTH_MODE=sso):

    • Basisauthentifizierung: Verwendet die interne OpenLDAP (apigee-openldap)-Implementierung, ohne dass SSO erforderlich ist.
    • LDAP-IDP (mit Apigee SSO): Verwendet entweder einen externen LDAP-IDP oder die interne OpenLDAP (apigee-openldap) Implementierung mit Apigee SSO.
    • SAML-IDP (mit Apigee SSO): Verwendet einen externen SAML-IDP mit Apigee SSO.

    Weitere Informationen finden Sie unter IDPs installieren und konfigurieren.

  • Gleicher IDP

    In diesem Abschnitt wird davon ausgegangen, dass Sie nach der Migration denselben IDP verwenden. Wenn Sie beispielsweise zuvor einen externen LDAP-IDP mit der klassischen Benutzeroberfläche verwendet haben, verwenden Sie weiterhin einen externen LDAP-IDP mit der neuen Edge-Benutzeroberfläche.

Mit einem internen LDAP-IDP migrieren

Wenn Sie die interne OpenLDAP (apigee-openldap) Implementierung verwenden, können Sie entweder die Basisauthentifizierung direkt in der neuen Edge Benutzeroberfläche verwenden (siehe Neue Edge-Benutzeroberfläche konfigurieren) oder Apigee SSO mit internem LDAP gemäß den folgenden Richtlinien konfigurieren:

Mit einem externen LDAP-IDP migrieren

Beachten Sie die folgenden Richtlinien, wenn Sie in einer Konfiguration, die eine externe LDAP-Implementierung als IDP verwendet, von der klassischen Benutzeroberfläche zur neuen Edge-Benutzeroberfläche migrieren:

  • LDAP-Konfiguration

    Konfigurieren Sie Apigee SSO und die neue Edge-Benutzeroberfläche gemäß den Anleitungen unter Neue Edge-Benutzeroberfläche konfigurieren, Apigee SSO installieren und konfigurieren, und LDAP-IDP konfigurieren.

  • Management Server-Konfiguration

    Nachdem Sie Apigee SSO aktiviert haben, entfernen Sie alle Legacy-Properties für externe LDAP-Konfigurationen der klassischen Benutzeroberfläche aus der Datei /opt/apigee/customer/application/management-server.properties und starten Sie den Management Server neu.

  • Basisauthentifizierung für die Management API

    Die Basisauthentifizierung funktioniert für Maschinenkonten, aber nicht für externe LDAP-Nutzer. Dies ist wichtig, wenn Ihr CI/CD Prozess die Basisauthentifizierung für den Zugriff auf das System verwendet.

  • OAuth2-Authentifizierung für die Management API

    Externe LDAP-Nutzer greifen mit OAuth2-Tokens auf die Management API zu.

Mit einem externen SAML-IDP migrieren

Bei der Migration zur neuen Edge-Benutzeroberfläche gibt es keine Änderungen an der Installationsanleitung für einen SAML-IDP. Weitere Informationen finden Sie unter SAML-IDP konfigurieren.