يقدّم هذا القسم إرشادات حول تفعيل وضع FIPS على RHEL 8، ما يضمن توفير بيئة آمنة ومتوافقة مع الإصدار 4.53.00 من Edge for Private Cloud أو الإصدارات الأحدث.
تثبيت مسبق
تأكَّد من تفعيل معيار FIPS على العُقد إلى جانب المتطلبات الأساسية الأخرى للإعدادات العادية المدرَجة في مستندات نظرة عامة على تثبيت Edge.
fips-mode-setup --check FIPS mode is enabled. # Command output
إذا كان وضع FIPS غير مفعَّل حاليًا، يُرجى الرجوع إلى مستندات Red Hat الرسمية للحصول على تعليمات حول كيفية تفعيله: التبديل من RHEL 8 إلى وضع FIPS.
متطلبات Java
يجب تنزيل Java التي تستخدمها من مستودع Red Hat لضمان توافق وحدات الأمان مع معيار FIPS، ما يتيح القيود الخاصة بمعيار FIPS من خلال أمان Java.
تثبيت
في مرجع ملف إعدادات Edge، اضبط FIPS_OS=true على كل عُقدة. يمكنك اتّباع خطوات التثبيت العامة لـ Edge for Private Cloud كالمعتاد.
تنسيق المفتاح الخاص
يمكن استخدام تنسيق PKCS12/PFX فقط لتحميل المفاتيح الخاصة إلى مخازن مفاتيح Apigee لاستخدامها في الخوادم الوكيلة لواجهة برمجة التطبيقات أو المضيفين الافتراضيين. للحصول على إرشادات حول إنشاء الملف، يُرجى الرجوع إلى تحويل الشهادات إلى تنسيق متوافق.
عمليات بروتوكول أمان طبقة النقل (TLS) العامة
عند استخدام Edge for Private Cloud الإصدار 4.53.00 أو الإصدارات الأحدث على نظام التشغيل RHEL 8.X المفعَّل فيه معيار FIPS، يجب ضبط معظم إعدادات مكوّنات Edge ذات الصلة ببروتوكول أمان طبقة النقل (TLS) من خلال مخازن مفاتيح بتنسيق PKCS12 أو BCFKS.
لمزيد من التفاصيل، يُرجى الرجوع إلى المستندات أو الملاحظات الخاصة بمعيار FIPS في المقالات ذات الصلة بإعدادات بروتوكول أمان طبقة النقل (TLS). يسرد الملحق بعض الأوامر المفيدة التي يمكن استخدامها لإنشاء مخازن المفاتيح هذه.
ملف تخزين مفاتيح/ملف تخزين موثوق به تلقائي في Java
عند استخدام Edge for Private Cloud 4.53.00 على RHEL 8.X المفعَّل فيه معيار معالجة المعلومات الفيدرالية (FIPS)، يشير معالج الرسائل وخادم الإدارة ومكوّنات edge-* الأخرى تلقائيًا إلى مخزن مفاتيح ومخزن ثقة BCFKS عنصر نائب (/opt/apigee/edge-gateway/vault/bcfks-cacerts) يتم شحنه مع المنتج.
لإنشاء مخزن BCFKS cacerts الخاص بك وضبط مكوّنات Edge لاستخدامه، اتّبِع الخطوات التالية:
-
أنشئ ملف
cacertsبتنسيق BCFKS يحتوي على جميع شهادات CA التي تريد الوثوق بها. تأكَّد من أنّ كلمة مرور مخزن المفاتيح وكلمة مرور المفتاح متطابقتان (وأنّ طولهما لا يقل عن 14 حرفًا في حال تطبيق عمليات التحقّق الصارمة من كلمات مرور BCFIPS).-
الخيار "أ": تحويل مخزن نظام التشغيل المضيف أو JDK
cacertsإلى تنسيق BCFKS (يُنصح به إذا أردت تضمين هيئات إصدار الشهادات الجذر الموثوق بها لنظام التشغيل العادي التي تديرها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 المدرَجة في الخطوة 3، انسخ ملف 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 -
في كل عقدة، أنشئ ملف الإعداد أو عدِّله لكل مكوّن مثبَّت من الجدول التالي (مع تكرار الخطوات من 3 إلى 6 لكل مكوّن مدرَج في العقدة):
المكوّن ملف 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
الملحق
أمثلة على أوامر عمليات مخزن مفاتيح BCFKS
ينشئ الأمر أدناه ملف تخزين مفاتيح 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 مشابهة لاستيراد أو تصدير الشهادات و/أو المفاتيح من أو إلى مخزن مفاتيح بتنسيق BCFKS. لمزيد من المعلومات حول كيفية العمل مع BCFKS، يُرجى الاطّلاع على مستندات BouncyCastle.
مخزن PKCS12
لإنشاء مخزن 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، يُرجى الرجوع إلى تحويل الشهادات إلى تنسيق متوافق.