A partir de Apigee Edge para nube privada 4.54.00, se quitó la IU clásica (edge-ui) y la nueva IU de Edge (edge-management-ui) es la interfaz de administración predeterminada.
En esta sección, se proporciona orientación para migrar de la IU clásica a la nueva IU de Edge, incluidas
las implementaciones que usan un IDP, como LDAP o SAML.
Para obtener más información, consulte:
Quién puede realizar la migración
Para migrar a la nueva IU de Edge, debes acceder como el usuario que instaló Edge originalmente o como usuario raíz. Después de ejecutar el instalador de la nueva IU de Edge, cualquier usuario autorizado puede configurarla.
Antes de comenzar
Antes de migrar de la IU clásica a la nueva IU de Edge, lee los siguientes lineamientos generales:
- Crea una copia de seguridad de la configuración existente de la IU clásica
Antes de actualizar a la versión 4.54.00, Apigee recomienda que crees una copia de seguridad de los archivos de configuración existentes de la IU clásica para que puedas transferir la configuración personalizada (como SMTP, TLS, tiempo de espera de la sesión y propiedades de marca) a
/opt/apigee/customer/application/management-ui.properties. - Puertos/firewalls
De forma predeterminada, la IU clásica usaba el puerto 9000. La nueva IU de Edge usa el puerto 3001 (configurable con
conf_uebe_port). - Quitar la IU clásica
Si instalas la nueva IU de Edge en un nodo que alojó anteriormente la IU clásica, desinstala la IU clásica (
edge-ui) antes de instalar la nueva IU de Edge (edge-management-ui). - Autenticación (autenticación básica, LDAP o SAML)
En Edge para nube privada 4.54.00, la nueva IU de Edge admite la autenticación básica (
AUTH_MODE=basic) y la autenticación de IDP externo a través de SSO de Apigee (AUTH_MODE=sso):- Autenticación básica: Usa la implementación interna de OpenLDAP
(
apigee-openldap) sin requerir SSO. - IDP de LDAP (con Apigee SSO): Usa un
IDP de LDAP externo o la implementación interna de OpenLDAP
(
apigee-openldap) con Apigee SSO. - IDP de SAML (con Apigee SSO): Usa un IDP de SAML externo con Apigee SSO.
Para obtener más información, consulta Instala y configura IDPs.
- Autenticación básica: Usa la implementación interna de OpenLDAP
(
- Mismo IDP
En esta sección, se supone que usarás el mismo IDP después de la migración. Por ejemplo, si antes usabas un IDP de LDAP externo con la IU clásica, seguirás usando un IDP de LDAP externo con la nueva IU de Edge.
Migra con un IDP de LDAP interno
Si usas la implementación interna de OpenLDAP (apigee-openldap)
, puedes usar la autenticación básica directamente en la nueva IU de Edge (consulta Configura la nueva IU de Edge) o
configurar Apigee SSO con LDAP interno con los siguientes lineamientos:
- Configuración de LDAP y la nueva IU de Edge
Instala y configura la nueva IU de Edge y Apigee SSO con Configura la nueva IU de Edge, Instala y configura Apigee SSO, y Configura tu IDP de LDAP.
- Autenticación básica para la API de Management
La autenticación básica para las APIs sigue funcionando de forma predeterminada para todos los usuarios de LDAP cuando se habilita Apigee SSO. De manera opcional, puedes inhabilitar la autenticación básica, como se describe en Inhabilita la autenticación básica en Edge.
- Autenticación de OAuth2 para la API de Management
La autenticación basada en tokens se habilita cuando habilitas Apigee SSO.
Migra con un IDP de LDAP externo
Usa los siguientes lineamientos cuando migres de la IU clásica a la nueva IU de Edge en una configuración que use una implementación de LDAP externa como IDP:
- Configuración de LDAP
Configura Apigee SSO y la nueva IU de Edge con Configura la nueva IU de Edge, Instala y configura Apigee SSO, y Configura tu IDP de LDAP.
- Configuración del servidor de administración
Después de habilitar Apigee SSO, quita las propiedades externas de LDAP de la IU clásica heredada del archivo
/opt/apigee/customer/application/management-server.propertiesy reinicia el servidor de administración. - Autenticación básica para la API de Management
La autenticación básica funciona para los usuarios de la máquina, pero no para los usuarios externos de LDAP. Esto es fundamental si tu proceso de CI/CD usa la autenticación básica para acceder al sistema.
- Autenticación de OAuth2 para la API de Management
Los usuarios externos de LDAP acceden a la API de Management con tokens de OAuth2.
Migra con un IDP de SAML externo
Cuando se migra a la nueva IU de Edge, no hay cambios en las instrucciones de instalación para un IDP de SAML. Consulta Configura tu IDP de SAML.