Edge for Private Cloud على RHEL 8.X المزوَّد بنظام FIPS

يقدّم هذا القسم إرشادات حول تفعيل وضع 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 لاستخدامه، اتّبِع الخطوات التالية:

  1. أنشئ ملف 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"
  2. في كل عقدة تشغّل أيًا من مكوّنات Edge المدرَجة في الخطوة 3، انسخ ملف BCFKS إلى مسار مناسب وتأكَّد من أنّ المستخدم apigee يمكنه قراءته:

    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. في كل عقدة، أنشئ ملف الإعداد أو عدِّله لكل مكوّن مثبَّت من الجدول التالي (مع تكرار الخطوات من 3 إلى 6 لكل مكوّن مدرَج في العقدة):

    المكوّن ملف
    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. أضِف الأسطر التالية إلى ملف الإعداد:

    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 بالمسار وكلمة المرور لملف BCFKS cacerts.

  5. تأكَّد من أنّ المستخدم apigee يملك ملف الإعداد ويمكنه قراءته:

    chown apigee:apigee /opt/apigee/customer/application/FILE.properties
  6. أعِد تشغيل المكوّن:

    /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، يُرجى الرجوع إلى تحويل الشهادات إلى تنسيق متوافق.