Migrer vers la nouvelle interface utilisateur Edge

À partir d'Apigee Edge pour Private Cloud 4.54.00, l'interface utilisateur classique (edge-ui) est supprimée et la nouvelle interface utilisateur Edge (edge-management-ui) devient l'interface de gestion par défaut. Cette section fournit des conseils pour migrer de l'interface utilisateur classique vers la nouvelle interface utilisateur Edge, y compris pour les déploiements qui utilisent un IDP tel que LDAP ou SAML.

Pour en savoir plus, consultez les pages suivantes :

Utilisateurs autorisés à effectuer la migration

Pour migrer vers la nouvelle interface utilisateur Edge, vous devez être connecté en tant qu'utilisateur ayant installé Edge à l'origine ou en tant qu'utilisateur racine. Une fois que vous avez exécuté le programme d'installation de la nouvelle interface utilisateur Edge, tout utilisateur autorisé peut la configurer.

Avant de commencer

Avant de migrer de l'interface utilisateur classique vers la nouvelle interface utilisateur Edge, lisez les consignes générales suivantes :

  • Sauvegarder la configuration existante de l'interface utilisateur classique

    Avant de passer à la version 4.54.00, Apigee vous recommande de sauvegarder vos fichiers de configuration existants de l'interface utilisateur classique afin de pouvoir transférer les paramètres personnalisés (tels que SMTP, TLS, délai avant expiration de la session, et propriétés de branding) vers /opt/apigee/customer/application/management-ui.properties.

  • Ports/pare-feu

    Par défaut, l'interface utilisateur classique utilisait le port 9000. La nouvelle interface utilisateur Edge utilise le port 3001 (configurable à l'aide de conf_uebe_port).

  • Supprimer l'interface utilisateur classique

    Si vous installez la nouvelle interface utilisateur Edge sur un nœud qui hébergeait auparavant l'interface utilisateur classique, désinstallez l'interface utilisateur classique (edge-ui) avant d'installer la nouvelle interface utilisateur Edge (edge-management-ui).

  • Authentification (authentification de base, LDAP ou SAML)

    Dans Edge pour le cloud privé 4.54.00, la nouvelle interface utilisateur Edge est compatible à la fois avec l'authentification de base (AUTH_MODE=basic) et avec l'authentification IdP externe via Apigee SSO (AUTH_MODE=sso) :

    • Authentification de base : utilise l'implémentation OpenLDAP interne (apigee-openldap) sans nécessiter l'authentification unique.
    • IdP LDAP (avec Apigee SSO) : utilise un IdP LDAP externe ou l'implémentation OpenLDAP interne (apigee-openldap) avec Apigee SSO.
    • IdP SAML (avec Apigee SSO) : utilise un IdP SAML externe avec Apigee SSO.

    Pour en savoir plus, consultez Installer et configurer des IdP.

  • Même IdP

    Cette section suppose que vous utiliserez le même IdP après la migration. Par exemple, si vous utilisiez auparavant un IdP LDAP externe avec l'interface utilisateur classique, vous continuerez à utiliser un IdP LDAP externe avec la nouvelle interface utilisateur Edge.

Migrer avec un IdP LDAP interne

Si vous utilisez l'implémentation OpenLDAP interne (apigee-openldap) , vous pouvez utiliser l'authentification de base directement dans la nouvelle interface utilisateur Edge (consultez Configurer la nouvelle interface utilisateur Edge) ou configurer Apigee SSO avec LDAP interne en suivant les consignes ci-dessous :

Migrer avec un IdP LDAP externe

Suivez les consignes ci-dessous lorsque vous migrez de l'interface utilisateur classique vers la nouvelle interface utilisateur Edge dans une configuration qui utilise une implémentation LDAP externe comme IdP :

  • Configuration LDAP

    Configurez Apigee SSO et la nouvelle interface utilisateur Edge à l'aide des pages Configurer la nouvelle interface utilisateur Edge, Installer et configurer Apigee SSO, et Configurer votre IdP LDAP.

  • Configuration du serveur de gestion

    Après avoir activé Apigee SSO, supprimez toutes les anciennes propriétés LDAP externes de l'interface utilisateur classique du fichier /opt/apigee/customer/application/management-server.properties et redémarrez le serveur de gestion.

  • Authentification de base pour l'API Management

    L'authentification de base fonctionne pour les utilisateurs machines, mais pas pour les utilisateurs LDAP externes. Cela est essentiel si votre CI/CD processus utilise l'authentification de base pour accéder au système.

  • Authentification OAuth2 pour l'API Management

    Les utilisateurs LDAP externes accèdent à l'API Management à l'aide de jetons OAuth2.

Migrer avec un IdP SAML externe

Lors de la migration vers la nouvelle interface utilisateur Edge, les instructions d'installation d'un IdP SAML ne changent pas. Consultez Configurer votre IdP SAML.