Edge per Private Cloud v4.18.05
Per impostazione predefinita, si accede all'interfaccia utente di gestione perimetrale tramite HTTP utilizzando l'indirizzo IP del nodo del server di gestione e la porta 9000. Ad esempio:
http://ms_IP:9000
In alternativa, puoi configurare l'accesso TLS all'interfaccia utente di gestione in modo da potervi accedere nel formato:
https://ms_IP:9443
In questo esempio, configurerai l'accesso TLS in modo da utilizzare la porta 9443. Tuttavia, questo numero di porta non è richiesto da Edge: puoi configurare il server di gestione in modo che utilizzi altri valori di porta. L'unico requisito è che il firewall consenta il traffico sulla porta specificata.
Assicurati che la porta TLS sia aperta
La procedura descritta in questa sezione consente di configurare TLS in modo che utilizzi la porta 9443 sul server di gestione. Indipendentemente dalla porta utilizzata, devi assicurarti che sia aperta sul server di gestione. Ad esempio, puoi utilizzare il seguente comando per aprirla:
iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9443 -j ACCEPT --verbose
Configura TLS
Utilizza la seguente procedura per configurare l'accesso TLS all'interfaccia utente di gestione:
- Genera il file JKS dell'archivio chiavi contenente la certificazione TLS e la chiave privata e copialo nel nodo del server di gestione. Per ulteriori informazioni, vedi Configurare TLS/SSL per Edge On Premises.
- Esegui questo comando per configurare TLS:
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl
- Inserisci il numero di porta HTTPS, ad esempio 9443.
- Specifica se vuoi disattivare l'accesso HTTP all'interfaccia utente di gestione. Per impostazione predefinita, l'interfaccia utente di gestione è accessibile tramite HTTP sulla porta 9000.
- Inserisci l'algoritmo dell'archivio chiavi. Il valore predefinito è JKS.
- Inserisci il percorso assoluto al file JKS dell'archivio chiavi.
Lo script copia il file nella directory
/opt/apigee/customer/conf
sul nodo del server di gestione e cambia la proprietà del file in "apigee". - Inserisci la password dell'archivio chiavi in chiaro.
- Lo script riavvia quindi l'interfaccia utente di gestione perimetrale. Dopo il riavvio, l'interfaccia utente di gestione supporta l'accesso tramite TLS.
Puoi visualizzare queste impostazioni in
/opt/apigee/etc/edge-ui.d/SSL.sh
.
Puoi anche passare un file di configurazione al comando anziché rispondere ai prompt. Il file di configurazione prevede le seguenti proprietà:
HTTPSPORT=9443 DISABLE_HTTP=y KEY_ALGO=JKS KEY_FILE_PATH=/opt/apigee/customer/application/mykeystore.jks KEY_PASS=clearTextKeystorePWord
Quindi utilizza il comando seguente per configurare TLS della UI Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl -f configFile
Configura la UI perimetrale quando TLS termina sul bilanciatore del carico
Se disponi di un bilanciatore del carico che inoltra le richieste alla UI perimetrale, puoi scegliere di terminare la connessione TLS sul bilanciatore del carico, quindi fare in modo che il bilanciatore del carico inoltri le richieste alla UI perimetrale tramite HTTP. Questa configurazione è supportata, ma devi configurare di conseguenza il bilanciatore del carico e la UI perimetrale.
La configurazione aggiuntiva è richiesta quando la UI perimetrale invia agli utenti email per impostare la loro password quando viene creato l'utente o quando quest'ultimo richiede di reimpostare una password smarrita. Questa email contiene un URL selezionato dall'utente per impostare o reimpostare una password. Per impostazione predefinita, se l'interfaccia utente perimetrale non è configurata per l'utilizzo di TLS, l'URL nell'email generata utilizza il protocollo HTTP e non HTTPS. Devi configurare il bilanciatore del carico e la UI perimetrale in modo che generino un indirizzo email che utilizza HTTPS.
Per configurare il bilanciatore del carico, assicurati che imposti la seguente intestazione per le richieste inoltrate alla UI perimetrale:
X-Forwarded-Proto: https
Per configurare l'UI Edge:
- Apri il file
/opt/apigee/customer/application/ui.properties
in un editor. Se il file non esiste, crealo:vi /opt/apigee/customer/application/ui.properties
- Imposta la seguente proprietà in
ui.properties
:conf/application.conf+trustxforwarded=true
- Salva le modifiche apportate a
ui.properties
. - Riavvia la UI di Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
Disabilita TLS sulla UI perimetrale
Per disabilitare TLS sulla UI Edge, utilizza il comando seguente:
/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl