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:
-
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 vonupdate-ca-trustverwaltet 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 (
.pemoder.crt) oder importieren Sie zusätzliche benutzerdefinierte CA-Zertifikate in einen vorhandenen BCFKS-Speicher (z. B.my-cacerts.bcfksaus 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"
-
-
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
apigeesie lesen kann: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 -
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.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 -
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.bcfksundYOUR_STORE_PASSWORDdurch den Pfad und das Passwort für Ihre BCFKS-cacerts-Datei. -
Prüfen Sie, ob der Nutzer
apigeedie Konfigurationsdatei besitzt und lesen kann:chown apigee:apigee /opt/apigee/customer/application/FILE.properties
-
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.