Esegui la migrazione alla UI Edge

Questa sezione fornisce indicazioni per la migrazione dalla UI classica alla UI Edge con un IDP come LDAP o SAML.

Per ulteriori informazioni, vedi:

Chi può eseguire la migrazione

Per eseguire la migrazione alla UI Edge, devi aver eseguito l'accesso come utente che ha installato originariamente Edge o come utente root. Dopo aver eseguito il programma di installazione per la UI di Edge, qualsiasi utente può configurarle.

Prima di iniziare

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

  • Esegui il backup dei nodi della UI classica esistenti

    Prima di eseguire l'aggiornamento, Apigee consiglia di eseguire il backup del server della UI classica esistente.

  • Porte/firewall

    Per impostazione predefinita, la UI classica utilizza la porta 9000. La UI di Edge utilizza la porta 3001.

  • Nuova VM

    La UI di Edge non può essere installata sulla stessa VM della UI classica.

    Per installare la UI Edge, devi aggiungere una nuova macchina alla configurazione. Se vuoi utilizzare la stessa macchina della UI classica, devi disinstallare completamente la UI classica.

  • Provider di identità (LDAP o SAML)

    La UI di Edge autentica gli utenti con un IDP SAML o LDAP:

    • LDAP: per LDAP, puoi utilizzare un IDP LDAP esterno o l'implementazione OpenLDAP interna installata con Edge.
    • SAML:l'IdP SAML deve essere un IdP esterno.

    Per saperne di più, consulta Installa e configura gli IdP.

  • Stesso IdP

    Questa sezione presuppone che utilizzerai lo stesso IdP dopo la migrazione. Ad esempio, se attualmente utilizzi un IDP LDAP esterno con la UI Classic, continuerai a utilizzare un IDP LDAP esterno con la UI Edge.

Esegui la migrazione con un IDP LDAP interno

Utilizza le seguenti linee guida per eseguire la migrazione dalla UI Classic alla UI Edge in una configurazione che utilizza l'implementazione LDAP interna (OpenLDAP) come IDP:

  • Configurazione dell'associazione indiretta

    Installa la UI Edge seguendo queste istruzioni, con la seguente modifica al file di configurazione invisibile all'utente:

    Configura LDAP in modo che utilizzi la ricerca e l'associazione (indiretta), come mostrato nell'esempio seguente:

    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
  • Autenticazione di base per l'API di gestione

    L'autenticazione di base per le API continua a funzionare per impostazione predefinita per tutti gli utenti LDAP quando SSO Apigee è abilitato. Se vuoi, puoi disattivare l'autenticazione di base, come descritto in Disattiva l'autenticazione di base su Edge.

  • Autenticazione OAuth2 per l'API di gestione

    L'autenticazione basata su token viene attivata quando attivi l'SSO.

  • Nuovo flusso di nome utente/password

    Devi creare nuovi utenti con le API perché i flussi di password non funzioneranno più nell'interfaccia utente di Edge.

Esegui la migrazione con un IdP LDAP esterno

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

  • Configurazione LDAP

    Installa la UI Edge seguendo queste istruzioni. Puoi configurare l'associazione diretta o indiretta nel file di configurazione silenziosa.

  • Configurazione del server di gestione

    Dopo aver attivato SSO Apigee, devi rimuovere tutte le proprietà LDAP esterne definite nel file /opt/apigee/customer/application/management-server.properties e riavviare 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. Questi saranno fondamentali se il tuo processo CI/CD utilizza ancora l'autenticazione di base per accedere al sistema.

  • Autenticazione OAuth2 per l'API di gestione

    Gli utenti LDAP possono accedere all'API di gestione solo con i token.

Esegui la migrazione con un IdP SAML esterno

Durante la migrazione alla UI di Edge, non vengono apportate modifiche alle istruzioni di installazione per un IDP SAML.