Migrar para a nova interface do Edge

A partir do Apigee Edge para nuvem privada 4.54.00, a interface clássica (edge-ui) foi removida, e a nova interface do Edge (edge-management-ui) é a interface de gerenciamento padrão. Esta seção fornece orientações para migrar da interface clássica para a nova interface do Edge, incluindo implantações que usam um IDP, como LDAP ou SAML.

Para mais informações, consulte:

Quem pode realizar a migração

Para migrar para a nova interface do Edge, você precisa fazer login como o usuário que instalou o Edge originalmente ou como um usuário raiz. Depois de executar o instalador da nova interface do Edge, qualquer usuário autorizado poderá configurá-la.

Antes de começar

Antes de migrar da interface clássica para a nova interface do Edge, leia as seguintes diretrizes gerais:

  • Faça backup da configuração da interface clássica

    Antes de fazer upgrade para a versão 4.54.00, o Apigee recomenda que você faça backup dos arquivos de configuração da interface clássica para poder transferir configurações personalizadas (como SMTP, TLS, tempo limite da sessão, e propriedades de marca) para /opt/apigee/customer/application/management-ui.properties.

  • Portas/firewalls

    Por padrão, a interface clássica usava a porta 9000. A nova interface do Edge usa a porta 3001 (configurável usando conf_uebe_port).

  • Remover a interface clássica

    Se você estiver instalando a nova interface do Edge em um nó que hospedou a interface clássica, desinstale a interface clássica (edge-ui) antes de instalar a nova interface do Edge (edge-management-ui).

  • Autenticação (básica, LDAP ou SAML)

    No Edge para nuvem privada 4.54.00, a nova interface do Edge oferece suporte à autenticação básica (AUTH_MODE=basic) e à autenticação de IDP externo pelo SSO da Apigee (AUTH_MODE=sso):

    • Autenticação básica: Usa a implementação interna do OpenLDAP (apigee-openldap) sem exigir o SSO.
    • IDP LDAP (usando o SSO da Apigee): usa um IDP LDAP externo ou a implementação interna do OpenLDAP (apigee-openldap) com o SSO da Apigee.
    • IDP SAML (usando o SSO da Apigee): usa um IDP SAML externo com o SSO da Apigee.

    Para mais informações, consulte Instalar e configurar IDPs.

  • Mesmo IDP

    Esta seção pressupõe que você usará o mesmo IDP após a migração. Por exemplo, se você usou um IDP LDAP externo com a interface clássica, continuará usando um IDP LDAP externo com a nova interface do Edge.

Migrar com um IDP LDAP interno

Se você usar a implementação interna do OpenLDAP (apigee-openldap) , poderá usar a autenticação básica diretamente na nova interface do Edge (consulte Configurar a nova interface do Edge) ou configurar o SSO da Apigee com o LDAP interno usando as seguintes diretrizes:

Migrar com um IDP LDAP externo

Use as diretrizes a seguir ao migrar da interface clássica para a nova interface do Edge em uma configuração que usa uma implementação LDAP externa como um IDP:

  • Configuração do LDAP

    Configure o SSO da Apigee e a nova interface do Edge usando Configurar a nova interface do Edge, Instalar e configurar o SSO da Apigee, e Configurar o IDP LDAP.

  • Configuração do servidor de gerenciamento

    Depois de ativar o SSO da Apigee, remova todas as propriedades LDAP externas da interface clássica legada do /opt/apigee/customer/application/management-server.properties arquivo e reinicie o servidor de gerenciamento.

  • Autenticação básica para a API de gerenciamento

    A autenticação básica funciona para usuários de máquinas, mas não para usuários LDAP externos. Isso é fundamental se o seu CI/CD processo usar a autenticação básica para acessar o sistema.

  • Autenticação OAuth2 para a API Management

    Os usuários LDAP externos acessam a API de gerenciamento usando tokens OAuth2.

Migrar com um IDP SAML externo

Ao migrar para a nova interface do Edge, não há mudanças nas instruções de instalação de um IDP SAML. Consulte Configurar o IDP SAML.