Esegui la migrazione alla nuova UI di Edge

A partire da Apigee Edge per Private Cloud 4.54.00, la UI classica (edge-ui) viene rimossa e la nuova UI Edge (edge-management-ui) è l'interfaccia di gestione predefinita. Questa sezione fornisce indicazioni per la migrazione dalla UI classica alla nuova UI Edge, inclusi i deployment che utilizzano un IDP come LDAP o SAML.

Per ulteriori informazioni, vedi:

Chi può eseguire la migrazione

Per eseguire la migrazione alla nuova UI Edge, devi aver eseguito l'accesso come utente che ha installato originariamente Edge o come utente root. Dopo aver eseguito l'installer per la nuova UI Edge, qualsiasi utente autorizzato può configurarla.

Prima di iniziare

Prima di eseguire la migrazione dalla UI classica alla nuova UI Edge, leggi le seguenti linee guida generali:

  • Esegui il backup della configurazione della UI classica esistente

    Prima di eseguire l'upgrade alla versione 4.54.00, Apigee consiglia di eseguire il backup dei file di configurazione della UI classica esistenti in modo da poter trasferire le impostazioni personalizzate (come SMTP, TLS, timeout della sessione e proprietà di branding) a /opt/apigee/customer/application/management-ui.properties.

  • Porte/firewall

    Per impostazione predefinita, la UI classica utilizzava la porta 9000. La nuova UI Edge utilizza la porta 3001 (configurabile tramite conf_uebe_port).

  • Rimozione della UI classica

    Se stai installando la nuova UI Edge su un nodo che in precedenza ospitava la UI classica, disinstalla la UI classica (edge-ui) prima di installare la nuova UI Edge (edge-management-ui).

  • Autenticazione (autenticazione di base, LDAP o SAML)

    In Edge for Private Cloud 4.54.00, la nuova UI Edge supporta sia l'autenticazione di base (AUTH_MODE=basic) sia l'autenticazione IDP esterna tramite SSO Apigee (AUTH_MODE=sso):

    • Autenticazione di base: utilizza l'implementazione OpenLDAP interna (apigee-openldap) senza richiedere SSO.
    • IDP LDAP (utilizzando SSO Apigee): utilizza un IDP LDAP esterno o l'implementazione OpenLDAP interna (apigee-openldap) con SSO Apigee.
    • IDP SAML (utilizzando SSO Apigee): utilizza un IDP SAML esterno con SSO Apigee.

    Per ulteriori informazioni, vedi Installare e configurare gli IDP.

  • Stesso IDP

    Questa sezione presuppone che utilizzerai lo stesso IDP dopo la migrazione. Ad esempio, se in precedenza utilizzavi un IDP LDAP esterno con la UI classica, continuerai a utilizzare un IDP LDAP esterno con la nuova UI Edge.

Eseguire la migrazione con un IDP LDAP interno

Se utilizzi l'implementazione OpenLDAP interna (apigee-openldap) , puoi utilizzare l'autenticazione di base direttamente nella nuova UI Edge (vedi Configurare la nuova UI Edge) o configurare SSO Apigee con LDAP interno utilizzando le seguenti linee guida:

Eseguire la migrazione con un IDP LDAP esterno

Utilizza le seguenti linee guida quando esegui la migrazione dalla UI classica alla nuova UI Edge in una configurazione che utilizza un'implementazione LDAP esterna come IDP:

  • Configurazione LDAP

    Configura Apigee SSO e la nuova UI Edge utilizzando Configurare la nuova UI Edge, Installare e configurare Apigee SSO, e Configurare l'IDP LDAP.

  • Configurazione del server di gestione

    Dopo aver abilitato Apigee SSO, rimuovi tutte le proprietà LDAP esterne della UI classica legacy dal file /opt/apigee/customer/application/management-server.properties e riavvia il server di gestione.

  • Autenticazione di base per l'API di gestione

    L'autenticazione di base funziona per gli utenti macchina, ma non per gli utenti LDAP esterni. Questo è fondamentale se il processo CI/CD utilizza l'autenticazione di base per accedere al sistema.

  • Autenticazione OAuth2 per l'API di gestione

    Gli utenti LDAP esterni accedono all'API di gestione utilizzando i token OAuth2.

Eseguire la migrazione con un IDP SAML esterno

Quando esegui la migrazione alla nuova UI Edge, non vengono apportate modifiche alle istruzioni di installazione per un IDP SAML. Vedi Configurare l'IDP SAML.