क्लाउड के लिए TLS सर्टिफ़िकेट अपडेट करना

यहां Apigee Edge के दस्तावेज़ देखे जा रहे हैं.
पर जाएं Apigee X दस्तावेज़. info

वर्चुअल होस्ट या टारगेट एंडपॉइंट/टारगेट सर्वर में, कीस्टोर और ट्रस्टस्टोर का नाम तय करने के लिए इस्तेमाल किया जाने वाला तरीका, यह तय करता है कि सर्टिफ़िकेट को कैसे अपडेट किया जाए. कीस्टोर और ट्रस्टस्टोर का नाम तय करने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:

• रेफ़रंस - सुझाया गया
• सीधे नाम
• फ़्लो वैरिएबल

इनमें से हर तरीके का, सर्टिफ़िकेट अपडेट करने की प्रोसेस पर अलग-अलग असर पड़ता है. इसकी जानकारी, यहां दी गई टेबल में दी गई है.

सर्टिफ़िकेट को अपडेट करने से पहले और बाद में उसकी जांच करना

सर्टिफ़िकेट को अपडेट करने से पहले, उसकी जांच करने के लिए, openssl के इन निर्देशों का इस्तेमाल करें:

echo | openssl s_client -servername HOSTNAME -connect ORG-ENV.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

यहां HOSTNAME होस्ट एलियास है और ORG-ENV संगठन और एनवायरमेंट है. उदाहरण के लिए:

echo | openssl s_client -servername example.com -connect myOrg-prod.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

आपको इस फ़ॉर्मैट में आउटपुट दिखेगा:

notBefore=Dec 30 22:11:38 2015 GMT
notAfter=Dec 30 22:11:38 2016 GMT
subject= /OU=Domain Control Validated/CN=*.apigee.net

सर्टिफ़िकेट को अपडेट करने के बाद, उसकी जांच करने के लिए, इसी निर्देश का इस्तेमाल करें.

यह तय करना कि आपका वर्चुअल होस्ट या टारगेट एंडपॉइंट/टारगेट सर्वर, कीस्टोर और ट्रस्टस्टोर को कैसे रेफ़रंस करता है

1. Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, https://enterprise.apigee.com पर लॉगिन करें.
2. Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के मेन्यू में, अपने संगठन का नाम चुनें.
3. वर्चुअल होस्ट के लिए, यह तय करें कि वर्चुअल होस्ट, कीस्टोर और ट्रस्टस्टोर को कैसे तय करता है.
   1. Edge यूज़र इंटरफ़ेस (यूआई) के आपके वर्शन के हिसाब से:
      1. अगर क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो एपीआई > एनवायरमेंट कॉन्फ़िगरेशन चुनें.
      2. अगर Edge के नए यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो एडमिन > एनवायरमेंट चुनें.
   2. वर्चुअल होस्ट टैब चुनें.
   3. जिस वर्चुअल होस्ट को अपडेट किया जा रहा है उसके लिए, उसकी प्रॉपर्टी दिखाने के लिए, दिखाएं बटन चुनें. डिस्प्ले में ये प्रॉपर्टी शामिल होती हैं:
      1. कीस्टोर: मौजूदा कीस्टोर का नाम. आम तौर पर, इसे रेफ़रंस के तौर पर तय किया जाता है. ref://mykeystoreref
         
         इसके अलावा, इसे सीधे नाम से भी तय किया जा सकता है. जैसे, myKeystoreName. साथ ही, इसे फ़्लो वैरिएबल से भी तय किया जा सकता है. जैसे, {ssl.keystore}.
      2. पासकोड एलियास. इस प्रॉपर्टी की वैल्यू, कीस्टोर में एलियास का नाम होती है. आपके नए कीस्टोर में, उसी नाम का एलियास होना चाहिए.
      3. ट्रस्टस्टोर: मौजूदा ट्रस्टस्टोर का नाम. अगर कोई ट्रस्टस्टोर है, तो आम तौर पर इसे रेफ़रंस के तौर पर तय किया जाता है ref://mytruststoreref.
         
         इसके अलावा, इसे सीधे नाम से भी तय किया जा सकता है. जैसे, myTruststoreName. साथ ही, इसे फ़्लो वैरिएबल से भी तय किया जा सकता है. जैसे, {ssl.truststorestore}.
