Migracja do interfejsu użytkownika Edge

Ta sekcja zawiera wskazówki dotyczące migracji z klasycznego interfejsu użytkownika do interfejsu Edge z IDP, takim jak LDAP lub SAML.

Aby dowiedzieć się więcej, zobacz:

Kto może przeprowadzić migrację

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

Zanim zaczniesz

Zanim przejdziesz z klasycznego interfejsu użytkownika na interfejs Edge, zapoznaj się z tymi ogólnymi wskazówkami:

  • Tworzenie kopii zapasowej dotychczasowych węzłów klasycznego interfejsu

    Przed aktualizacją Apigee zaleca utworzenie kopii zapasowej istniejącego serwera klasycznego interfejsu użytkownika.

  • Porty/zapory sieciowe

    Domyślnie interfejs klasyczny używa portu 9000. Interfejs Edge UI używa portu 3001.

  • Nowa maszyna wirtualna

    Interfejsu Edge nie można zainstalować na tej samej maszynie wirtualnej co interfejs klasyczny.

    Aby zainstalować interfejs Edge, musisz dodać do konfiguracji nową maszynę. Jeśli chcesz używać tej samej maszyny co w przypadku klasycznego interfejsu, musisz całkowicie odinstalować klasyczny interfejs.

  • Dostawca tożsamości (LDAP lub SAML)

    Interfejs Edge uwierzytelnia użytkowników za pomocą IDP SAML lub LDAP:

    • LDAP: w przypadku LDAP możesz użyć zewnętrznego dostawcy tożsamości LDAP lub wewnętrznej implementacji OpenLDAP zainstalowanej z Edge.
    • SAML: dostawca tożsamości SAML musi być zewnętrznym dostawcą tożsamości.

    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 obecnie używasz zewnętrznego dostawcy tożsamości LDAP z klasycznym interfejsem użytkownika, nadal będziesz używać zewnętrznego dostawcy tożsamości LDAP z interfejsem Edge.

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

Podczas migracji z klasycznego interfejsu użytkownika do interfejsu Edge w konfiguracji, która używa wewnętrznej implementacji LDAP (OpenLDAP) jako dostawcy tożsamości, postępuj zgodnie z tymi wytycznymi:

  • Konfiguracja powiązania pośredniego

    Zainstaluj interfejs Edge, korzystając z tych instrukcji, wprowadzając tę zmianę w pliku konfiguracji instalacji dyskretnej:

    Skonfiguruj LDAP, aby używać wyszukiwania i powiązania (pośredniego), jak pokazano w tym przykładzie:

    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
  • Uwierzytelnianie podstawowe w interfejsie API zarządzania Google Analytics

    Uwierzytelnianie podstawowe w przypadku interfejsów API nadal działa domyślnie dla wszystkich użytkowników LDAP, gdy włączone jest SSO w Apigee. Możesz opcjonalnie wyłączyć uwierzytelnianie podstawowe, jak opisano w artykule Wyłączanie uwierzytelniania podstawowego w Edge.

  • Uwierzytelnianie OAuth2 w interfejsie API zarządzania Google Analytics

    Uwierzytelnianie oparte na tokenach jest włączane po włączeniu logowania jednokrotnego.

  • Nowy proces logowania za pomocą nazwy użytkownika i hasła

    Nowych użytkowników musisz tworzyć za pomocą interfejsów API, ponieważ przepływy haseł nie będą już działać w interfejsie Edge.

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

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

  • Konfiguracja LDAP

    Zainstaluj interfejs Edge, korzystając z tych instrukcji. W pliku konfiguracji instalacji cichej możesz skonfigurować powiązanie bezpośrednie lub pośrednie.

  • Konfiguracja serwera zarządzania

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

  • Uwierzytelnianie podstawowe w interfejsie API zarządzania Google Analytics

    Uwierzytelnianie podstawowe działa w przypadku użytkowników maszyn, ale nie użytkowników LDAP. Będzie to kluczowe, jeśli proces CI/CD nadal używa uwierzytelniania podstawowego do uzyskiwania dostępu do systemu.

  • Uwierzytelnianie OAuth2 w interfejsie API zarządzania Google Analytics

    Użytkownicy LDAP mogą uzyskać dostęp do interfejsu API zarządzania Google Analytics tylko za pomocą tokenów.

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

Podczas migracji do interfejsu Edge nie wprowadzamy żadnych zmian w instrukcjach instalacji dostawcy tożsamości SAML.