‫Edge for Private Cloud در RHEL 8.X با قابلیت FIPS

این بخش راهنمایی‌هایی درباره فعال کردن حالت 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 برای استفاده از آن، این مراحل را دنبال کنید:

  1. فایل 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"
  2. در هر گره‌ای که هریک از مؤلفه‌های Edge فهرست‌شده در مرحله ۳ را اجرا می‌کند، فایل 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. در هر گره، فایل پیکربندی را برای هر مؤلفه نصب‌شده از جدول زیر ایجاد یا ویرایش کنید (مراحل ۳ تا ۶ را برای هر مؤلفه فهرست‌شده در گره تکرار کنید):

    مؤلفه فایل
    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

ضمیمه

فرمان‌های نمونه عملیات 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 تبدیل کنید، به تبدیل گواهی‌ها به قالب پشتیبانی‌شده مراجعه کنید.