4. टारगेट एंडपॉइंट/टारगेट सर्वर के लिए, यह तय करें कि टारगेट एंडपॉइंट कीस्टोर और ट्रस्टस्टोर को कैसे तय करता है:
   1. Edge के मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के मेन्यू में, एपीआई चुनें.
   2. एपीआई प्रॉक्सी का नाम चुनें.
   3. डेवलपमेंट टैब चुनें.
   4. **टारगेट एंडपॉइंट** में जाकर, **डिफ़ॉल्ट** चुनें.
   5. कोड वाले सेक्शन में, TargetEndpoint की परिभाषा दिखती है. यह देखने के लिए कि कीस्टोर/ट्रस्टस्टोर को कैसे तय किया गया है, <SSLInfo> एलिमेंट की जांच करें.
      
      ध्यान दें: अगर टारगेट एंडपॉइंट, टारगेट सर्वर का इस्तेमाल करता है, तो टारगेट एंडपॉइंट की एक्सएमएल परिभाषा इस तरह दिखती है. इसमें <LoadBalancer> टैग, एपीआई प्रॉक्सी के इस्तेमाल किए जाने वाले टारगेट सर्वर तय करता है.

      <TargetEndpoint name="default">
        …
        <HTTPTargetConnection>
          <LoadBalancer>
            <Server name="target1" />
            <Server name="target2" />
          </LoadBalancer>
          <Path>/test</Path>
        </HTTPTargetConnection>
          …
      </TargetEndpoint>

      यह तय करने के लिए कि कीस्टोर/ट्रस्टस्टोर को कैसे तय किया गया है, टारगेट सर्वर की परिभाषा में मौजूद <SSLInfo> एलिमेंट की जांच करें.

कीस्टोर में टीएलएस सर्टिफ़िकेट अपडेट करना

कीस्टोर में मौजूद किसी सर्टिफ़िकेट की समयसीमा खत्म होने पर, कीस्टोर में नया सर्टिफ़िकेट अपलोड नहीं किया जा सकता. इसके बजाय, एक नया कीस्टोर बनाएं और उसमें सर्टिफ़िकेट अपलोड करें. इसके बाद, अपने वर्चुअल होस्ट या टारगेट सर्वर/टारगेट एंडपॉइंट को अपडेट करें, ताकि वे नए कीस्टोर का इस्तेमाल कर सकें.

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

Edge के क्लाउड-आधारित डिप्लॉयमेंट के लिए:

1. नया कीस्टोर बनाएं और उसमें सर्टिफ़िकेट और पासकोड अपलोड करें. इसके लिए, Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके कीस्टोर और ट्रस्टस्टोर बनाना लेख में बताया गया तरीका अपनाएं.

   नए कीस्टोर में, पक्का करें कि पासकोड एलियास के लिए वही नाम इस्तेमाल किया गया हो जो मौजूदा कीस्टोर में इस्तेमाल किया गया था.

2. इनबाउंड कनेक्शन के लिए इस्तेमाल किए जाने वाले वर्चुअल होस्ट के लिए, जिसका मतलब है कि Edge में एपीआई अनुरोध:
   1. अगर आपका वर्चुअल होस्ट, कीस्टोर के रेफ़रंस का इस्तेमाल करता है, तो रेफ़रंस को अपडेट करें.
   2. अगर आपका वर्चुअल होस्ट, कीस्टोर के सीधे नाम का इस्तेमाल करता है, तो Apigee Edge की सहायता टीम से संपर्क करें.
