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 essayer la nouvelle interface utilisateur Edge dans une installation Apigee Edge pour Private Cloud, vous devez:

  • Installer 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. Cela empêcherait les utilisateurs de se connecter à l'interface utilisateur 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.53.00 de l'utilitaire apigee-setup sur le nœud, comme décrit dans la section Installer l'utilitaire Edge apigee-setup.
    • 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 en utilisant les propriétés décrites dans Nouveau fichier de configuration d'UE, vérifiez que est ouvert.
  • Activez un fournisseur d'identité externe dans Edge. L'interface utilisateur Edge prend en charge SAML ou LDAP comme mécanisme d'authentification unique.
  • (IdP SAML uniquement) L'interface utilisateur Edge ne prend en charge que TLS v1.2. Étant donné que vous vous connectez à l'IDP SAML via TLS, si vous utilisez SAML, votre IDP doit donc prendre en charge TLS v1.2.

Pour en savoir plus sur l'interface utilisateur Edge, consultez La 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 selon vos paramètres
  • Exécuter l'utilitaire apigee-setup
  • Se connecter et tester la nouvelle UE

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

  • installe l'interface utilisateur classique de base, appelée corne de chaussure ; configure l'interface utilisateur classique pour utiliser un IdP externe pour s'authentifier auprès de Edge.
  • installe la nouvelle interface utilisateur Edge et configure l'interface utilisateur Edge pour utiliser votre IdP pour s'authentifier auprès de Edge.

Éléments à prendre en compte avant d'installer le nouvel appareil Edge UI (interface utilisateur)

Comme décrit ci-dessus dans les conditions préalables, l'interface utilisateur 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, où vous le configurez pour qu'il utilise des adresses e-mail comme ID utilisateur. Tous les utilisateurs de l'interface utilisateur Edge doivent donc être enregistré auprès de 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:

  • Activer la prise en charge des fournisseurs d'identité externes sur Edge et à la fois dans l'interface utilisateur classique et dans 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 l'IdP, tandis que l'UI 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.

    Toutefois, un utilisateur de l'UI classique ne peut pas se connecter à l'UI Edge tant que vous ne l'avez pas ajouté 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 à l'installation et configurer la nouvelle interface utilisateur 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 un nouveau nœud.

Pour installer l'interface utilisateur Edge:

  1. Ajoutez un nœud à votre cluster.
  2. Connectez-vous au nouveau nœud en tant qu'administrateur.
  3. Installez la version 4.53.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'interface utilisateur Edge et assurez-vous qu'il appartient à "apigee" utilisateur: 
    chown apigee:apigee configFile

    Apportez les modifications suivantes au fichier de configuration:

    • Modifiez la valeur de la propriété MANAGEMENT_UI_SSO_CSRF_SECRET dans à votre secret CSRF.
    • Configurez Edge pour utiliser l'un des éléments suivants (la nouvelle interface utilisateur Edge nécessite un IdP externe): <ph type="x-smartling-placeholder">
        </ph>
      • SAML
      • LDAP

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

  6. Configurez votre fournisseur d'identité externe avec les utilisateurs auxquels vous souhaitez donner accès à l'interface utilisateur Edge. Pour plus d'informations, 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 UI Edge.

    Edge vous invite à saisir vos identifiants IdP externes.

  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 le UI classique de base (corne de chaussure) installée sur le nœud lors de l'installation de l'interface utilisateur processus.

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

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

Pour désinstaller l'interface utilisateur classique de base (corne d'aile):

/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 de l'installation : 
    sudo rm -rf /opt/apigee