Edge for Private Cloud auf FIPS-fähiger RHEL 8.X

In diesem Abschnitt wird beschrieben, wie Sie den FIPS-Modus unter RHEL 8 aktivieren, um eine sichere und konforme Umgebung für Edge for Private Cloud-Versionen ab 4.53.00 zu gewährleisten.

Vorab installieren

Achten Sie darauf, dass FIPS auf Ihren Knoten aktiviert ist, zusammen mit den anderen Standardkonfigurationsvoraussetzungen, die in der Dokumentation Edge-Installation – Übersicht aufgeführt sind.

fips-mode-setup --check  
FIPS mode is enabled.  # Command output

Wenn der FIPS-Modus derzeit deaktiviert ist, finden Sie in der offiziellen Red Hat-Dokumentation eine Anleitung zum Aktivieren: RHEL 8 in den FIPS-Modus wechseln.

Java-Anforderungen

Die von Ihnen verwendete Java-Version sollte aus dem Repository von Red Hat heruntergeladen werden, damit die Sicherheitsmodule FIPS-konform sind und FIPS-spezifische Einschränkungen über die Java-Sicherheit aktiviert werden können.

Installation

Legen Sie in der Referenz zur Edge-Konfigurationsdatei für jeden Knoten FIPS_OS=true fest. Sie können die allgemeinen Installationsschritte für Edge for Private Cloud wie gewohnt ausführen.

Format des privaten Schlüssels

Nur das PKCS12/PFX-Format kann verwendet werden, um private Schlüssel in Apigee-Schlüsselspeicher hochzuladen, die in Ihren API-Proxys oder virtuellen Hosts verwendet werden sollen. Eine Anleitung zum Erstellen der Datei finden Sie unter Zertifikate in ein unterstütztes Format konvertieren.

Allgemeine TLS-Vorgänge

Wenn Sie Edge for Private Cloud 4.53.00 oder höher auf FIPS-fähigem RHEL 8.X verwenden, müssen die meisten TLS-bezogenen Komponentenkonfigurationen von Edge über Keystores im PKCS12- oder BCFKS-Format vorgenommen werden.

Weitere Informationen finden Sie in der FIPS-spezifischen Dokumentation oder in den Hinweisen in den entsprechenden Artikeln zur TLS-Konfiguration. Im Anhang finden Sie einige hilfreiche Befehle, mit denen Sie diese Schlüsselspeicher generieren können.

Standard-Java-Keystore/-Truststore

Wenn Sie Edge for Private Cloud 4.53.00 auf FIPS-fähigem RHEL 8.X verwenden, verweisen Ihr Message Processor, Management Server und andere edge-*-Komponenten standardmäßig auf einen Platzhalter-BCFKS-Keystore und -Truststore (/opt/apigee/edge-gateway/vault/bcfks-cacerts), der im Produkt enthalten ist.

So generieren Sie Ihren eigenen BCFKS-cacerts-Speicher und konfigurieren Ihre Edge-Komponenten für die Verwendung:

  1. Generieren Sie Ihre eigene cacerts-Datei im BCFKS-Format, die alle CA-Zertifikate enthält, denen Sie vertrauen möchten. Achten Sie darauf, dass das Keystore-Passwort und das Schlüsselpasswort identisch sind (und mindestens 14 Zeichen lang sind, wenn strenge BCFIPS-Passwortprüfungen gelten).

    • Option A: Konvertieren Sie den Host-Betriebssystem- oder JDK-cacerts-Speicher in das BCFKS-Format (empfohlen, wenn Sie die standardmäßigen vertrauenswürdigen Stammzertifizierungsstellen des Betriebssystems einbeziehen möchten, die von update-ca-trust verwaltet werden):

      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
    • Option B: Erstellen Sie einen neuen BCFKS-Speicher mit benutzerdefinierten CA-Zertifikaten (.pem oder .crt) oder importieren Sie zusätzliche benutzerdefinierte CA-Zertifikate in einen vorhandenen BCFKS-Speicher (z. B. my-cacerts.bcfks aus Option 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
    • Optional: Prüfen Sie den Inhalt Ihres BCFKS-Speichers:

      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. Kopieren Sie auf jedem Knoten, auf dem eine der in Schritt 3 aufgeführten Edge-Komponenten ausgeführt wird, die BCFKS-Datei in einen geeigneten Pfad und sorgen Sie dafür, dass der Nutzer apigee sie lesen kann:

    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. Erstellen oder bearbeiten Sie auf jedem Knoten die Konfigurationsdatei für jede installierte Komponente aus der folgenden Tabelle. Wiederholen Sie dazu die Schritte 3–6 für jede aufgeführte Komponente auf dem Knoten:

    Komponente Datei
    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. Fügen Sie der Konfigurationsdatei die folgenden Zeilen hinzu:

    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

    Ersetzen Sie /opt/apigee/customer/application/my-cacerts.bcfks und YOUR_STORE_PASSWORD durch den Pfad und das Passwort für Ihre BCFKS-cacerts-Datei.

  5. Prüfen Sie, ob der Nutzer apigee die Konfigurationsdatei besitzt und lesen kann:

    chown apigee:apigee /opt/apigee/customer/application/FILE.properties
  6. Starten Sie die Komponente neu:

    /opt/apigee/apigee-service/bin/apigee-service COMPONENT restart

Anhang

Beispielbefehle für BCFKS-Schlüsselspeichervorgänge

Mit dem folgenden Befehl wird ein BCFKS-Keystore mit einem selbst signierten Schlüssel- und Zertifikatpaar generiert:

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

Die Keytool-Befehle bleiben mit den üblicherweise verwendeten Befehlen konsistent. Die folgenden Optionen müssen jedoch im Keytool-Befehl enthalten sein:

--storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar
-providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider 
-providername BCFIPS

Keytool-Argumente

Keytool-Argument Beschreibung
-storetype Legen Sie den Speichertyp auf BCFKS fest.
-providerpath Geben Sie den Pfad zu bc-fips-XXXX.jar an. Diese Version kann sich in zukünftigen OPDK-Releases ändern. Verwenden Sie die von Apigee bereitgestellte Version oder laden Sie sie aus den Repositories von Bouncycastle herunter. Für OPDK 4.53 sollte der Pfad /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar lauten.
-providerclass Legen Sie für dieses Feld org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider fest.
-providername Legen Sie für dieses Feld BCFIPS fest.

Ähnliche keytool-Befehle können verwendet werden, um Zertifikate und/oder Schlüssel aus einem Schlüsselspeicher im BCFKS-Format zu importieren oder in einen solchen zu exportieren. Weitere Informationen zur Verwendung von BCFKS finden Sie in der BouncyCastle-Dokumentation.

PKCS12-Speicher

Zum Generieren eines PKCS12-Speichers können openssl-Befehle verwendet werden:

# 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

Wenn Sie einen eigenen privaten Schlüssel und ein eigenes Zertifikat haben und diese in ein PKCS12-Format konvertieren müssen, lesen Sie den Abschnitt Zertifikate in ein unterstütztes Format konvertieren.