नए Edge अनुभव के लिए TLS कॉन्फ़िगर करना

Edge for Private Cloud v4.19.01

डिफ़ॉल्ट रूप से, New Edge experience को एचटीटीपी पर ऐक्सेस किया जाता है. इसके लिए, New Edge experience नोड के आईपी पते या डीएनएस नाम और पोर्ट 3001 का इस्तेमाल किया जाता है. उदाहरण के लिए:

http://newue_IP:3001

इसके अलावा, New Edge experience के लिए टीएलएस ऐक्सेस को कॉन्फ़िगर किया जा सकता है, ताकि इसे इस फ़ॉर्म में ऐक्सेस किया जा सके:

https://newue_IP:3001

टीएलएस से जुड़ी ज़रूरी शर्तें

Edge का नया वर्शन, सिर्फ़ TLS v1.2 के साथ काम करता है. अगर आपने Edge के नए वर्शन पर टीएलएस को चालू किया है, तो उपयोगकर्ताओं को Edge के नए वर्शन से कनेक्ट करने के लिए, टीएलएस v1.2 के साथ काम करने वाले ब्राउज़र का इस्तेमाल करना होगा.

टीएलएस कॉन्फ़िगरेशन प्रॉपर्टी

Edge के नए वर्शन के लिए टीएलएस को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

जहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने Edge के नए वर्शन को इंस्टॉल करने के लिए किया था.

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

प्रॉपर्टी ब्यौरा ज़रूरी है?
MANAGEMENT_UI_SCHEME

यह नीति, Edge के नए वर्शन को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले प्रोटोकॉल, "http" या "https" को सेट करती है. डिफ़ॉल्ट वैल्यू "http" होती है. TLS को चालू करने के लिए, इसे "https" पर सेट करें:

MANAGEMENT_UI_SCHEME=https
 		हां
MANAGEMENT_UI_TLS_OFFLOAD

अगर "n" है, तो इसका मतलब है कि New Edge experience को भेजे गए टीएलएस अनुरोध, New Edge experience पर ही खत्म हो जाते हैं. आपको MANAGEMENT_UI_TLS_KEY_FILE और MANAGEMENT_UI_TLS_CERT_FILE. सेट करना होगा

अगर "y" है, तो इसका मतलब है कि New Edge Experience को भेजे गए टीएलएस अनुरोध, लोड बैलेंसर पर खत्म हो जाते हैं. इसके बाद, लोड बैलेंसर एचटीटीपी का इस्तेमाल करके, अनुरोध को New Edge Experience पर फ़ॉरवर्ड कर देता है.

अगर लोड बैलेंसर पर टीएलएस को बंद किया जाता है, तो New Edge को अब भी यह पता होना चाहिए कि ओरिजनल अनुरोध, टीएलएस पर आया था. उदाहरण के लिए, कुछ कुकी में सुरक्षित फ़्लैग सेट होता है.

आपको MANAGEMENT_UI_SCHEME को "https" पर सेट करना होगा. ऐसा न करने पर, MANAGEMENT_UI_TLS_OFFLOAD को अनदेखा कर दिया जाएगा:

MANAGEMENT_UI_SCHEME=https
MANAGEMENT_UI_TLS_OFFLOAD=y
 		हां
MANAGEMENT_UI_TLS_KEY_FILE

MANAGEMENT_UI_TLS_CERT_FILE

अगर MANAGEMENT_UI_TLS_OFFLOAD=n है, तो टीएलएस कुंजी और सर्टिफ़िकेट फ़ाइलों का ऐब्सलूट पाथ तय करता है. फ़ाइलों को PEM फ़ाइलों के तौर पर फ़ॉर्मैट किया जाना चाहिए. इनमें कोई लंबा पासवर्ड नहीं होना चाहिए. साथ ही, इनका मालिकाना हक "apigee" उपयोगकर्ता के पास होना चाहिए.

इन फ़ाइलों के लिए सुझाई गई जगह: 

/opt/apigee/customer/application/edge-management-ui

अगर वह डायरेक्ट्री मौजूद नहीं है, तो उसे बनाएं.

