Edge for Private Cloud su RHEL 8.X con FIPS abilitato

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:

  1. Genera il tuo file in formato BCFKS cacerts contenente 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 cacerts nel formato BCFKS (consigliato se vuoi includere le CA radice attendibili del sistema operativo standard gestite da update-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 (.pem o .crt) o importa certificati CA personalizzati aggiuntivi in un archivio BCFKS esistente (ad esempio my-cacerts.bcfks dall'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"
  2. 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 apigee possa leggerlo:

    cp my-cacerts.bcfks /opt/apigee/customer/application/my-cacerts.bcfks
    chown apigee:apigee /opt/apigee/customer/application/my-cacerts.bcfks
    chmod 600 /opt/apigee/customer/application/my-cacerts.bcfks
  3. 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.properties
    edge-message-processor /opt/apigee/customer/application/message-processor.properties
    edge-router /opt/apigee/customer/application/router.properties
    edge-postgres-server /opt/apigee/customer/application/postgres-server.properties
    edge-qpid-server /opt/apigee/customer/application/qpid-server.properties
  4. 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.bcfks e YOUR_STORE_PASSWORD con il percorso e la password del file BCFKS cacerts.

  5. Assicurati che l'utente apigee sia proprietario del file di configurazione e possa leggerlo:

    chown apigee:apigee /opt/apigee/customer/application/FILE.properties
  6. 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.