FIPS की सुविधा वाले RHEL 8.X पर Edge for Private Cloud

इस सेक्शन में, RHEL 8 पर एफ़आईपीएस मोड चालू करने के बारे में बताया गया है. इससे Edge for Private Cloud के 4.53.00 या इसके बाद के वर्शन के लिए, सुरक्षित और नियमों का पालन करने वाला एनवायरमेंट मिलता है.

पहले से इंस्टॉल करें

पक्का करें कि आपके नोड पर एफ़आईपीएस चालू हो. साथ ही, Edge इंस्टॉलेशन की खास जानकारी दस्तावेज़ में बताई गई, स्टैंडर्ड कॉन्फ़िगरेशन की अन्य ज़रूरी शर्तें पूरी की गई हों.

fips-mode-setup --check  
FIPS mode is enabled.  # Command output

अगर फ़िलहाल FIPS मोड बंद है, तो इसे चालू करने के निर्देशों के लिए, Red Hat का आधिकारिक दस्तावेज़ देखें: RHEL 8 को FIPS मोड पर स्विच करना.

Java के लिए ज़रूरी शर्तें

इस्तेमाल किया जाने वाला Java, Red Hat के डेटा स्टोर करने की जगह से डाउनलोड किया जाना चाहिए. इससे यह पक्का किया जा सकेगा कि इसके सुरक्षा मॉड्यूल, एफ़आईपीएस के मुताबिक हों. साथ ही, Java की सुरक्षा के ज़रिए एफ़आईपीएस से जुड़ी पाबंदियां चालू की जा सकें.

इंस्टॉल करना

Edge कॉन्फ़िगरेशन फ़ाइल रेफ़रंस में, हर नोड पर FIPS_OS=true सेट करें. Edge for Private Cloud को इंस्टॉल करने के लिए, सामान्य चरणों का पालन किया जा सकता है.

निजी पासकोड का फ़ॉर्मैट

Apigee कीस्टोर में निजी कुंजियां अपलोड करने के लिए, सिर्फ़ PKCS12/PFX फ़ॉर्मैट का इस्तेमाल किया जा सकता है. इन कुंजियों का इस्तेमाल, आपके एपीआई प्रॉक्सी या वर्चुअल होस्ट में किया जाता है. फ़ाइल बनाने के बारे में जानने के लिए, सर्टिफ़िकेट को काम करने वाले फ़ॉर्मैट में बदलना लेख पढ़ें.

सामान्य टीएलएस ऑपरेशन

FIPS की सुविधा वाले RHEL 8.X पर, Edge for Private Cloud 4.53.00 या इसके बाद के वर्शन का इस्तेमाल करते समय, Edge के ज़्यादातर टीएलएस से जुड़े कॉम्पोनेंट कॉन्फ़िगरेशन, PKCS12 या BCFKS फ़ॉर्मैट वाले कीस्टोर के ज़रिए करने होंगे.

ज़्यादा जानकारी के लिए, टीएलएस कॉन्फ़िगरेशन के लिए, एफ़आईपीएस से जुड़े दस्तावेज़ या काम के लेखों में दिए गए नोट देखें. परिशिष्ट में कुछ ऐसे मददगार निर्देश दिए गए हैं जिनका इस्तेमाल करके, ये कीस्टोर जनरेट किए जा सकते हैं.

डिफ़ॉल्ट Java कीस्टोर/ट्रस्टस्टोर

FIPS की सुविधा वाले RHEL 8.X पर Edge for Private Cloud 4.53.00 का इस्तेमाल करने पर, आपका मैसेज प्रोसेसर, मैनेजमेंट सर्वर, और अन्य edge-* कॉम्पोनेंट, डिफ़ॉल्ट रूप से प्रॉडक्ट के साथ भेजे गए प्लेसहोल्डर BCFKS कीस्टोर और ट्रस्टस्टोर (/opt/apigee/edge-gateway/vault/bcfks-cacerts) पर ले जाते हैं.

अपना BCFKS cacerts स्टोर जनरेट करने और इसका इस्तेमाल करने के लिए, Edge कॉम्पोनेंट को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  1. अपनी खुद की BCFKS फ़ॉर्मैट वाली cacerts फ़ाइल जनरेट करें. इसमें वे सभी सीए सर्टिफ़िकेट शामिल होने चाहिए जिन पर आपको भरोसा करना है. पक्का करें कि कीस्टोर पासवर्ड और कुंजी पासवर्ड एक ही हों. साथ ही, अगर BCFIPS पासवर्ड की सख्त जांच लागू होती है, तो पासवर्ड में कम से कम 14 वर्ण होने चाहिए.

    • विकल्प A: होस्ट ओएस या 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
    • दूसरा विकल्प: कस्टम सीए सर्टिफ़िकेट (.pem या .crt) के साथ नया BCFKS स्टोर बनाएं या किसी मौजूदा 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

अपेंडिक्स

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 फ़ॉर्मैट वाले कीस्टोर से सर्टिफ़िकेट और/या कुंजियों को इंपोर्ट या एक्सपोर्ट किया जा सकता है. बीसीएफ़केएस के साथ काम करने के तरीके के बारे में ज़्यादा जानने के लिए, 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 फ़ॉर्मैट में बदलना है, तो सर्टिफ़िकेट को काम करने वाले फ़ॉर्मैट में बदलना लेख पढ़ें.