Migrar para a IU de borda

Nesta seção, fornecemos orientações para migrar da IU clássica para a IU do Edge com um IDP, como LDAP ou SAML.

Para mais informações, consulte:

Quem pode fazer a migração

Para migrar para a IU do Edge, faça login como o usuário que instalou o Edge originalmente ou como um usuário raiz. Depois de executar o instalador da IU do Edge, qualquer usuário pode configurá-los.

Antes de começar

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

  • Fazer backup dos nós atuais da interface clássica

    Antes de atualizar, a Apigee recomenda que você faça backup do servidor da IU clássica.

  • Portas/firewalls

    Por padrão, a interface clássica usa a porta 9000. A interface do Edge usa a porta 3001.

  • Nova VM

    A interface do Edge não pode ser instalada na mesma VM que a interface clássica.

    Para instalar a IU do Edge, adicione uma nova máquina à sua configuração. Se você quiser usar a mesma máquina da interface clássica, desinstale-a completamente.

  • Provedor de identidade (LDAP ou SAML)

    A IU do Edge autentica os usuários com um IDP SAML ou LDAP:

    • LDAP:para LDAP, é possível usar um IDP LDAP externo ou a implementação interna do OpenLDAP instalada com o Edge.
    • SAML:o IdP SAML precisa ser externo.

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

  • Mesmo IDP

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

Migrar com um IDP LDAP interno

Siga as diretrizes abaixo ao migrar da IU clássica para a IU do Edge em uma configuração que usa a implementação LDAP interna (OpenLDAP) como um IDP:

  • Configuração de vinculação indireta

    Instale a IU do Edge usando estas instruções, com a seguinte alteração no arquivo de configuração silenciosa:

    Configure o LDAP para usar pesquisa e vinculação (indireta), como mostra o exemplo a seguir:

    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
  • Autenticação básica para a API de gerenciamento

    A autenticação básica para APIs continua funcionando por padrão para todos os usuários do LDAP quando o SSO da Apigee está ativado. Como opção, é possível desativar a autenticação básica, conforme descrito em Desativar a autenticação básica no Edge.

  • Autenticação do OAuth 2.0 para a API Management

    A autenticação baseada em token é ativada quando você ativa o SSO.

  • Novo fluxo de usuário/senha

    É preciso criar novos usuários com APIs, porque os fluxos de senha não vão mais funcionar na interface do Edge.

Migrar com um IdP LDAP externo

Siga as diretrizes abaixo ao migrar da IU clássica para a IU do Edge em uma configuração que usa uma implementação LDAP externa como um IDP:

  • Configuração LDAP

    Instale a IU do Edge usando estas instruções. É possível configurar a vinculação direta ou indireta no arquivo de configuração silenciosa.

  • Configuração do servidor de gerenciamento

    Depois de ativar o SSO da Apigee, remova todas as propriedades LDAP externas definidas no arquivo /opt/apigee/customer/application/management-server.properties 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áquina, mas não para usuários LDAP. Isso será fundamental se seu processo de CI/CD ainda usar a autenticação básica para acessar o sistema.

  • Autenticação do OAuth 2.0 para a API Management

    Os usuários do LDAP podem acessar a API Management apenas com tokens.

Migrar com um IdP SAML externo

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