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:
-
Güvenmek istediğiniz tüm CA sertifikalarını içeren kendi BCFKS biçimli
cacertsdosyanı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
cacertsdeposunu BCFKS biçimine dönüştürün (update-ca-trusttarafı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ı (
.pemveya.crt) içeren yeni bir BCFKS deposu oluşturun ya da mevcut bir BCFKS deposuna (ör. A seçeneğindekimy-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"
-
-
3. adımda listelenen Edge bileşenlerinden herhangi birini çalıştıran her düğümde, BCFKS dosyasını uygun bir yola kopyalayın ve
apigeekullanıcısının dosyayı okuyabildiğinden emin olun: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 -
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.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 -
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.bcfksveYOUR_STORE_PASSWORDdeğerlerini, BCFKScacertsdosyanızın yolu ve şifresiyle değiştirin. -
apigeekullanı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
-
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.