این بخش راهنماییهایی درباره فعال کردن حالت FIPS در RHEL 8 ارائه میدهد تا محیطی امن و مطابق با استانداردها برای Edge for Private Cloud نسخههای ۴.۵۳.۰۰ یا بالاتر فراهم شود.
ازپیش نصب کردن
مطمئن شوید که FIPS در گرههای شما بههمراه سایر پیشنیازهای پیکربندی استاندارد فهرستشده در سند نمای کلی نصب Edge فعال باشد.
fips-mode-setup --check FIPS mode is enabled. # Command output
اگر حالت FIPS درحالحاضر غیرفعال است، برای دستورالعملهای مربوط به نحوه فعال کردن آن به اسناد رسمی Red Hat مراجعه کنید: تغییر RHEL 8 به حالت FIPS.
الزامات جاوا
Java مورداستفاده شما باید از مخزن Red Hat بارگیری شود تا اطمینان حاصل شود که ماژولهای امنیتی آن با FIPS مطابقت دارند و محدودیتهای خاص FIPS را ازطریق امنیت Java فعال میکنند.
نصب
در مرجع فایل پیکربندی Edge، FIPS_OS=true را در هر گره تنظیم کنید. میتوانید مراحل نصب عمومی Edge for Private Cloud را مثل همیشه دنبال کنید.
قالب کلید خصوصی
فقط از قالب PKCS12/PFX میتوان برای بارگذاری کلیدهای خصوصی در مخزن کلید Apigee برای استفاده در پراکسیهای میانای برنامهسازی کاربردی یا میزبانهای مجازی استفاده کرد. برای راهنمایی درباره ایجاد فایل، به تبدیل گواهیها به قالب پشتیبانیشده مراجعه کنید.
عملیات کلی «امنیت لایه انتقال»
هنگام استفاده از Edge برای Private Cloud نسخه ۴.۵۳.۰۰ یا جدیدتر در RHEL 8.X با FIPS فعال، اکثر پیکربندیهای مؤلفه مرتبط با TLS در Edge باید ازطریق مخازن کلید با قالب PKCS12 یا BCFKS انجام شوند.
برای جزئیات بیشتر، به اسناد یا یادداشتهای مختص FIPS در مقالههای مربوط به پیکربندی TLS مراجعه کنید. پیوست برخیاز فرمانهای مفید را که میتوان برای تولید این keystoreها استفاده کرد فهرست میکند.
Java keystore/truststore پیشفرض
وقتی از Edge for Private Cloud نسخه ۴.۵۳.۰۰ در RHEL 8.X با FIPS فعال استفاده میکنید، «پردازشگر پیام»، «سرور مدیریت»، و دیگر مؤلفههای edge-* بهطور پیشفرض به یک جایبان BCFKS keystore و truststore (/opt/apigee/edge-gateway/vault/bcfks-cacerts) که با محصول ارسال شده است اشاره میکنند.
برای تولید فروشگاه BCFKS cacerts خودتان و پیکربندی مؤلفههای Edge برای استفاده از آن، این مراحل را دنبال کنید:
-
فایل
cacertsبا قالب BCFKS خودتان را که حاوی همه گواهیهای CA مورد اعتمادتان است تولید کنید. مطمئن شوید که گذرواژه keystore و گذرواژه کلید یکسان باشند (و اگر بررسیهای گذرواژه BCFIPS سختگیرانه اعمال میشود، حداقل ۱۴ نویسه داشته باشند).-
گزینه الف: تبدیل فضای ذخیرهسازی سیستمعامل میزبان یا JDK
cacertsبه قالب BCFKS (توصیه میشود اگر میخواهید CAهای ریشه مورداعتماد سیستمعامل استاندارد را که توسط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 -
گزینه ب: فروشگاه BCFKS جدیدی با گواهینامههای CA سفارشی (
.pemیا.crt) ایجاد کنید، یا گواهینامههای CA سفارشی بیشتری را به فروشگاه BCFKS موجود (مثلmy-cacerts.bcfksاز گزینه الف) وارد کنید: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 -
اختیاری: محتوای فروشگاه 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"
-
-
در هر گرهای که هریک از مؤلفههای Edge فهرستشده در مرحله ۳ را اجرا میکند، فایل BCFKS را در مسیر مناسبی کپی کنید و مطمئن شوید که کاربر
apigeeمیتواند آن را بخواند: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 -
در هر گره، فایل پیکربندی را برای هر مؤلفه نصبشده از جدول زیر ایجاد یا ویرایش کنید (مراحل ۳ تا ۶ را برای هر مؤلفه فهرستشده در گره تکرار کنید):
مؤلفه فایل 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 -
خطوط زیر را به فایل پیکربندی اضافه کنید:
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وYOUR_STORE_PASSWORDرا با مسیر و گذرواژه فایل BCFKScacertsخود جایگزین کنید. -
مطمئن شوید که کاربر
apigeeمالک فایل پیکربندی است و میتواند آن را بخواند:chown apigee:apigee /opt/apigee/customer/application/FILE.properties
-
بازراهاندازی عنصر:
/opt/apigee/apigee-service/bin/apigee-service COMPONENT restart
ضمیمه
فرمانهای نمونه عملیات keystore BCFKS
فرمان زیر یک keystore BCFKS با جفت کلید و گواهی خودامضا تولید میکند:
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 با فرمانهایی که معمولاً استفاده میشوند سازگار میمانند، اما گزینههای زیر باید در فرمان Keytool گنجانده شوند:
--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
| متغیر Keytool | شرح |
|---|---|
-storetype |
نوع فروشگاه را روی BCFKS تنظیم کنید. |
-providerpath |
مسیر bc-fips-XXXX.jar را مشخص کنید. این نسخه ممکن است در نسخههای پخش آتی OPDK تغییر کند. از نسخهای که Apigee ارائه کرده است استفاده کنید یا آن را از مخازن Bouncycastle بارگیری کنید. برای OPDK 4.53، مسیر باید /opt/apigee/edge-gateway/lib/thirdparty/bc-fips-1.0.2.4.jar باشد. |
-providerclass |
این را روی org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider تنظیم کنید. |
-providername |
این را روی BCFIPS تنظیم کنید. |
از فرمانهای مشابه keytool میتوان برای وارد کردن یا صادر کردن گواهینامهها و/یا کلیدها از یا به یک keystore با قالب BCFKS استفاده کرد. برای کسب اطلاعات بیشتر درباره نحوه کار با BCFKS، اسناد BouncyCastle را بررسی کنید.
PKCS12 Store
برای تولید فروشگاه PKCS12، میتوان از فرمانهای 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
اگر کلید خصوصی و گواهی خودتان را دارید و باید آنها را به قالب PKCS12 تبدیل کنید، به تبدیل گواهیها به قالب پشتیبانیشده مراجعه کنید.