Questa sezione fornisce indicazioni sull'attivazione della modalità FIPS su RHEL 8, garantendo un ambiente sicuro e conforme per Edge for Private Cloud versione 4.53.00 o successive.
Preinstallazione
Assicurati che FIPS sia abilitato sui nodi insieme agli altri prerequisiti di configurazione standard elencati nella documentazione Panoramica dell'installazione di Edge.
fips-mode-setup --check FIPS mode is enabled. # Command output
Se la modalità FIPS è attualmente disattivata, consulta la documentazione ufficiale di Red Hat per istruzioni su come attivarla: Passaggio di RHEL 8 alla modalità FIPS.
Requisiti Java
La versione di Java che utilizzi deve essere scaricata dal repository di Red Hat per garantire che i suoi moduli di sicurezza siano conformi a FIPS, attivando le limitazioni specifiche di FIPS tramite la sicurezza di Java.
Installazione
Nel riferimento del file di configurazione di Edge, imposta FIPS_OS=true su ogni nodo. Puoi seguire i passaggi generali di installazione di Edge for Private Cloud come di consueto.
Formato della chiave privata
Solo il formato PKCS12/PFX può essere utilizzato per caricare chiavi private nei keystore Apigee da utilizzare nei proxy API o negli host virtuali. Per indicazioni sulla creazione del file, consulta Conversione dei certificati nel formato supportato.
Operazioni TLS generali
Quando utilizzi Edge for Private Cloud 4.53.00 o versioni successive su RHEL 8.X abilitato per FIPS, la maggior parte delle configurazioni dei componenti di Edge relative a TLS deve essere eseguita tramite keystore in formato PKCS12 o BCFKS.
Per ulteriori dettagli, consulta la documentazione o le note specifiche per FIPS negli articoli pertinenti per la configurazione TLS. L'appendice elenca alcuni comandi utili che possono essere utilizzati per generare questi keystore.
Keystore/truststore Java predefinito
Quando utilizzi Edge for Private Cloud 4.53.00 su RHEL 8.X abilitato per FIPS, il Message Processor, il server di gestione e altri componenti edge-* puntano per impostazione predefinita a un keystore e un truststore BCFKS segnaposto (/opt/apigee/edge-gateway/vault/bcfks-cacerts) forniti con il prodotto.
Per generare il tuo archivio BCFKS cacerts e configurare i componenti Edge per utilizzarlo, segui questi passaggi:
-
Genera il tuo file in formato BCFKS
cacertscontenente tutti i certificati CA che vuoi considerare attendibili. Assicurati che la password del keystore e la password della chiave siano le stesse (e di almeno 14 caratteri se si applicano controlli rigorosi delle password BCFIPS).-
Opzione A: converti lo store del sistema operativo host o del JDK
cacertsnel formato BCFKS (consigliato se vuoi includere le CA radice attendibili del sistema operativo standard gestite daupdate-ca-trust):BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -importkeystore \ -srckeystore /etc/pki/java/cacerts \ -srcstoretype JKS \ -srcstorepass changeit \ -destkeystore my-cacerts.bcfks \ -deststoretype BCFKS \ -deststorepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR" \ -noprompt -
Opzione B: crea un nuovo archivio BCFKS con certificati CA personalizzati (
.pemo.crt) o importa certificati CA personalizzati aggiuntivi in un archivio BCFKS esistente (ad esempiomy-cacerts.bcfksdall'Opzione A):BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -importcert \ -file PATH_TO_CA_CERT.pem \ -alias CA_ALIAS \ -keystore my-cacerts.bcfks \ -storetype BCFKS \ -storepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR" \ -noprompt -
(Facoltativo) Verifica i contenuti del tuo archivio BCFKS:
BC_FIPS_JAR=$(ls /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-*.jar \ | head -n 1)keytool -J-Dcom.redhat.fips=false -list \ -keystore my-cacerts.bcfks \ -storetype BCFKS \ -storepass YOUR_STORE_PASSWORD \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider \ -providername BCFIPS \ -providerpath "$BC_FIPS_JAR"
-
-
Su ogni nodo che esegue uno dei componenti Edge elencati nel passaggio 3, copia il file BCFKS in un percorso appropriato e assicurati che l'utente
apigeepossa leggerlo:cp my-cacerts.bcfks /opt/apigee/customer/application/my-cacerts.bcfkschown apigee:apigee /opt/apigee/customer/application/my-cacerts.bcfkschmod 600 /opt/apigee/customer/application/my-cacerts.bcfks -
Su ogni nodo, crea o modifica il file di configurazione per ogni componente installato dalla tabella seguente (ripetendo i passaggi da 3 a 6 per ogni componente elencato sul nodo):
Componente File edge-management-server/opt/apigee/customer/application/management-server.propertiesedge-message-processor/opt/apigee/customer/application/message-processor.propertiesedge-router/opt/apigee/customer/application/router.propertiesedge-postgres-server/opt/apigee/customer/application/postgres-server.propertiesedge-qpid-server/opt/apigee/customer/application/qpid-server.properties -
Aggiungi le seguenti righe al file di configurazione:
conf_system_javax.net.ssl.trustStore=/opt/apigee/customer/application/my-cacerts.bcfks conf_system_javax.net.ssl.trustStorePassword=YOUR_STORE_PASSWORD conf_system_javax.net.ssl.keyStore=/opt/apigee/customer/application/my-cacerts.bcfks conf_system_javax.net.ssl.keyStoreType=BCFKS conf_system_javax.net.ssl.keyStorePassword=YOUR_STORE_PASSWORD
Sostituisci
/opt/apigee/customer/application/my-cacerts.bcfkseYOUR_STORE_PASSWORDcon il percorso e la password del file BCFKScacerts. -
Assicurati che l'utente
apigeesia proprietario del file di configurazione e possa leggerlo:chown apigee:apigee /opt/apigee/customer/application/FILE.properties
-
Riavvia il componente:
/opt/apigee/apigee-service/bin/apigee-service COMPONENT restart
Appendice
Comandi di esempio per le operazioni del keystore BCFKS
Il comando seguente genera un archivio chiavi BCFKS con una coppia di chiavi e certificati autofirmati:
keytool -genkeypair -keyalg RSA -alias node0 -validity 365 -keystore keystore.node0 \ -storepass keypass -keypass keypass -v \ -dname "EMAILADDRESS=youremail@domain.com, CN=yourcn, OU=yourou, O=youro, L=yourl, C=yourc" \ -storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar \ -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providername BCFIPS
I comandi keytool rimangono coerenti con quelli utilizzati in genere, ma nel comando keytool devono essere incluse le seguenti opzioni:
--storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providername BCFIPS
Argomenti keytool
| Argomento keytool | Descrizione |
|---|---|
-storetype |
Imposta il tipo di negozio su BCFKS. |
-providerpath |
Specifica il percorso di bc-fips-XXXX.jar. Questa versione potrebbe cambiare nelle release future di OPDK. Utilizza la versione fornita da Apigee o scaricala dai repository di Bouncycastle. Per OPDK 4.53, il percorso deve essere /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar. |
-providerclass |
Imposta questo valore su org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider. |
-providername |
Imposta questo valore su BCFIPS. |
È possibile utilizzare comandi keytool simili per importare o esportare certificati e/o chiavi da o verso un archivio chiavi in formato BCFKS. Per saperne di più su come utilizzare BCFKS, consulta la documentazione di BouncyCastle.
Archivio PKCS12
Per generare un archivio PKCS12, puoi utilizzare i comandi openssl:
# Generate a self-signed private key and certificate openssl req -x509 -newkey rsa:2048 -keyout private.key -out certificate.pem -sha256 -days 36500 -nodes -subj "/C=yourc/ST=yourst/L=yourl/O=youro/OU=yourou/CN=cn/emailAddress=email" # Package the above generated key and cert into a PKCS12 openssl pkcs12 -export -clcerts -in certificate.pem -inkey private.key -out keystore.pfx -name myalias
Se hai una chiave privata e un certificato e devi convertirli in un formato PKCS12, consulta Conversione dei certificati in un formato supportato.