FIPS özellikli RHEL 8.X'te Edge for Private Cloud

Bu bölümde, RHEL 8'de FIPS modunu etkinleştirme ve Edge for Private Cloud 4.53.00 veya sonraki sürümler için güvenli ve uyumlu bir ortam sağlama hakkında bilgi verilmektedir.

Önceden yükle

Edge Kurulumuna Genel Bakış dokümanında listelenen diğer standart yapılandırma ön koşullarıyla birlikte düğümlerinizde FIPS'nin etkinleştirildiğinden emin olun.

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

FIPS modu şu anda devre dışıysa etkinleştirme talimatları için resmi Red Hat belgelerine bakın: RHEL 8'i FIPS moduna geçirme.

Java gereksinimleri

Kullandığınız Java, güvenlik modüllerinin FIPS uyumlu olmasını sağlamak için Red Hat'in deposundan indirilmelidir. Bu sayede Java güvenliği aracılığıyla FIPS'e özgü kısıtlamalar etkinleştirilir.

Kurulum

Edge Yapılandırma Dosyası Referansı'nda her düğümde FIPS_OS=true değerini ayarlayın. Edge for Private Cloud'un genel yükleme adımlarını her zamanki gibi uygulayabilirsiniz.

Özel anahtar biçimi

API proxy'lerinizde veya sanal ana makinelerinizde kullanılmak üzere Apigee anahtar depolarına özel anahtar yüklemek için yalnızca PKCS12/PFX biçimi kullanılabilir. Dosyayı oluşturmayla ilgili talimatlar için Sertifikaları desteklenen biçime dönüştürme başlıklı makaleyi inceleyin.

Genel TLS işlemleri

FIPS özellikli RHEL 8.X'te Edge for Private Cloud 4.53.00 veya sonraki sürümleri kullanırken Edge'in TLS ile ilgili bileşen yapılandırmalarının çoğu PKCS12 veya BCFKS biçimli anahtar depoları aracılığıyla yapılmalıdır.

Daha fazla bilgi için TLS yapılandırmasıyla ilgili makalelerdeki FIPS'e özel belgelere veya notlara bakın. Ek bölümünde, bu anahtar depolarını oluşturmak için kullanılabilecek bazı faydalı komutlar listelenmiştir.

Varsayılan Java anahtar deposu/güven deposu

FIPS özellikli RHEL 8.X'te Edge for Private Cloud 4.53.00'ı kullandığınızda Mesaj İşlemciniz, Yönetim Sunucunuz ve diğer edge-* bileşenleriniz varsayılan olarak ürünle birlikte gönderilen bir yer tutucu BCFKS anahtar deposunu ve güvenilir depoyu (/opt/apigee/edge-gateway/vault/bcfks-cacerts) gösterir.

Kendi BCFKS cacerts deponuzu oluşturmak ve Edge bileşenlerinizi bu depoyu kullanacak şekilde yapılandırmak için aşağıdaki adımları uygulayın:

  1. Güvenmek istediğiniz tüm CA sertifikalarını içeren kendi BCFKS biçimli cacerts dosyanızı oluşturun. Anahtar deposu şifresi ile anahtar şifresinin aynı olduğundan (ve katı BCFIPS şifre kontrolleri geçerliyse en az 14 karakter olduğundan) emin olun.

    • A seçeneği: Ana makine OS'sini veya JDK cacerts deposunu BCFKS biçimine dönüştürün (update-ca-trust tarafından yönetilen standart OS güvenilir kök CA'larını dahil etmek istiyorsanız önerilir):

      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
    • B seçeneği: Özel CA sertifikaları (.pem veya .crt) içeren yeni bir BCFKS deposu oluşturun ya da mevcut bir BCFKS deposuna (ör. A seçeneğindeki my-cacerts.bcfks) ek özel CA sertifikaları aktarın:

      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
    • İsteğe bağlı: BCFKS deponuzun içeriğini doğrulayın:

      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. 3. adımda listelenen Edge bileşenlerinden herhangi birini çalıştıran her düğümde, BCFKS dosyasını uygun bir yola kopyalayın ve apigee kullanıcısının dosyayı okuyabildiğinden emin olun:

    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. Her düğümde, aşağıdaki tabloda yer alan her yüklü bileşen için yapılandırma dosyasını oluşturun veya düzenleyin (düğümde listelenen her bileşen için 3-6. adımları tekrarlayın):

    Bileşen Dosya
    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. Yapılandırma dosyasına aşağıdaki satırları ekleyin:

    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

    /opt/apigee/customer/application/my-cacerts.bcfks ve YOUR_STORE_PASSWORD değerlerini, BCFKS cacerts dosyanızın yolu ve şifresiyle değiştirin.

  5. apigee kullanıcısının yapılandırma dosyasının sahibi olduğundan ve dosyayı okuyabildiğinden emin olun:

    chown apigee:apigee /opt/apigee/customer/application/FILE.properties
  6. Bileşeni yeniden başlatın:

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

Ek

BCFKS anahtar deposu işlemi örnek komutları

Aşağıdaki komut, kendinden imzalı bir anahtar ve sertifika çifti içeren bir BCFKS anahtar deposu oluşturur:

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

Keytool komutları, genellikle kullanılan komutlarla tutarlıdır ancak keytool komutuna aşağıdaki seçenekler eklenmelidir:

--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 Bağımsız Değişkenleri

Keytool Bağımsız Değişkeni Açıklama
-storetype Mağaza türünü BCFKS olarak ayarlayın.
-providerpath bc-fips-XXXX.jar yolunu belirtin. Bu sürüm, gelecekteki OPDK sürümlerinde değişebilir. Apigee tarafından gönderilen sürümü kullanın veya Bouncycastle'ın depolarından indirin. OPDK 4.53 için yol /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar olmalıdır.
-providerclass Bunu org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider olarak ayarlayın.
-providername Bunu BCFIPS olarak ayarlayın.

Sertifikaları ve/veya anahtarları BCFKS biçimindeki bir anahtar deposundan içe aktarmak veya bu depoya aktarmak için benzer keytool komutları kullanılabilir. BCFKS ile çalışma hakkında daha fazla bilgi için BouncyCastle belgelerini inceleyin.

PKCS12 Store

PKCS12 deposu oluşturmak için openssl komutları kullanılabilir:

# 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

Kendi gizli anahtarınız ve sertifikanız varsa ve bunları PKCS12 biçimine dönüştürmeniz gerekiyorsa Sertifikaları desteklenen biçime dönüştürme başlıklı makaleyi inceleyin.