Migrer vers l'interface utilisateur Edge

Cette section fournit des conseils pour migrer de l'UI classique vers l'UI Edge avec un IDP tel que LDAP ou SAML.

Pour en savoir plus, consultez les pages suivantes :

Qui peut effectuer la migration ?

Pour migrer vers l'interface utilisateur Edge, vous devez être connecté en tant qu'utilisateur ayant installé Edge à l'origine ou en tant qu'utilisateur racine. Après avoir exécuté le programme d'installation de l'interface utilisateur Edge, n'importe quel utilisateur peut les configurer.

Avant de commencer

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

  • Sauvegarder vos nœuds d'UI classique existants

    Avant d'effectuer la mise à jour, Apigee vous recommande de sauvegarder votre serveur d'UI classique existant.

  • Ports/pare-feu

    Par défaut, l'UI classique utilise le port 9000. L'UI Edge utilise le port 3001.

  • Nouvelle VM

    L'UI Edge ne peut pas être installée sur la même VM que l'UI classique.

    Pour installer l'UI Edge, vous devez ajouter une nouvelle machine à votre configuration. Si vous souhaitez utiliser la même machine que l'UI classique, vous devez désinstaller complètement l'UI classique.

  • Fournisseur d'identité (LDAP ou SAML)

    L'interface utilisateur Edge authentifie les utilisateurs avec un IDP SAML ou LDAP :

    • LDAP : pour LDAP, vous pouvez utiliser un IDP LDAP externe ou l'implémentation OpenLDAP interne installée avec Edge.
    • SAML : l'IdP SAML doit être un IdP externe.

    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 utilisez actuellement un IdP LDAP externe avec l'UI classique, vous continuerez à utiliser un IdP LDAP externe avec l'UI Edge.

Migrer avec un IdP LDAP interne

Suivez les consignes ci-dessous lorsque vous migrez de l'interface utilisateur classique vers l'interface utilisateur Edge dans une configuration qui utilise l'implémentation LDAP interne (OpenLDAP) en tant que fournisseur d'identité :

  • Configuration de la liaison indirecte

    Installez l'interface utilisateur Edge en suivant ces instructions, en apportant la modification suivante à votre fichier de configuration silencieux :

    Configurez LDAP pour utiliser la recherche et la liaison (indirecte), comme illustré dans l'exemple suivant :

    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
  • Authentification de base pour l'API Management

    L'authentification de base pour les API continue de fonctionner par défaut pour tous les utilisateurs LDAP lorsque l'authentification unique Apigee est activée. Vous pouvez éventuellement désactiver l'authentification de base, comme décrit dans Désactiver l'authentification de base sur Edge.

  • Authentification OAuth2 pour l'API Management

    L'authentification par jeton est activée lorsque vous activez l'authentification unique.

  • Nouveau flux de nom d'utilisateur/mot de passe

    Vous devez créer de nouveaux utilisateurs avec des API, car les flux de mots de passe ne fonctionneront plus dans l'interface utilisateur Edge.

Migrer avec un fournisseur d'identité LDAP externe

Suivez les consignes ci-dessous lorsque vous migrez de l'interface utilisateur classique vers l'interface utilisateur Edge dans une configuration qui utilise une implémentation LDAP externe en tant qu'IDP :

  • Configuration LDAP

    Installez l'interface utilisateur Edge en suivant ces instructions. Vous pouvez configurer une liaison directe ou indirecte dans votre fichier de configuration silencieuse.

  • Configuration du serveur de gestion

    Après avoir activé l'authentification unique Apigee, vous devez supprimer toutes les propriétés LDAP externes définies dans le fichier /opt/apigee/customer/application/management-server.properties et redémarrer le serveur de gestion.

  • Authentification de base pour l'API Management

    L'authentification de base fonctionne pour les utilisateurs de machines, mais pas pour les utilisateurs LDAP. Ces informations seront essentielles si votre processus CI/CD utilise toujours l'authentification de base pour accéder au système.

  • Authentification OAuth2 pour l'API Management

    Les utilisateurs LDAP peuvent accéder à l'API Management uniquement avec des jetons.

Migrer avec un IdP SAML externe

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