3. आउटबाउंड कनेक्शन के लिए इस्तेमाल किए जाने वाले टारगेट एंडपॉइंट/टारगेट सर्वर के लिए, जिसका मतलब है Apigee से बैकएंड सर्वर तक:
   1. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, कीस्टोर के रेफ़रंस का इस्तेमाल करता है, तो रेफ़रंस को अपडेट करें. प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
   2. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, फ़्लो वैरिएबल का इस्तेमाल करता है, तो फ़्लो वैरिएबल को अपडेट करें. प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.

   3. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, कीस्टोर के सीधे नाम का इस्तेमाल करता है, तो उन सभी एपीआई प्रॉक्सी के लिए, टारगेट एंडपॉइंट/टारगेट सर्वर का कॉन्फ़िगरेशन अपडेट करें जिन्होंने पुराने कीस्टोर और पासकोड एलियास को रेफ़रंस किया था, ताकि वे नए कीस्टोर और पासकोड एलियास को रेफ़रंस कर सकें.

      इसके बाद, प्रॉक्सी को फिर से डिप्लॉय करना होगा.

4. यह पुष्टि करने के बाद कि आपका नया कीस्टोर सही तरीके से काम कर रहा है, समयसीमा खत्म हो चुके सर्टिफ़िकेट और पासकोड वाले पुराने कीस्टोर को मिटाएं.

ट्रस्टस्टोर में टीएलएस सर्टिफ़िकेट अपडेट करना

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

अगर कोई सर्टिफ़िकेट, चेन का हिस्सा है, तो आपको या तो सभी सर्टिफ़िकेट वाली एक फ़ाइल बनानी होगी और उस फ़ाइल को किसी एक एलियास पर अपलोड करना होगा या चेन में मौजूद सभी सर्टिफ़िकेट को ट्रस्टस्टोर में अलग-अलग अपलोड करना होगा. इसके लिए, हर सर्टिफ़िकेट के लिए अलग-अलग एलियास का इस्तेमाल करना होगा.

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

Edge के क्लाउड-आधारित डिप्लॉयमेंट के लिए:

1. नया ट्रस्टस्टोर बनाएं और उसमें सर्टिफ़िकेट अपलोड करें. इसके लिए, Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके कीस्टोर और ट्रस्टस्टोर बनाना लेख में बताया गया तरीका अपनाएं.

   नए ट्रस्टस्टोर में नया सर्टिफ़िकेट अपलोड करते समय, एलियास के नाम से कोई फ़र्क़ नहीं पड़ता.

2. इनबाउंड कनेक्शन के लिए इस्तेमाल किए जाने वाले वर्चुअल होस्ट के लिए, जिसका मतलब है कि Edge में एपीआई अनुरोध:
   1. अगर आपका वर्चुअल होस्ट, ट्रस्टस्टोर के रेफ़रंस का इस्तेमाल करता है, तो रेफ़रंस को अपडेट करें.
   2. अगर आपका वर्चुअल होस्ट, ट्रस्टस्टोर के सीधे नाम का इस्तेमाल करता है, तो Apigee Edge की सहायता टीम से संपर्क करें.
3. आउटबाउंड कनेक्शन के लिए इस्तेमाल किए जाने वाले टारगेट एंडपॉइंट/टारगेट सर्वर के लिए, जिसका मतलब है Apigee से बैकएंड सर्वर तक:
   1. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, ट्रस्टस्टोर के रेफ़रंस का इस्तेमाल करता है, तो रेफ़रंस को अपडेट करें. प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
   2. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, फ़्लो वैरिएबल का इस्तेमाल करता है, तो फ़्लो वैरिएबल को अपडेट करें. प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.

   3. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, ट्रस्टस्टोर के सीधे नाम का इस्तेमाल करता है, उन सभी एपीआई प्रॉक्सी के लिए, टारगेट एंडपॉइंट/टारगेट सर्वर का कॉन्फ़िगरेशन अपडेट करें जिन्होंने पुराने ट्रस्टस्टोर को रेफ़रंस किया था, ताकि वे नए कीस्टोर और पासकोड एलियास को रेफ़रंस कर सकें.

      इसके बाद, प्रॉक्सी को फिर से डिप्लॉय करना होगा.

4. यह पुष्टि करने के बाद कि आपका नया ट्रस्टस्टोर सही तरीके से काम कर रहा है, समयसीमा खत्म हो चुके सर्टिफ़िकेट वाले पुराने ट्रस्टस्टोर को मिटाएं.