W tej sekcji znajdziesz wskazówki dotyczące włączania trybu FIPS w RHEL 8, co zapewni bezpieczne i zgodne z przepisami środowisko dla Edge dla chmury prywatnej w wersji 4.53.00 lub nowszej.
Fabrycznie zainstalowane
Upewnij się, że standard FIPS jest włączony w węzłach, a także że spełnione są inne standardowe wymagania wstępne dotyczące konfiguracji wymienione w dokumentacji Omówienie instalacji Edge.
fips-mode-setup --check FIPS mode is enabled. # Command output
Jeśli tryb FIPS jest obecnie wyłączony, zapoznaj się z oficjalną dokumentacją Red Hat, aby dowiedzieć się, jak go włączyć: Przełączanie RHEL 8 na tryb FIPS.
Wymagania dotyczące Javy
Używana wersja Javy powinna zostać pobrana z repozytorium Red Hat, aby zapewnić zgodność modułów zabezpieczeń ze standardem FIPS i umożliwić stosowanie ograniczeń związanych z FIPS za pomocą zabezpieczeń Javy.
Instalacja
W pliku referencyjnym konfiguracji Edge ustaw FIPS_OS=true na każdym węźle. Możesz wykonać ogólne czynności instalacyjne Edge dla chmury prywatnej.
Format klucza prywatnego
Do przesyłania kluczy prywatnych do magazynów kluczy Apigee w celu użycia w serwerach proxy interfejsu API lub hostach wirtualnych można używać tylko formatu PKCS12/PFX. Wskazówki dotyczące tworzenia pliku znajdziesz w artykule Konwertowanie certyfikatów na obsługiwany format.
Ogólne operacje TLS
W przypadku korzystania z Edge dla chmury prywatnej w wersji 4.53.00 lub nowszej na systemie RHEL 8.X z włączonym FIPS większość konfiguracji komponentów Edge związanych z TLS będzie musiała być wykonywana za pomocą magazynów kluczy w formacie PKCS12 lub BCFKS.
Więcej informacji znajdziesz w dokumentacji dotyczącej FIPS lub w uwagach w odpowiednich artykułach na temat konfiguracji TLS. W dodatku znajdziesz kilka przydatnych poleceń, których można użyć do wygenerowania tych magazynów kluczy.
Domyślny magazyn kluczy/magazyn zaufanych certyfikatów Java
Gdy używasz Edge dla chmury prywatnej w wersji 4.53.00 w systemie RHEL 8.X z włączonym FIPS, procesor komunikatów, serwer zarządzania i inne komponenty edge-* domyślnie wskazują na zastępczy magazyn kluczy i magazyn zaufanych certyfikatów BCFKS (/opt/apigee/edge-gateway/vault/bcfks-cacerts) dostarczany z usługą.
Aby wygenerować własny magazyn BCFKS cacerts i skonfigurować komponenty Edge do korzystania z niego, wykonaj te czynności:
-
Wygeneruj własny plik w formacie BCFKS
cacertszawierający wszystkie certyfikaty CA, którym chcesz ufać. Upewnij się, że hasło do magazynu kluczy i hasło do klucza są takie same (i mają co najmniej 14 znaków, jeśli obowiązują rygorystyczne kontrole haseł BCFIPS).-
Opcja A: przekonwertuj magazyn systemu operacyjnego hosta lub JDK
cacertsna format BCFKS (zalecane, jeśli chcesz uwzględnić standardowe zaufane główne urzędy certyfikacji systemu operacyjnego zarządzane przezupdate-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 -
Opcja B: utwórz nowy magazyn BCFKS z niestandardowymi certyfikatami CA (
.pemlub.crt) albo zaimportuj dodatkowe niestandardowe certyfikaty CA do istniejącego magazynu BCFKS (np.my-cacerts.bcfksz opcji 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 -
Opcjonalnie: sprawdź zawartość magazynu 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"
-
-
Na każdym węźle, na którym działa dowolny z komponentów Edge wymienionych w kroku 3, skopiuj plik BCFKS do odpowiedniej ścieżki i upewnij się, że użytkownik
apigeemoże go odczytać: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 -
Na każdym węźle utwórz lub zmodyfikuj plik konfiguracji każdego zainstalowanego komponentu z poniższej tabeli (powtarzając kroki 3–6 dla każdego wymienionego komponentu na węźle):
Komponent Plik 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 -
Dodaj do pliku konfiguracji te wiersze:
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
Zastąp
/opt/apigee/customer/application/my-cacerts.bcfksiYOUR_STORE_PASSWORDścieżką i hasłem do pliku BCFKScacerts. -
Upewnij się, że użytkownik
apigeejest właścicielem pliku konfiguracji i może go odczytać:chown apigee:apigee /opt/apigee/customer/application/FILE.properties
-
Uruchom ponownie komponent:
/opt/apigee/apigee-service/bin/apigee-service COMPONENT restart
Dodatek
Przykładowe polecenia operacji na magazynie kluczy BCFKS
Polecenie poniżej generuje magazyn kluczy BCFKS z parą klucza i certyfikatu podpisanego samodzielnie:
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
Polecenia narzędzia keytool są zgodne z tymi, które są zwykle używane, ale w poleceniu narzędzia keytool należy uwzględnić te opcje:
--storetype BCFKS -providerpath /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar -providerclass org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider -providername BCFIPS
Argumenty narzędzia Keytool
| Argument narzędzia Keytool | Opis |
|---|---|
-storetype |
Ustaw typ sklepu na BCFKS. |
-providerpath |
Wskaż ścieżkę do bc-fips-XXXX.jar. Ta wersja może się zmienić w przyszłych wersjach OPDK. Użyj wersji dostarczonej przez Apigee lub pobierz ją z repozytoriów Bouncycastle. W przypadku OPDK 4.53 ścieżka powinna być taka: /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar. |
-providerclass |
Ustaw wartość org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider. |
-providername |
Ustaw wartość BCFIPS. |
Podobnych poleceń keytool można używać do importowania lub eksportowania certyfikatów i kluczy z magazynu kluczy w formacie BCFKS lub do niego. Więcej informacji o pracy z BCFKS znajdziesz w dokumentacji BouncyCastle.
Magazyn PKCS12
Aby wygenerować magazyn PKCS12, możesz użyć poleceń 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
Jeśli masz własny klucz prywatny i certyfikat i chcesz je przekonwertować na format PKCS12, zapoznaj się z artykułem Konwertowanie certyfikatów na obsługiwany format.