Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Installa la nuova UI di Edge

Questo documento descrive come installare la UI di Edge per Apigee Edge for Private Cloud. La UI di Edge è la UI di nuova generazione per Edge.

Prerequisiti

Per provare la nuova UI di Edge in un'installazione di Apigee Edge for Private Cloud, devi:

Installa la UI Edge sul proprio nodo. Non puoi installarlo su un nodo che contiene altri componenti Edge, incluso il nodo su cui si trova la UI classica esistente. In questo modo, gli utenti non potranno accedere alla UI classica.
Il nodo della UI Edge deve soddisfare i seguenti requisiti:
- JAVA 1.8
- 4 GB di RAM
- 2 core
- 60 GB di spazio su disco
- Devi prima installare la versione 4.19.06 dell'utilità apigee-setup sul nodo, come descritto in Installa l'utilità apigee-setup di Edge.
- La porta 3001 deve essere aperta. Questa è la porta predefinita utilizzata per le richieste alla UI di Edge. Se modifichi la porta utilizzando le proprietà descritte in Nuovo file di configurazione di UE, assicurati che la porta sia aperta.
Abilita un IDP esterno su Edge. La UI di Edge supporta SAML o LDAP come meccanismo di autenticazione.
(Solo IDP SAML) La UI di Edge supporta solo TLS v1.2. Poiché ti connetti all'IdP SAML tramite TLS, se utilizzi SAML, l'IdP deve supportare TLS v1.2.

Per saperne di più sulla UI di Edge, consulta La nuova UI di Edge per cloud privato.

Panoramica dell'installazione

In linea generale, la procedura per installare la UI di Edge per Apigee Edge for Private Cloud è la seguente:

Aggiungi un nuovo nodo al cluster
Accedi al nuovo nodo
Scarica l'utilità apigee-setup
Crea un file di configurazione e modificalo con le tue impostazioni
Esegui l'utilità apigee-setup
Accedi ed esegui il test della nuova esperienza utente

Quando viene eseguita sul nuovo nodo, l'utilità apigee-setup:

Installa la UI classica di base, chiamata shoehorn, e configura la UI classica in modo che utilizzi un IDP esterno per l'autenticazione con Edge.
</div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> È semplicemente un requisito per l'installazione della nuova UI di Edge.
Installa la nuova UI Edge e la configura in modo che utilizzi l'IDP esterno per l'autenticazione con Edge.

Considerazioni prima di installare la nuova UI di Edge

Come descritto sopra nei prerequisiti, la UI di Edge richiede l'attivazione di un IDP esterno su Edge. Ciò significa che l'autenticazione utente è controllata dall'IdP, dove la configuri per utilizzare gli indirizzi email come ID utente. Tutti gli utenti della UI Edge devono quindi essere registrati nell'IDP.

La UI classica, ovvero la UI predefinita che hai installato con Apigee Edge for Private Cloud, non richiede un IDP esterno. Può utilizzare l'autenticazione IdP o di base. Ciò significa che puoi:

Abilita il supporto di IdP esterni su Edge e sia sulla UI classica sia sulla UI di Edge.
In questo scenario, tutti gli utenti della UI classica e della UI Edge sono registrati nell'IdP. Per informazioni sull'aggiunta di nuovi utenti all'IDP, consulta Registra nuovi utenti Edge.
Abilita il supporto di IdP esterni su Edge, ma lascia abilitata l'autenticazione di base. La UI Edge utilizza l'IDP e la UI classica utilizza ancora l'autenticazione di base.
In questo scenario, tutti gli utenti della UI classica accedono con le credenziali di autenticazione di base, dove le loro credenziali sono archiviate nel database OpenLDAP di Edge. Gli utenti della UI Edge sono registrati nell'IDP e accedono utilizzando SAML o LDAP.

Tuttavia, un utente della UI classica non può accedere alla UI Edge finché non lo hai aggiunto all'IdP come descritto in Registra nuovi utenti Edge.

Modifiche alla configurazione dell'installazione rispetto alle release precedenti

Tieni presente le seguenti modifiche alla procedura di installazione rispetto alle versioni beta della UI di Edge.

Modifiche alla configurazione dell'installazione da Edge 4.18.05

La release Edge 4.19.06 della UI Edge contiene le seguenti modifiche al file di configurazione della release Edge 4.18.05:

Tipo di modifica	Proprietà interessate
Rimosso	MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS Questa proprietà ha un valore predefinito di 0,5 (30 minuti) e non può essere modificata.
Aggiunta	Ora puoi utilizzare le proprietà per abilitare TLS nell'interfaccia utente di Edge. Per saperne di più, consulta Configurazione di TLS per la UI di Edge.

Modifiche alla configurazione dell'installazione da Edge 4.18.01

