Przechodzenie na nowy interfejs Edge

Począwszy od Apigee Edge dla chmury prywatnej 4.54.00, klasyczny interfejs (edge-ui) został usunięty, a nowy interfejs Edge (edge-management-ui) jest domyślnym interfejsem zarządzania. W tej sekcji znajdziesz wskazówki dotyczące migracji z klasycznego interfejsu do nowego interfejsu Edge, w tym w przypadku wdrożeń, które korzystają z IDP, takiego jak LDAP lub SAML.

Więcej informacji znajdziesz w tych artykułach:

Kto może przeprowadzić migrację

Aby przeprowadzić migrację do nowego interfejsu Edge, musisz zalogować się jako użytkownik, który pierwotnie zainstalował Edge, lub jako użytkownik root. Po uruchomieniu instalatora nowego interfejsu Edge każdy autoryzowany użytkownik może go skonfigurować.

Zanim zaczniesz

Zanim przeprowadzisz migrację z klasycznego interfejsu do nowego interfejsu Edge, zapoznaj się z tymi ogólnymi wskazówkami:

  • Utwórz kopię zapasową dotychczasowej konfiguracji klasycznego interfejsu

    Zanim przeprowadzisz aktualizację do wersji 4.54.00, Apigee zaleca utworzenie kopii zapasowej dotychczasowych plików konfiguracyjnych klasycznego interfejsu aby można było przenieść ustawienia niestandardowe (takie jak SMTP, TLS, limit czasu sesji, i właściwości marki) do /opt/apigee/customer/application/management-ui.properties.

  • Porty i zapory ogniowe

    Domyślnie klasyczny interfejs używał portu 9000. Nowy interfejs Edge używa portu 3001 (można go skonfigurować za pomocą conf_uebe_port).

  • Usuwanie klasycznego interfejsu

    Jeśli instalujesz nowy interfejs Edge na węźle, który wcześniej hostował klasyczny interfejs, odinstaluj klasyczny interfejs (edge-ui) przed zainstalowaniem nowego interfejsu Edge (edge-management-ui).

  • Uwierzytelnianie (podstawowe, LDAP lub SAML)

    W Edge for Private Cloud 4.54.00 nowy interfejs Edge obsługuje zarówno uwierzytelnianie podstawowe (AUTH_MODE=basic), jak i uwierzytelnianie za pomocą zewnętrznego dostawcy tożsamości przez logowanie jednokrotne Apigee (AUTH_MODE=sso):

    • Uwierzytelnianie podstawowe: korzysta z wewnętrznej implementacji OpenLDAP (apigee-openldap) bez konieczności używania logowania jednokrotnego.
    • Dostawca tożsamości LDAP (przy użyciu logowania jednokrotnego Apigee): korzysta z zewnętrznego dostawcy tożsamości LDAP lub wewnętrznej implementacji OpenLDAP (apigee-openldap) z logowaniem jednokrotnym Apigee.
    • Dostawca tożsamości SAML (przy użyciu logowania jednokrotnego Apigee): korzysta z zewnętrznego dostawcy tożsamości SAML z logowaniem jednokrotnym Apigee.

    Więcej informacji znajdziesz w artykule Instalowanie i konfigurowanie dostawców tożsamości.

  • Ten sam dostawca tożsamości

    W tej sekcji zakładamy, że po migracji będziesz używać tego samego dostawcy tożsamości. Jeśli na przykład wcześniej używałeś zewnętrznego dostawcy tożsamości LDAP z klasycznym interfejsem, nadal będziesz używać zewnętrznego dostawcy tożsamości LDAP z nowym interfejsem Edge.

Migracja z wewnętrznym dostawcą tożsamości LDAP

Jeśli używasz wewnętrznej implementacji OpenLDAP (apigee-openldap) , możesz używać uwierzytelniania podstawowego bezpośrednio w nowym interfejsie Edge (patrz Konfigurowanie nowego interfejsu Edge) lub skonfigurować SSO w Apigee z wewnętrznym LDAP, korzystając z tych wskazówek:

Migracja z zewnętrznym dostawcą tożsamości LDAP

Podczas migracji z klasycznego interfejsu do nowego interfejsu Edge w konfiguracji, która używa zewnętrznej implementacji LDAP jako dostawcy tożsamości, postępuj zgodnie z tymi wskazówkami:

  • Konfiguracja LDAP

    Skonfiguruj logowanie jednokrotne Apigee i nowy interfejs Edge, korzystając z Konfigurowanie nowego interfejsu Edge, Instalowanie i konfigurowanie logowania jednokrotnego Apigee, oraz Konfigurowanie dostawcy tożsamości LDAP.

  • Konfiguracja serwera zarządzania

    Po włączeniu SSO w Apigee usuń wszystkie starsze właściwości zewnętrznego LDAP klasycznego interfejsu z /opt/apigee/customer/application/management-server.properties pliku i ponownie uruchom serwer zarządzania.

  • Uwierzytelnianie podstawowe w interfejsie API zarządzania Google Analytics

    Uwierzytelnianie podstawowe działa w przypadku użytkowników maszyn, ale nie w przypadku zewnętrznych użytkowników LDAP. Jest to ważne, jeśli twój proces CI/CD używa uwierzytelniania podstawowego do uzyskiwania dostępu do systemu.

  • Uwierzytelnianie OAuth2 w interfejsie API zarządzania Google Analytics

    Zewnętrzni użytkownicy LDAP uzyskują dostęp do interfejsu API zarządzania Google Analytics za pomocą tokenów OAuth2.

Migracja z zewnętrznym dostawcą tożsamości SAML

Podczas migracji do nowego interfejsu Edge nie wprowadzamy żadnych zmian w instrukcjach instalacji dostawcy tożsamości SAML. Zapoznaj się z artykułem Konfigurowanie dostawcy tożsamości SAML.