अगर MANAGEMENT_UI_TLS_OFFLOAD=y, तो MANAGEMENT_UI_TLS_KEY_FILE और MANAGEMENT_UI_TLS_CERT_FILE. को छोड़ दें. इन्हें अनदेखा कर दिया जाता है, क्योंकि Edge के नए वर्शन के लिए अनुरोध, एचटीटीपी पर आते हैं.

 हां, अगर MANAGEMENT_UI_TLS_OFFLOAD=n
MANAGEMENT_UI_PUBLIC_URIS

अगर MANAGEMENT_UI_TLS_OFFLOAD=n है, तो यह New Edge के अनुभव का यूआरएल बताता है.

इस प्रॉपर्टी को कॉन्फ़िगरेशन फ़ाइल में मौजूद अन्य प्रॉपर्टी के आधार पर सेट करें. उदाहरण के लिए:

MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

कहां:

  • MANAGEMENT_UI_SCHEME, "http" या "https" प्रोटोकॉल के बारे में बताता है, जैसा कि ऊपर बताया गया है.
  • MANAGEMENT_UI_IP, New Edge के आईपी पते या डीएनएस नाम के बारे में बताता है.
  • MANAGEMENT_UI_PORT, New Edge के अनुभव के लिए इस्तेमाल किए जाने वाले पोर्ट के बारे में बताता है.

इन प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, Installing the New Edge Experience देखें.

अगर MANAGEMENT_UI_TLS_OFFLOAD=y:

  • MANAGEMENT_UI_IP, लोड बैलेंसर का आईपी पता या डीएनएस नाम बताता है, न कि New Edge experience का.
  • लोड बैलेंसर और नए यूज़र इंटरफ़ेस (यूआई) को अनुरोधों के लिए, एक ही पोर्ट नंबर का इस्तेमाल करना होगा. उदाहरण के लिए, 3001. लोड बैलेंसर और नए यूई पर पोर्ट नंबर तय करने के लिए, MANAGEMENT_UI_PORT का इस्तेमाल करें.

हां
SHOEHORN_SCHEME

Edge का नया वर्शन इंस्टॉल करने से पहले, आपको Edge का बुनियादी यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना होगा. इसे shoehorn कहा जाता है. इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल, नीचे दी गई प्रॉपर्टी का इस्तेमाल करके, बेस Edge यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले प्रोटोकॉल, "http" के बारे में बताती है:

SHOEHORN_SCHEME=http

Edge के बुनियादी यूज़र इंटरफ़ेस (यूआई) में टीएलएस काम नहीं करता. इसलिए, Edge के नए वर्शन पर टीएलएस चालू करने के बाद भी, इस प्रॉपर्टी को "http" पर सेट करना ज़रूरी है.

 हां और "http" पर सेट है

टीएलएस को कॉन्फ़िगर करना

New Edge अनुभव के लिए टीएलएस ऐक्सेस कॉन्फ़िगर करने के लिए:

  1. टीएलएस सर्टिफ़िकेट और पासकोड को PEM फ़ाइलों के तौर पर जनरेट करें. इनमें कोई लंबा पासवर्ड नहीं होना चाहिए. उदाहरण के लिए:

    mykey.pem
mycert.pem

    टीएलएस सर्टिफ़िकेट और कुंजी जनरेट करने के कई तरीके हैं. उदाहरण के लिए, बिना हस्ताक्षर वाला सर्टिफ़िकेट और कुंजी जनरेट करने के लिए, यह कमांड चलाया जा सकता है:

    openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
  2. कुंजी और सर्टिफ़िकेट फ़ाइलों को /opt/apigee/customer/application/edge-management-ui डायरेक्ट्री में कॉपी करें. अगर वह डायरेक्ट्री मौजूद नहीं है, तो उसे बनाएं.

  3. पक्का करें कि सर्टिफ़िकेट और पासकोड का मालिकाना हक "apigee" उपयोगकर्ता के पास हो:

    chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem

  4. इन टीएलएस प्रॉपर्टी को सेट करने के लिए, उस कॉन्फ़िगरेशन फ़ाइल में बदलाव करें जिसका इस्तेमाल आपने Edge के नए वर्शन को इंस्टॉल करने के लिए किया था:

    # Set to https to enable TLS.