La versione Edge 4.19.06 della UI Edge contiene le seguenti modifiche al file di configurazione rispetto alla versione Edge 4.18.01:

Tipo di modifica	Proprietà interessate
Aggiunta	# Shoehorn/Classic UI configurations. SHOEHORN_SCHEME SHOEHORN_IP SHOEHORN_PORT # Classic UI configurations. CLASSIC_UI_SCHEME CLASSIC_UI_IP CLASSIC_UI_PORT # Information about Edge SSO module. MANAGEMENT_UI_SKIP_VERIFY
Rimosso	ROUTES_SHOEHORN ROUTES_CLASSICUI
Batteria sostituita	MANAGEMENT_UI_USE_HTTPS Sostituito da: MANAGEMENT_UI_SCHEME

Tipo di modifica

Proprietà interessate

Aggiunta

# Shoehorn/Classic UI configurations.
SHOEHORN_SCHEME
SHOEHORN_IP
SHOEHORN_PORT

# Classic UI configurations.
CLASSIC_UI_SCHEME
CLASSIC_UI_IP
CLASSIC_UI_PORT

# Information about Edge SSO module.
MANAGEMENT_UI_SKIP_VERIFY

Rimosso

ROUTES_SHOEHORN
ROUTES_CLASSICUI

Batteria sostituita

MANAGEMENT_UI_USE_HTTPS

Sostituito da:

MANAGEMENT_UI_SCHEME

File di configurazione della nuova UI Edge

Il seguente file di configurazione contiene tutte le informazioni necessarie per installare e configurare la nuova UI di Edge. Puoi utilizzare lo stesso file di configurazione per installare e configurare sia la UI di shoehorn/Classic sia la UI di 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"

Installa la UI Edge

Dopo aver creato e modificato il file di configurazione, puoi installare la nuova UI di Edge sul nuovo nodo.

Per installare la UI Edge:

Aggiungi un nuovo nodo al cluster.
Accedi al nuovo nodo come amministratore.
Installa la versione 4.19.06 dell'utilità apigee-setup sul nodo, come descritto in Installa l'utilità apigee-setup di Edge.
Pulisci tutte le informazioni memorizzate nella cache con Yum eseguendo questo comando:
```
sudo yum clean all
```
Crea il file di configurazione come descritto in Nuovo file di configurazione della UI Edge e assicurati che sia di proprietà dell'utente "apigee":
```
chown apigee:apigee configFile
```
Assicurati di apportare le seguenti modifiche al file di configurazione:
- Modifica il valore della proprietà MANAGEMENT_UI_SSO_CSRF_SECRET nel file di configurazione impostandolo sul tuo secret CSRF.
  NOTA: non utilizzare il valore predefinito nell'esempio di file di configurazione riportato sopra per il secret CSRF. Sostituiscila con un valore univoco che conosci solo tu.
- Configura Edge in modo che utilizzi una delle seguenti opzioni (la nuova UI di Edge richiede un IDP esterno):
  - SAML
  - LDAP
  Per saperne di più, consulta Panoramica dell'autenticazione degli IdP esterni.
Configura l'IDP esterno con gli utenti che vuoi che abbiano accesso alla UI di Edge. Per maggiori informazioni, consulta Registra nuovi utenti Edge.
Sul nuovo nodo, esegui questo comando:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
```
L'utilità apigee-setup installa la UI classica. Oltre alla UI classica, il programma di installazione installa anche la UI Edge.
Accedi alla UI Edge aprendo il seguente URL in un browser:
```
http://new_edge_UI_IP:3001
```
Dove new_edge_UI_IP è l'indirizzo IP del nodo che ospita la nuova UI di Edge.

Edge ti chiede le credenziali dell'IDP esterno.
Inserisci le tue credenziali.
Viene visualizzata la nuova UI di Edge. Per informazioni sull'utilizzo della UI di Edge, consulta La nuova UI di Edge per cloud privato.

Se la UI di Edge non viene visualizzata, assicurati che la porta 3001 sia aperta per le connessioni esterne.

Disinstalla la UI classica

Per disinstallare la UI classica dal relativo nodo, devi disinstallare sia la nuova UI Edge sia la UI classica di base (shoehorn) installata sul nodo durante il processo di installazione della UI.

Per disinstallare la nuova UI di Edge:

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

Per disinstallare la UI classica di base (shoehorn):

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

Per rimuovere tutti i componenti Edge dal nodo:

Arresta tutti i servizi Edge in esecuzione sulla macchina:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
Svuota la cache yum:
```
sudo yum clean all
```

Rimuovi tutti gli RPM Apigee:

sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")

Rimuovi la directory root di installazione:
```
sudo rm -rf /opt/apigee
```