TLS (Transport Layer Security, il cui predecessore è SSL) è la tecnologia di sicurezza standard per garantire la messaggistica sicura e criptata nell'ambiente API, dalle app ad Apigee Edge ai servizi di backend.
Indipendentemente dalla configurazione dell'ambiente per l'API di gestione, ad esempio se utilizzi o meno un proxy, un router e/o un bilanciamento del carico davanti all'API di gestione, Edge ti consente di abilitare e configurare TLS, offrendoti il controllo della crittografia dei messaggi nel tuo ambiente di gestione delle API on-premise.
Per un'installazione on-premise di Edge Private Cloud, esistono diversi punti in cui puoi configurare TLS:
- Tra un router e un processore di messaggi
- Per l'accesso all'API di gestione di Edge
- Per l'accesso alla nuova UI di Edge
- Per l'accesso da un'app alle tue API
- Per l'accesso da Edge ai servizi di backend
Per una panoramica completa della configurazione di TLS su Edge, consulta TLS/SSL.
Creazione di un file JKS
Per molte configurazioni TLS, l'archivio chiavi è rappresentato come un file JKS, che contiene il certificato TLS e chiave privata. Esistono diversi modi per creare un file JKS, ma uno è utilizzare le utilità openssl e keytool.
Ad esempio, hai un file PEM denominato server.pem contenente il certificato TLS
e un file PEM denominato private_key.pem contenente la chiave privata. Utilizza i seguenti comandi per
creare il file PKCS12:
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12
Devi inserire la passphrase della chiave, se ne ha una, e una password di esportazione. Questo
comando crea un file PKCS12 denominato keystore.pkcs12.
Utilizza il seguente comando per convertirlo in un file JKS denominato keystore.jks:
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks
Ti viene chiesto di inserire la nuova password per il file JKS e la password esistente per il file PKCS12. Assicurati di utilizzare la stessa password per il file JKS che hai utilizzato per il file PKCS12.
Se devi specificare un alias della chiave, ad esempio quando configuri TLS tra un router e un processore di messaggi, includi l'opzione -name nel comando openssl:
openssl pkcs12 -export -clcerts -in server.pem -inkey private_key.pem -out keystore.pkcs12 -name devtest
Quindi includi l'opzione -alias nel comando keytool:
keytool -importkeystore -srckeystore keystore.pkcs12 -srcstoretype pkcs12 -destkeystore keystore.jks -deststoretype jks -alias devtest
Generazione di una password offuscata
Alcune parti della procedura di configurazione di TLS di Edge richiedono l'inserimento di una password offuscata in un file di configurazione. Una password offuscata è un'alternativa più sicura all'inserimento della password in testo normale.
Puoi generare una password offuscata utilizzando il seguente comando sul server di gestione di Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server generate-obfuscated-password
Inserisci la nuova password, quindi confermala al prompt. Per motivi di sicurezza, il testo di la password non viene visualizzato. Questo comando restituisce la password nel formato:
OBF:58fh40h61svy156789gk1saj MD5:902fobg9d80e6043b394cb2314e9c6
Utilizza la password offuscata specificata da OBF durante la configurazione di TLS.
Per saperne di più, consulta questo articolo.