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

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

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

• रेफ़रंस - पसंदीदा
• डायरेक्ट के नाम
• फ़्लो वैरिएबल

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

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

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

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

यहां hostAlias वर्चुअल होस्ट या आईपी पते का होस्ट एलियास है. उदाहरण के लिए:

echo | openssl s_client -servername api.myCompany.com -connect api.myCompany.com: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

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

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

Edge के ऑन-प्रिमाइसेस डिप्लॉयमेंट के लिए:

1. एक नया कीस्टोर बनाएं और सर्टिफ़िकेट और पासकोड अपलोड करें. इसके बारे में कीस्टोर और ट्रस्टस्टोर में बताया गया है. नए कीस्टोर में, पक्का करें कि आपने कुंजी के उपनाम के लिए वही नाम इस्तेमाल किया हो जो मौजूदा कीस्टोर में इस्तेमाल किया गया था.
   
   ध्यान दें: मौजूदा कीस्टोर को मिटाया जा सकता है. इसके बाद, उसी नाम और उपनाम से नया कीस्टोर बनाया जा सकता है. राउटर को रीस्टार्ट करने की ज़रूरत नहीं है. हालांकि, जब तक नया कीस्टोर और एलियास सेट नहीं किया जाता, तब तक एपीआई अनुरोध पूरे नहीं किए जा सकते.
2. इनबाउंड कनेक्शन के लिए इस्तेमाल किए गए वर्चुअल होस्ट के लिए. इसका मतलब है कि Edge में एपीआई का अनुरोध:
   1. अगर आपका वर्चुअल होस्ट, कीस्टोर का रेफ़रंस इस्तेमाल करता है, तो रेफ़रंस को अपडेट करें. इसके बारे में रेफ़रंस के साथ काम करना लेख में बताया गया है.
   2. अगर आपका वर्चुअल होस्ट, कीस्टोर के नाम का सीधे तौर पर इस्तेमाल करता है, तो:
      1. ऐसे सभी वर्चुअल होस्ट अपडेट करें जिन्होंने पुराने कीस्टोर और कुंजी के उपनाम का रेफ़रंस दिया है, ताकि वे नए कीस्टोर और कुंजी के उपनाम का रेफ़रंस दें.
      2. राऊटर को एक-एक करके रीस्टार्ट करें. ध्यान दें कि अगर आपने पुराने कीस्टोर को मिटा दिया है और उसी नाम से नया कीस्टोर बनाया है, तो राउटर को रीस्टार्ट करने की ज़रूरत नहीं है.
         
         प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
3. आउटबाउंड कनेक्शन के लिए इस्तेमाल किए गए टारगेट एंडपॉइंट/टारगेट सर्वर के लिए. इसका मतलब है कि Apigee से बैकएंड सर्वर तक:
   1. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, कीस्टोर के रेफ़रंस का इस्तेमाल करता है, तो रेफ़रंस के साथ काम करना में बताए गए तरीके से रेफ़रंस अपडेट करें. प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
   2. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, फ़्लो वैरिएबल का इस्तेमाल करता है, तो फ़्लो वैरिएबल को अपडेट करें. किसी प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
   3. अगर टारगेट एंडपॉइंट/टारगेट सर्वर, कीस्टोर के नाम का सीधे तौर पर इस्तेमाल करता है, तो:
      1. उन सभी एपीआई प्रॉक्सी के लिए टारगेट एंडपॉइंट/टारगेट सर्वर कॉन्फ़िगरेशन अपडेट करें जिन्होंने नए कीस्टोर और कुंजी के उपनाम को रेफ़र करने के लिए, पुराने कीस्टोर और कुंजी के उपनाम को रेफ़र किया था.
      2. TargetEndpoint की परिभाषा से कीस्टोर का रेफ़रंस देने वाली किसी भी एपीआई प्रॉक्सी के लिए, आपको प्रॉक्सी को फिर से डिप्लॉय करना होगा.
         
         अगर TargetEndpoint, TargetServer की परिभाषा का रेफ़रंस देता है और TargetServer की परिभाषा, कीस्टोर का रेफ़रंस देती है, तो प्रॉक्सी को फिर से डिप्लॉय करने की ज़रूरत नहीं है.
      3. अगर कीस्टोर का इस्तेमाल Edge और बैकएंड सेवा के बीच दो-तरफ़ा टीएलएस के लिए किया जाता है और आपने कीस्टोर को उसी नाम से मिटा दिया/फिर से बना दिया है, तो आपको Edge Message Processor को फिर से शुरू करना होगा.
4. यह पुष्टि करने के बाद कि आपका नया कीस्टोर सही तरीके से काम कर रहा है, ऊपर बताए गए तरीके से, पुराने कीस्टोर को मिटाएं. इसमें वह सर्टिफ़िकेट और कुंजी शामिल है जिसकी समयसीमा खत्म हो चुकी है.

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

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

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

अगर अपने कीस्टोर और ट्रस्टस्टोर के सीधे नामों का इस्तेमाल किया जा रहा है, तो:

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