La crittografia tra nodi (o da nodo a nodo) protegge i dati che viaggiano tra i nodi di un cluster utilizzando TLS. Questa pagina spiega come attivare la crittografia tra nodi Cassandra utilizzando TLS su Edge for Private Cloud. Per eseguire questi passaggi, devi conoscere i dettagli del tuo anello Cassandra.
Abilita la crittografia tra nodi di Cassandra
Per attivare la crittografia tra nodi di Cassandra:
Genera i certificati del server seguendo i passaggi descritti nell'Appendice per creare una chiave e un certificato autofirmati.
I passaggi seguenti presuppongono che tu abbia creato
keystore.node0etruststore.node0, nonché le password del keystore e del truststore, come spiegato nell'Appendice. Il keystore e il truststore devono essere creati come passaggi preliminari su ogni nodo prima di procedere con i passaggi successivi.- Aggiungi le seguenti proprietà al file
/opt/apigee/customer/application/cassandra.properties. Se il file non esiste, crealo.conf_cassandra_internode_encryption=all conf_cassandra_keystore=/opt/apigee/data/apigee-cassandra/keystore.node0 conf_cassandra_keystore_password=keypass conf_cassandra_truststore=/opt/apigee/data/apigee-cassandra/truststore.node0 conf_cassandra_truststore_password=trustpass # Optionally set the following to enable 2-way TLS or mutual TLS # conf_cassandra_require_client_auth=true
- Assicurati che il file
cassandra.propertiessia di proprietà dell'utente apigee:chown apigee:apigee \ /opt/apigee/customer/application/cassandra.properties
Esegui i seguenti passaggi su ogni nodo Cassandra, uno alla volta, in modo che le modifiche abbiano effetto senza causare tempi di inattività per gli utenti:
- Arresta il servizio Cassandra:
/opt/apigee/apigee-service/bin/apigee-service \ apigee-cassandra stop
- Riavvia il servizio Cassandra:
/opt/apigee/apigee-service/bin/apigee-service \ apigee-cassandra start
- Per determinare se il servizio di crittografia TLS è stato avviato, controlla i log di sistema per verificare la presenza del seguente messaggio:
Starting Encrypted Messaging Service on TLS port
Esegui la rotazione dei certificati
Per ruotare i certificati, segui questi passaggi:
- Aggiungi il certificato per ogni coppia di chiavi generate univoca (consulta l'Appendice) al truststore di un nodo Cassandra esistente, in modo che sia i certificati precedenti sia quelli nuovi esistano nello stesso truststore:
keytool -import -v -trustcacerts -alias NEW_ALIAS \ -file CERT -keystore EXISTING_TRUSTSTORE
dove
NEW_ALIASè una stringa univoca per identificare la voce,CERTè il nome del file del certificato da aggiungere eEXISTING_TRUSTSTOREè il nome del truststore esistente sul nodo Cassandra. - Utilizza un'utilità di copia, ad esempio scp, per distribuire il truststore a tutti i nodi Cassandra nel cluster, sostituendo il truststore esistente in uso da ciascun nodo.
- Esegui un riavvio in sequenza del cluster per caricare il nuovo truststore e stabilire l'attendibilità per le nuove chiavi prima che vengano applicate:
/opt/apigee/apigee-service/bin/apigee-service \ apigee-cassandra restart
- Su ogni nodo Cassandra nel cluster, aggiorna le proprietà mostrate di seguito ai nuovi valori del keystore nel file cassandra.properties:
conf_cassandra_keystore=NEW_KEYSTORE_PATH conf_cassandra_keystore_password=NEW_KEYSTORE_PASSOWRD
where
NEW_KEYSTORE_PATHis the path to the directory where the keystore file is located andNEW_KEYSTORE_PASSWORDis the keystore password set when the certificates were created, as explained in the Appendix. - Stop the Cassandra service:
/opt/apigee/apigee-service/bin/apigee-service \ apigee-cassandra stop
- Riavvia il servizio Cassandra:
/opt/apigee/apigee-service/bin/apigee-service \ apigee-cassandra start
- Quando la comunicazione viene stabilita correttamente tra tutti i nodi, procedi con il nodo Cassandra successivo. Nota: procedi con il nodo successivo solo se la comunicazione è stata stabilita correttamente tra tutti i nodi.
Appendice
L'esempio seguente spiega come preparare i certificati del server necessari per eseguire i passaggi di crittografia tra nodi. I comandi mostrati nell'esempio utilizzano i seguenti parametri:
| Parametro | Descrizione |
|---|---|
node0 |
Qualsiasi stringa univoca per identificare il nodo. |
keystore.node0 |
Un nome di archivio chiavi. I comandi presuppongono che questo file si trovi nella directory corrente. |
keypass |
La password della chiave deve essere la stessa sia per il keystore che per la chiave. |
dname |
Identifica l'indirizzo IP di node0 come 10.128.0.39. |
-validity |
Il valore impostato su questo flag rende valida la coppia di chiavi generata per 10 anni. |
- Vai alla seguente directory:
cd /opt/apigee/data/apigee-cassandra
- Esegui questo comando per generare un file denominato
keystore.node0nella directory corrente:keytool -genkey -keyalg RSA -alias node0 -validity 3650 \ -keystore keystore.node0 -storepass keypass \ -keypass keypass -dname "CN=10.128.0.39, OU=None, \ O=None, L=None, C=None"
Importante:assicurati che la password della chiave sia la stessa della password del keystore.
- Esporta il certificato in un file separato:
keytool -export -alias node0 -file node0.cer \ -keystore keystore.node0
- Assicurati che il file sia leggibile solo dall'utente apigee e da nessun altro:
$ chown apigee:apigee \ /opt/apigee/data/apigee-cassandra/keystore.node0 $ chmod 400 /opt/apigee/data/apigee-cassandra/keystore.node0
- Importa il certificato generato
node0.cernel truststore del nodo:keytool -import -v -trustcacerts -alias node0 \ -file node0.cer -keystore truststore.node0
Il comando precedente ti chiede di impostare una password. Questa è la password del truststore e può essere diversa dalla password del keystore impostata in precedenza. Se ti viene chiesto di rendere attendibile il certificato, inserisci
yes. - Utilizza openssl per generare un file PEM del certificato senza chiavi. Tieni presente che
cqlshnon funziona con il certificato nel formato generato.$ keytool -importkeystore -srckeystore keystore.node0 \ -destkeystore node0.p12 -deststoretype PKCS12 -srcstorepass \ keypass -deststorepass keypass $ openssl pkcs12 -in node0.p12 -nokeys -out node0.cer.pem \ -passin pass:keypass $ openssl pkcs12 -in node0.p12 -nodes -nocerts -out node0.key.pem -passin pass:keypass
- Per la crittografia node-to-node, copia il file
node0.cerin ogni nodo e importalo nel truststore di ogni nodo.keytool -import -v -trustcacerts -alias node0 \ -file node0.cer -keystore truststore.node1
- Utilizza
keytool -listper verificare la presenza di certificati nei file keystore e truststore:$ keytool -list -keystore keystore.node0 $ keytool -list -keystore truststore.node0