Edge dla Private Cloud w RHEL 8.X z obsługą FIPS

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:

  1. Wygeneruj własny plik w formacie BCFKS cacerts zawierają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 cacerts na format BCFKS (zalecane, jeśli chcesz uwzględnić standardowe zaufane główne urzędy certyfikacji systemu operacyjnego zarządzane przez 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
    • Opcja B: utwórz nowy magazyn BCFKS z niestandardowymi certyfikatami CA (.pem lub .crt) albo zaimportuj dodatkowe niestandardowe certyfikaty CA do istniejącego magazynu BCFKS (np. my-cacerts.bcfks z 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"
  2. 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 apigee może go odczytać:

    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. 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.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. 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.bcfks i YOUR_STORE_PASSWORD ścieżką i hasłem do pliku BCFKS cacerts.

  5. Upewnij się, że użytkownik apigee jest właścicielem pliku konfiguracji i może go odczytać:

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