राऊटर और मैसेज प्रोसेसर के बीच TLS कॉन्फ़िगर करना

डिफ़ॉल्ट रूप से, राऊटर और मैसेज प्रोसेसर के बीच टीएलएस की सुविधा बंद होती है.

किसी राऊटर और मैसेज प्रोसेसर के बीच टीएलएस एन्क्रिप्शन चालू करने के लिए:

  1. पक्का करें कि राऊटर, मैसेज प्रोसेसर पर पोर्ट 8082 को ऐक्सेस कर सकता हो.
  2. कीस्टोर जेकेएस फ़ाइल जनरेट करें. इसमें आपका टीएलएस सर्टिफ़िकेट और निजी पासकोड होना चाहिए. ज़्यादा जानकारी के लिए, Edge On Premises के लिए टीएलएस/एसएसएल कॉन्फ़िगर करना लेख पढ़ें.
  3. कीस्टोर जेकेएस फ़ाइल को, मैसेज प्रोसेसर सर्वर पर किसी डायरेक्ट्री में कॉपी करें. जैसे, /opt/apigee/customer/application.
  4. जेकेएस फ़ाइल की अनुमतियां और मालिकाना हक बदलें:
    chown apigee:apigee /opt/apigee/customer/application/keystore.jks
    chmod 600 /opt/apigee/customer/application/keystore.jks

    यहां keystore.jks आपकी कीस्टोर फ़ाइल का नाम है.

  5. /opt/apigee/customer/application/message-processor.properties फ़ाइल में बदलाव करें. अगर यह फ़ाइल मौजूद नहीं है, तो इसे बनाएं.
  6. message-processor.properties फ़ाइल में ये प्रॉपर्टी सेट करें:
    conf_message-processor-communication_local.http.ssl=true
    conf/message-processor-communication.properties+local.http.port=8443
    conf/message-processor-communication.properties+local.http.ssl.keystore.type=jks
    conf/message-processor-communication.properties+local.http.ssl.keystore.path=/opt/apigee/customer/application/keystore.jks
    conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
    # Enter the obfuscated keystore password below.
    conf/message-processor-communication.properties+local.http.ssl.keystore.password=OBF:obsPword

    यहां keystore.jks आपकी कीस्टोर फ़ाइल है. वहीं, obsPword, कीस्टोर और keyalias के लिए, छिपाया गया पासवर्ड है.

    ध्यान दें: का मान

    conf/message-processor-communication.properties+local.http.ssl.keyalias=apigee-devtest
    की वैल्यू, keytool कमांड के -alias विकल्प से मिली वैल्यू के बराबर होनी चाहिए. इसके बारे में, जेकेएस फ़ाइल बनाना सेक्शन के आखिर में बताया गया है.

    छिपाया गया पासवर्ड जनरेट करने के बारे में जानने के लिए, Edge On Premises के लिए टीएलएस/एसएसएल कॉन्फ़िगर करना लेख पढ़ें.

  7. पक्का करें कि message-processor.properties फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता के पास हो:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  8. मैसेज प्रोसेसर और राऊटर बंद करें:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  9. राऊटर पर, /opt/nginx/conf.d डायरेक्ट्री में मौजूद सभी फ़ाइलें मिटाएं:
    rm -f /opt/nginx/conf.d/*
  10. मैसेज प्रोसेसर और राऊटर चालू करें:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start
    /opt/apigee/apigee-service/bin/apigee-service edge-router start
  11. यह प्रोसेस, हर मैसेज प्रोसेसर के लिए दोहराएं.

राऊटर और मैसेज प्रोसेसर के बीच टीएलएस चालू होने के बाद, मैसेज प्रोसेसर की लॉग फ़ाइल में यह INFO मैसेज दिखता है:

MessageProcessorHttpSkeletonFactory.configureSSL() : Instantiating Keystore of type: jks

इस INFO स्टेटमेंट से पुष्टि होती है कि राऊटर और मैसेज प्रोसेसर के बीच टीएलएस काम कर रहा है.

यहां दी गई टेबल में, message-processor.properties में उपलब्ध सभी प्रॉपर्टी की सूची दी गई है:

प्रॉपर्टी ब्यौरा
conf_message-processor-communication_local.
  http.host=localhost_or_IP_address
ज़रूरी नहीं. राऊटर कनेक्शन के लिए, सुनने के लिए होस्टनेम. इससे रजिस्ट्रेशन के दौरान कॉन्फ़िगर किया गया होस्ट नेम बदल जाता है.
conf/message-processor-communication.
  properties+local.http.port=8998
ज़रूरी नहीं. राऊटर कनेक्शन के लिए, सुनने के लिए पोर्ट. डिफ़ॉल्ट रूप से, यह 8998 पर सेट होता है.
conf_message-processor-communication_local.
  http.ssl=[ false | true ]
टीएलएस/एसएसएल चालू करने के लिए, इसे true पर सेट करें. डिफ़ॉल्ट रूप से, यह false पर सेट होता है. टीएलएस/एसएसएल चालू होने पर, आपको local.http.ssl.keystore.path और local.http.ssl.keyalias सेट करना होगा.
conf/message-processor-communication.
  properties+local.http.ssl.keystore.path=
कीस्टोर (जेकेएस या पीकेसीएस12) के लिए, लोकल फ़ाइल सिस्टम का पाथ. होने पर, यह ज़रूरी हैlocal.http.ssl=true.
conf/message-processor-communication.
  properties+local.http.ssl.keyalias=
टीएलएस/एसएसएल कनेक्शन के लिए, कीस्टोर से इस्तेमाल किया जाने वाला की एलियास. होने पर, यह ज़रूरी हैlocal.http.ssl=true.
conf/message-processor-communication.
  properties+local.http.ssl.keyalias.password=
कीस्टोर में मौजूद पासकोड को एन्क्रिप्ट (सुरक्षित) करने के लिए इस्तेमाल किया गया पासवर्ड. छिपाए गए पासवर्ड का इस्तेमाल, इस फ़ॉर्मैट में करें:
OBF:obsPword
conf/message-processor-communication.
  properties+local.http.ssl.keystore.type=jks
कीस्टोर का टाइप. फ़िलहाल, सिर्फ़ जेकेएस और पीकेसीएस12 का इस्तेमाल किया जा सकता है. डिफ़ॉल्ट रूप से, यह जेकेएस पर सेट होता है.
conf/message-processor-communication.
  properties+local.http.ssl.keystore.password=
ज़रूरी नहीं. कीस्टोर के लिए, छिपाया गया पासवर्ड. छिपाए गए पासवर्ड का इस्तेमाल, इस फ़ॉर्मैट में करें:
OBF:obsPword
conf_message-processor-communication_local.
  http.ssl.ciphers=cipher1,cipher2
ज़रूरी नहीं. कॉन्फ़िगर करने पर, सिर्फ़ सूची में शामिल साइफ़र की अनुमति होती है. अगर इसे छोड़ दिया जाता है, तो जेडीके के साथ काम करने वाले सभी साइफ़र का इस्तेमाल करें.