MANAGEMENT_UI_SCHEME=https 
# Do NOT terminate TLS on a load balancer.
MANAGEMENT_UI_TLS_OFFLOAD=n

# Specify the key and cert. 
MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem

# Leave these properties set to the same values as when you installed the New Edge experience:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
SHOEHORN_SCHEME=http

  5. टीएलएस को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    जहां configFile, कॉन्फ़िगरेशन फ़ाइल का नाम है.

    स्क्रिप्ट, New Edge के अनुभव को रीस्टार्ट करती है.

  6. Shoehorn को सेट अप और रीस्टार्ट करने के लिए, ये कमांड दें:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

जब लोड बैलेंसर पर टीएलएस खत्म हो जाए, तब Edge के नए वर्शन को कॉन्फ़िगर करना

अगर आपके पास कोई ऐसा लोड बैलेंसर है जो अनुरोधों को New Edge पर फ़ॉरवर्ड करता है, तो आपके पास लोड बैलेंसर पर टीएलएस कनेक्शन को बंद करने का विकल्प होता है. इसके बाद, लोड बैलेंसर, एचटीटीपी के ज़रिए अनुरोधों को New Edge पर फ़ॉरवर्ड कर सकता है:

लोड बैलेंसर पर टीएलएस को खत्म करना

यह कॉन्फ़िगरेशन काम करता है, लेकिन आपको इसके हिसाब से लोड बैलेंसर और Edge के नए वर्शन को कॉन्फ़िगर करना होगा.

लोड बैलेंसर पर टीएलएस बंद होने पर, Edge के नए वर्शन को कॉन्फ़िगर करने के लिए:

  1. New Edge Experience को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें, ताकि ये TLS प्रॉपर्टी सेट की जा सकें:

    # Set to https to enable TLS
MANAGEMENT_UI_SCHEME=https
# Terminate TLS on a load balancer
MANAGEMENT_UI_TLS_OFFLOAD=y
# Set to the IP address or DNS name of the load balancer.
MANAGEMENT_UI_IP=LB_IP_DNS
# Set to the port number for the load balancer and New Edge experience.
# The load balancer and the New Edge experience must use the same port number.
MANAGEMENT_UI_IP=3001

# Leave these properties set to the same values as when you installed the New Edge experience:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT
SHOEHORN_SCHEME=http

    अगर आपने MANAGEMENT_UI_TLS_OFFLOAD=y को सेट किया है, तो MANAGEMENT_UI_TLS_KEY_FILE और MANAGEMENT_UI_TLS_CERT_FILE. को छोड़ दें. इन्हें अनदेखा कर दिया जाता है, क्योंकि Edge के नए वर्शन के लिए अनुरोध, एचटीटीपी पर आते हैं.

  2. टीएलएस को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    जहां configFile, कॉन्फ़िगरेशन फ़ाइल का नाम है.

    स्क्रिप्ट, New Edge के अनुभव को रीस्टार्ट करती है.

  3. Shoehorn को सेट अप और रीस्टार्ट करने के लिए, ये कमांड दें:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

Edge के नए वर्शन पर टीएलएस को बंद करना

Edge के नए वर्शन पर टीएलएस को बंद करने के लिए:

  1. Edge के नए वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें, ताकि इस टीएलएस प्रॉपर्टी को सेट किया जा सके:

    # Set to http to disable TLS.
MANAGEMENT_UI_SCHEME=http

# Only if you had terminated TLS on a load balancer,
# reset to the IP address or DNS name of the New Edge experience.
MANAGEMENT_UI_IP=newue_IP_DNS

  2. टीएलएस को बंद करने के लिए, यह कमांड चलाएं:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile

    जहां configFile, कॉन्फ़िगरेशन फ़ाइल का नाम है.

    स्क्रिप्ट, New Edge के अनुभव को रीस्टार्ट करती है.

  3. Shoehorn को सेट अप और रीस्टार्ट करने के लिए, ये कमांड दें:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    अब एचटीटीपी पर, Edge के नए वर्शन को ऐक्सेस किया जा सकता है. अगर टीएलएस को बंद करने के बाद, New Edge के अनुभव में लॉग इन नहीं किया जा सकता, तो ब्राउज़र की कैश मेमोरी मिटाएं और फिर से लॉग इन करने की कोशिश करें.