Installer la nouvelle interface utilisateur Edge

Ce document explique comment installer l'interface utilisateur Edge pour Apigee Edge for Private Cloud. L'interface utilisateur Edge est la nouvelle génération d'interface utilisateur pour Edge.

Prérequis

Pour tester la nouvelle interface utilisateur Edge dans une installation d'Apigee Edge pour le cloud privé, vous devez:

  • Installez l'interface utilisateur Edge sur son propre nœud. Vous ne pouvez pas l'installer sur un nœud contenant d'autres composants Edge, y compris le nœud sur lequel se trouve l'UI classique existante. Les utilisateurs ne pourront alors plus se connecter à l'UI classique.

    Le nœud de l'UI Edge doit répondre aux exigences suivantes:

    • JAVA 1.8
    • 4 Go de RAM
    • 2 cœurs
    • 60 Go d'espace disque
    • Vous devez d'abord installer la version 4.51.00 de l'utilitaire apigee-setup sur le nœud, comme décrit dans la section Installer l'utilitaire apigee-setup Edge.
    • Le port 3001 doit être ouvert. Il s'agit du port par défaut utilisé pour les requêtes envoyées à l'UI Edge. Si vous modifiez le port à l'aide des propriétés décrites dans la section Nouveau fichier de configuration UE, assurez-vous que le port est ouvert.
  • Activez un IDP externe sur Edge. L'UI Edge est compatible avec SAML ou LDAP comme mécanisme d'authentification.
  • (Fournisseur d'identité SAML uniquement) L'interface utilisateur d'Edge n'est compatible qu'avec TLS v1.2. Étant donné que vous vous connectez à l'IdP SAML via TLS, votre IdP doit donc être compatible avec TLS v1.2 si vous utilisez SAML.

Pour en savoir plus sur l'interface utilisateur Edge, consultez Nouvelle interface utilisateur Edge pour le cloud privé.

Présentation de l'installation

De manière générale, le processus d'installation de l'UI Edge pour Apigee Edge pour Private Cloud est le suivant:

  • Ajouter un nœud à votre cluster
  • Se connecter au nouveau nœud
  • Télécharger l'utilitaire apigee-setup
  • Créer un fichier de configuration et le modifier avec vos paramètres
  • Exécuter l'utilitaire apigee-setup
  • Se connecter et tester la nouvelle UE

Lorsqu'elle est exécutée sur le nouveau nœud, l'utilitaire apigee-setup:

  • Installe l'UI classique de base, appelée shoehorn, et configure l'UI classique pour qu'elle utilise un fournisseur d'identité externe pour s'authentifier avec Edge.
  • Il installe la nouvelle interface utilisateur Edge et configure l'interface utilisateur Edge pour qu'elle utilise votre IdP externe pour s'authentifier auprès de Edge.

Éléments à prendre en compte avant d'installer la nouvelle interface utilisateur d'Edge

Comme décrit ci-dessus dans les conditions préalables, l'UI Edge nécessite que vous activiez un IDP externe sur Edge. Cela signifie que l'authentification des utilisateurs est contrôlée par l'IdP, qui est configuré pour utiliser les adresses e-mail comme ID utilisateur. Par conséquent, tous les utilisateurs de l'UI Edge doivent être enregistrés dans l'IDP.

L'interface utilisateur classique, l'interface utilisateur par défaut que vous avez installée avec Apigee Edge for Private Cloud, ne nécessite pas d'IDP externe. Elle peut utiliser un IdP ou une authentification de base. Vous pouvez donc:

  • Activez la prise en charge des fournisseurs d'identité externes dans Edge, ainsi que dans l'interface utilisateur classique et l'interface utilisateur Edge.

    Dans ce scénario, tous les utilisateurs de l'UI classique et de l'UI Edge sont enregistrés dans l'IDP. Pour en savoir plus sur l'ajout d'utilisateurs à l'IDP, consultez Enregistrer de nouveaux utilisateurs Edge.

  • Activer la prise en charge des fournisseurs d'identité externes sur Edge, mais laisser l'authentification de base activée. L'interface utilisateur Edge utilise le fournisseur d'identité et l'interface utilisateur classique utilise toujours l'authentification de base.

    Dans ce scénario, tous les utilisateurs de l'UI classique se connectent avec des identifiants d'authentification de base, où leurs identifiants sont stockés dans la base de données OpenLDAP d'Edge. Les utilisateurs de l'UI Edge sont enregistrés dans l'IDP et se connectent à l'aide de SAML ou de LDAP.

    Cependant, un utilisateur d'interface utilisateur classique ne peut pas se connecter à l'interface utilisateur Edge tant que vous n'avez pas ajouté cet utilisateur au fournisseur d'identité, comme décrit dans la section Enregistrer de nouveaux utilisateurs Edge.

Modifications de la configuration d'installation par rapport aux versions précédentes

Tenez compte des modifications apportées à la procédure d'installation par rapport aux versions bêta de l'interface utilisateur Edge.

Nouveau fichier de configuration de l'UI Edge

Le fichier de configuration suivant contient toutes les informations nécessaires pour installer et configurer la nouvelle interface utilisateur d'Edge. Vous pouvez utiliser le même fichier de configuration pour installer et configurer à la fois l'interface utilisateur classique/Shoehorn et l'interface utilisateur Edge.

# IP of the Edge Management Server.
# This node also hosts the Apigee SSO module and the current, or Classic, UI.
IP1=management_server_IP

# IP of the Edge UI node.
IP2=edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# Edge UI configuration.
#

# Enable the Edge UI.
EDGEUI_ENABLE_UNIFIED_UI=y
# Specify IP and port for the Edge UI.
# The management UI port must be open for requests to the Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
# Set to 'OPDK' to specify a Private Cloud deployment.
MANAGEMENT_UI_APP_ENV=OPDK
# Disable TLS on the Edge UI.
MANAGEMENT_UI_SCHEME=http

# Location of Edge UI.
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
# Duration of CSRF token.
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
# Defaults to 8760 hours, or 365 days.
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=8760

## SSO configuration for the Edge UI.
MANAGEMENT_UI_SSO_ENABLED=y

# Only required if MANAGEMENT_UI_SSO_ENABLED is 'y'
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y

MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=your_client_sso_secret

#
# Shoehorn UI configuration
#
# Set to http even if you enable TLS on the Edge UI.
SHOEHORN_SCHEME=http
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000

#
# Edge Classic UI configuration.
# Some settings are for the Classic UI, but are still required to configure the Edge UI.
#

# These settings assume that Classic UI is installed on the Management Server.
CLASSIC_UI_IP=$MSIP
CLASSIC_UI_PORT=9000
CLASSIC_UI_SCHEME=http
EDGEUI_PUBLIC_URIS=$CLASSIC_UI_SCHEME://$CLASSIC_UI_IP:$CLASSIC_UI_PORT

# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS

# Enable SSO
EDGEUI_SSO_ENABLED=y

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is 'edgeui'.
# Apigee recommends that you use the same settings as you used
# when enabling your IDP on the Classic UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars.
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Apigee SSO Component configuration
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Apigee SSO module.
# If Apigee SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
SSO_PUBLIC_URL_SCHEME=http
# MANAGEMENT_UI_SKIP_VERIFY=y
# SSO admin credentials as set when you installed Apigee SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=your_sso_admin_secret

#
##      SSO Configuration (define external IDP)           #
#
# Use one of the following configuration blocks to        #
# define your IDP settings:                               #
#  - SAML configuration properties                        #
#  - LDAP Direct Binding configuration properties         #
#  - LDAP Indirect Binding configuration properties       #

INSERT_IDP_CONFIG_BLOCK_HERE (SAML, LDAP direct, or LDAP indirect)

## SMTP Configuration (required)
#
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.gmail.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company myco@company.com"

Installer l'interface utilisateur Edge

Après avoir créé et modifié le fichier de configuration, vous pouvez installer la nouvelle interface utilisateur Edge sur ce nouveau nœud.

Pour installer l'UI Edge:

  1. Ajoutez un nœud à votre cluster.
  2. Connectez-vous au nouveau nœud en tant qu'administrateur.
  3. Installez la version 4.51.00 de l'utilitaire apigee-setup sur le nœud, comme décrit dans la section Installer l'utilitaire apigee-setup Edge.
  4. Nettoyez toutes les informations mises en cache avec Yum en exécutant la commande suivante : 
    sudo yum clean all
  5. Créez le fichier de configuration comme décrit dans la section Nouveau fichier de configuration de l'UI Edge et assurez-vous qu'il appartient à l'utilisateur "apigee" : 
    chown apigee:apigee configFile

    Veillez à apporter les modifications suivantes au fichier de configuration:

    • Remplacez la valeur de la propriété MANAGEMENT_UI_SSO_CSRF_SECRET dans le fichier de configuration par votre secret CSRF.
    • Configurez Edge pour qu'il utilise l'un des éléments suivants (la nouvelle interface utilisateur Edge nécessite un IDP externe) :
      • SAML
      • LDAP

      Pour en savoir plus, consultez la section Présentation de l'authentification des IDP externes.

  6. Configurez votre IdP externe avec les utilisateurs auxquels vous souhaitez donner accès à l'interface utilisateur Edge. Pour en savoir plus, consultez Enregistrer de nouveaux utilisateurs Edge.
  7. Sur le nouveau nœud, exécutez la commande suivante : 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    L'utilitaire apigee-setup installe l'UI classique. L'installateur installe ensuite l'interface utilisateur Edge au-dessus de l'interface utilisateur classique.

  8. Connectez-vous à l'interface utilisateur Edge en ouvrant l'URL suivante dans un navigateur : 
    http://new_edge_UI_IP:3001

    Où new_edge_UI_IP est l'adresse IP du nœud hébergeant la nouvelle interface utilisateur Edge.

    Edge vous invite à saisir vos identifiants de fournisseur d'identité externe.

  9. Saisissez vos identifiants.

    La nouvelle interface utilisateur d'Edge s'affiche. Pour plus d'informations sur l'utilisation de l'interface utilisateur Edge, consultez La nouvelle interface utilisateur Edge pour le cloud privé.

    Si l'interface utilisateur Edge ne s'affiche pas, assurez-vous que le port 3001 est ouvert pour les connexions externes.

Désinstaller la nouvelle interface utilisateur

Pour désinstaller la nouvelle interface utilisateur de son nœud, vous devez désinstaller à la fois la nouvelle interface utilisateur Edge et l'interface utilisateur classique de base (forcer) installée sur le nœud lors du processus d'installation de l'interface utilisateur.

Pour désinstaller la nouvelle interface utilisateur d'Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall

Pour désinstaller l'UI classique de base (pointe de fer):

/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

Pour supprimer tous les composants Edge du nœud:

  1. Arrêtez tous les services Edge exécutés sur la machine : 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Videz le cache yum : 
    sudo yum clean all
  3. Supprimez tous les RPM Apigee : 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Supprimez le répertoire racine d'installation : 
    sudo rm -rf /opt/apigee