Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके कीस्टोर और ट्रस्टस्टोर बनाना

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

इस दस्तावेज़ में, Cloud के लिए Edge और Private Cloud के लिए Edge के वर्शन 4.18.01 और इसके बाद के वर्शन के लिए, कीस्टोर और ट्रस्टस्टोर बनाने, उनमें बदलाव करने, और उन्हें मिटाने का तरीका बताया गया है.

Edge Cloud के लिए कीस्टोर/ट्रस्टस्टोर और वर्चुअल होस्ट के बारे में जानकारी

Edge Cloud के लिए कीस्टोर/ट्रस्टस्टोर बनाने की प्रोसेस में, वर्चुअल होस्ट इस्तेमाल करने से जुड़े सभी नियमों का पालन करना ज़रूरी है. उदाहरण के लिए, क्लाउड में वर्चुअल होस्ट के साथ:

• वर्चुअल होस्ट को टीएलएस का इस्तेमाल करना चाहिए.
• वर्चुअल होस्ट सिर्फ़ पोर्ट 443 का इस्तेमाल कर सकते हैं.
• आपको साइन किए गए टीएलएस सर्ट का इस्तेमाल करना होगा. Cloud में वर्चुअल होस्ट के साथ, बिना हस्ताक्षर वाले सर्टिफ़िकेट इस्तेमाल करने की अनुमति नहीं है.
• TLS सर्टिफ़िकेट में दिया गया डोमेन नेम, वर्चुअल होस्ट के होस्ट एलियास से मेल खाना चाहिए.

ज़्यादा जानें:

• टीएलएस/एसएसएल के बारे में जानकारी
• Edge के साथ टीएलएस का इस्तेमाल करना
• वर्चुअल होस्ट कॉन्फ़िगर करने के बारे में अक्सर पूछे जाने वाले सवाल
• वर्चुअल होस्ट के बारे में जानकारी

Edge में कीस्टोर और ट्रस्टस्टोर लागू करना

पब्लिक की इंफ़्रास्ट्रक्चर पर निर्भर करने वाली सुविधाओं को कॉन्फ़िगर करने के लिए, जैसे कि टीएलएस, आपको ऐसे कीस्टोर और ट्रस्टस्टोर बनाने होंगे जिनमें ज़रूरी कुंजियां और डिजिटल सर्टिफ़िकेट शामिल हों.

Edge में, कीस्टोर और ट्रस्टस्टोर, दोनों को keystore इकाई के तौर पर दिखाया जाता है. इसमें एक या उससे ज़्यादा alias होते हैं. इसका मतलब है कि Edge पर कीस्टोर और ट्रस्टस्टोर को लागू करने में कोई अंतर नहीं है.

कीस्टोर और ट्रस्टस्टोर के बीच का अंतर, उनमें मौजूद एंट्री के टाइप और टीएलएस हैंडशेकिंग में उनके इस्तेमाल के तरीके से पता चलता है:

• कीस्टोर - यह एक कीस्टोर इकाई है. इसमें एक या उससे ज़्यादा उपनाम होते हैं. हर उपनाम में सर्टिफ़िकेट/कुंजी का एक जोड़ा होता है.
• truststore - यह एक keystore इकाई है. इसमें एक या उससे ज़्यादा उपनाम होते हैं. हर उपनाम में सिर्फ़ एक सर्ट होता है.

वर्चुअल होस्ट या टारगेट एंडपॉइंट के लिए टीएलएस कॉन्फ़िगर करते समय, कीस्टोर और ट्रस्टस्टोर, टीएलएस हैंडशेकिंग प्रोसेस में अलग-अलग भूमिकाएं निभाते हैं. वर्चुअल होस्ट या टारगेट एंडपॉइंट कॉन्फ़िगर करते समय, <SSLInfo> टैग में कीस्टोर और ट्रस्टस्टोर अलग-अलग तय किए जाते हैं. वर्चुअल होस्ट के लिए, यहां दिखाया गया है:

<VirtualHost name="myTLSVHost"> 
    <HostAliases> 
        <HostAlias>apiTLS.myCompany.com</HostAlias> 
    </HostAliases> 
    <Interfaces/> 
    <Port>9006</Port> 
    <SSLInfo> 
        <Enabled>true</Enabled> 
        <ClientAuthEnabled>false</ClientAuthEnabled> 
        <KeyStore>ref://keystoreref</KeyStore> 
        <KeyAlias>myKeyAlias</KeyAlias> 
    </SSLInfo>
</VirtualHost>

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

अगर ट्रस्टस्टोर की ज़रूरत है, जैसे कि दो-तरफ़ा टीएलएस कॉन्फ़िगरेशन के लिए, तो ट्रस्टस्टोर तय करने के लिए <TrustStore> टैग का इस्तेमाल करें:

<VirtualHost name="myTLSVHost"> 
    <HostAliases> 
        <HostAlias>apiTLS.myCompany.com</HostAlias> 
    </HostAliases> 
    <Interfaces/> 
    <Port>9006</Port> 
    <SSLInfo> 
        <Enabled>true</Enabled> 
        <ClientAuthEnabled>true</ClientAuthEnabled> 
        <KeyStore>ref://keystoreref</KeyStore> 
        <KeyAlias>myKeyAlias</KeyAlias> 
        <TrustStore>ref://truststoreref</TrustStore>
    </SSLInfo>
</VirtualHost>

इस उदाहरण में, <TrustStore> टैग सिर्फ़ कीस्टोर का रेफ़रंस देता है. इसमें किसी खास उपनाम के बारे में नहीं बताया गया है. कीस्टोर में मौजूद हर उपनाम में एक सर्ट या सर्ट चेन होती है. इसका इस्तेमाल टीएलएस हैंडशेकिंग प्रोसेस के दौरान किया जाता है.

सर्टिफ़िकेट के ऐसे फ़ॉर्मैट जिनका इस्तेमाल किया जा सकता है

* हमारा सुझाव है कि अगर हो सके, तो PEM का इस्तेमाल करें.

Edge for Private Cloud 4.53.00 या इसके बाद के वर्शन के साथ PKCS12 कीस्टोर का इस्तेमाल करना

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

उपनाम लागू करने के बारे में जानकारी

Edge में, कीस्टोर में एक या उससे ज़्यादा उपनाम होते हैं. हर उपनाम में ये चीज़ें शामिल होती हैं:

• PEM या PKCS12/PFX फ़ाइल के तौर पर TLS सर्टिफ़िकेट - यह सर्टिफ़िकेट देने वाली संस्था (CA) से साइन किया गया सर्टिफ़िकेट, सर्टिफ़िकेट की चेन वाली फ़ाइल (जिसमें आखिरी सर्टिफ़िकेट पर CA के हस्ताक्षर होते हैं) या खुद से साइन किया गया सर्टिफ़िकेट हो सकता है.
• निजी पासकोड, PEM या PKCS12/PFX फ़ाइल के तौर पर. Edge, 2048 बिट तक की कुंजी के साइज़ के साथ काम करता है. लंबे पासवर्ड का इस्तेमाल करना ज़रूरी नहीं है.

Edge में, ट्रस्टस्टोर में एक या उससे ज़्यादा उपनाम होते हैं. हर उपनाम में ये चीज़ें होती हैं:

• PEM फ़ाइल के तौर पर TLS सर्टिफ़िकेट. यह सर्टिफ़िकेट देने वाली संस्था (सीए) के हस्ताक्षर वाला सर्टिफ़िकेट, सर्टिफ़िकेट की ऐसी चेन जिसमें आखिरी सर्टिफ़िकेट पर सीए के हस्ताक्षर हों या खुद के हस्ताक्षर वाला सर्टिफ़िकेट हो सकता है.

Edge, एक यूज़र इंटरफ़ेस (यूआई) और एपीआई उपलब्ध कराता है. इनका इस्तेमाल करके, कीस्टोर बनाए जा सकते हैं, उपनाम बनाए जा सकते हैं, सर्टिफ़िकेट/पासकोड के जोड़े अपलोड किए जा सकते हैं, और सर्टिफ़िकेट अपडेट किए जा सकते हैं. ट्रस्टस्टोर बनाने के लिए इस्तेमाल किया जाने वाला यूज़र इंटरफ़ेस (यूआई) और एपीआई, कीस्टोर बनाने के लिए इस्तेमाल किए जाने वाले यूज़र इंटरफ़ेस (यूआई) और एपीआई के जैसा ही होता है. इन दोनों में अंतर यह है कि ट्रस्टस्टोर बनाते समय, ऐसे एलियास बनाए जाते हैं जिनमें सिर्फ़ सर्टिफ़िकेट होता है.

सर्टिफ़िकेट और कुंजी वाली फ़ाइलों के फ़ॉर्मैट के बारे में जानकारी

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

हालांकि, कई .crt फ़ाइलें और .key फ़ाइलें पहले से ही PEM फ़ॉर्मैट में होती हैं. अगर ये फ़ाइलें टेक्स्ट फ़ाइलें हैं और इन्हें इनमें शामिल किया गया है:

-----BEGIN CERTIFICATE-----
-----END CERTIFICATE-----

या:

-----BEGIN ENCRYPTED PRIVATE KEY-----
-----END ENCRYPTED PRIVATE KEY-----

इसके बाद, फ़ाइलें PEM फ़ॉर्मैट के साथ काम करती हैं. साथ ही, इन्हें PEM फ़ाइल में बदले बिना, कीस्टोर या ट्रस्टस्टोर में इस्तेमाल किया जा सकता है.

सर्टिफ़िकेट चेन के बारे में जानकारी

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

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

उदाहरण के लिए, सभी सर्टिफ़िकेट को एक ही PEM फ़ाइल में मिलाया जा सकता है. सर्टिफ़िकेट क्रम में होने चाहिए. साथ ही, आखिरी सर्टिफ़िकेट, रूट सर्टिफ़िकेट या रूट सर्टिफ़िकेट से साइन किया गया इंटरमीडिएट सर्टिफ़िकेट होना चाहिए:

-----BEGIN CERTIFICATE----- 
(Your Primary TLS certificate) 
-----END CERTIFICATE----- 

-----BEGIN CERTIFICATE----- 
(Intermediate certificate) 
-----END CERTIFICATE-----
 
-----BEGIN CERTIFICATE----- 
(Root certificate or intermediate certificate signed by a root certificate) 
-----END CERTIFICATE-----

अगर आपके सर्टिफ़िकेट, PKCS12/PFX फ़ाइलों के तौर पर दिखाए जाते हैं, तो सर्टिफ़िकेट की चेन से PKCS12/PFX फ़ाइल बनाने के लिए, openssl कमांड का इस्तेमाल किया जा सकता है. इसका तरीका यहां बताया गया है:

openssl pkcs12 -export -out certificate.pfx -inkey privateKey.key -in certificate.crt -certfile CACert.crt

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

दो-तरफ़ा टीएलएस पुष्टि के दौरान, क्लाइंट की पुष्टि तब होती है, जब सर्वर, टीएलएस हैंडशेकिंग प्रोसेस के तहत क्लाइंट को client_cert_1 भेजता है.

इसके अलावा, आपके पास दूसरा सर्टिफ़िकेट client_cert_2 है. इस पर भी उसी सर्टिफ़िकेट ca_cert के हस्ताक्षर हैं. हालांकि, आपको client_cert_2 को ट्रस्टस्टोर में अपलोड करने की ज़रूरत नहीं है. ट्रस्टस्टोर में अब भी सिर्फ़ client_cert_1 और ca_cert मौजूद हैं.

जब सर्वर, टीएलएस हैंडशेकिंग के हिस्से के तौर पर client_cert_2 पास करता है, तब अनुरोध पूरा हो जाता है. ऐसा इसलिए है, क्योंकि Edge, TLS की पुष्टि होने देता है. ऐसा तब होता है, जब client_cert_2 ट्रस्टस्टोर में मौजूद नहीं होता, लेकिन उस सर्टिफ़िकेट से साइन किया गया होता है जो ट्रस्टस्टोर में मौजूद है. अगर आपने ट्रस्टस्टोर से CA सर्टिफ़िकेट ca_cert को हटा दिया है, तो टीएलएस की पुष्टि नहीं हो पाएगी.

एफ़आईपीएस से जुड़ी ज़रूरी बातें

अगर आपने FIPS की सुविधा वाले ऑपरेटिंग सिस्टम पर Edge for Private Cloud 4.53.00 या इसके बाद का वर्शन इस्तेमाल किया है, तो आपको Apigee पर कुंजियां और उनसे जुड़े सर्टिफ़िकेट अपलोड करने के लिए, सिर्फ़ PKCS12 कीस्टोर का इस्तेमाल करना चाहिए.

TLS Keystores पेज एक्सप्लोर करना

TLS Keystores पेज दिखता है:

पिछली इमेज में हाइलाइट किए गए TLS Keystores पेज की मदद से, ये काम किए जा सकते हैं:

• कोई एनवायरमेंट चुनें
• कीस्टोर और उपनाम बनाना
• कीस्टोर की जांच करें और उन्हें मिटाएं
• उपनाम देखें और मिटाएं

कोई दूसरा ईमेल पता देखना

किसी उपनाम को देखने के लिए:

1. TLS Keystores पेज पर जाएं.
2. एनवायरमेंट चुनें. आम तौर पर, यह prod या test होता है.
3. उस पंक्ति पर क्लिक करें जो उस उपनाम से जुड़ी है जिसे आपको देखना है.

   इसके बाद, आपको एलियास सर्टिफ़िकेट और कुंजी की जानकारी दिखेगी.
   
   आपको उपनाम के बारे में पूरी जानकारी दिखेगी. इसमें उपनाम के इस्तेमाल की समयसीमा खत्म होने की तारीख भी शामिल है.

4. पेज पर सबसे ऊपर मौजूद बटन का इस्तेमाल करके, सर्टिफ़िकेट को मैनेज करें. इसके लिए:
   • सर्टिफ़िकेट को PEM फ़ाइल के तौर पर डाउनलोड करें.
   • सीएसआर जनरेट करें. अगर आपके पास समयसीमा खत्म हो चुका सर्टिफ़िकेट है और आपको उसे रिन्यू करना है, तो सर्टिफ़िकेट साइनिंग का अनुरोध (सीएसआर) डाउनलोड करें. इसके बाद, नया सर्टिफ़िकेट पाने के लिए, सीएसआर को सीए को भेजें.
   • किसी प्रमाणपत्र को अपडेट करना. चेतावनी: अगर आपको ऐसे सर्टिफ़िकेट को अपडेट करना है जिसका इस्तेमाल फ़िलहाल किसी वर्चुअल होस्ट या टारगेट सर्वर/टारगेट एंडपॉइंट के लिए किया जा रहा है, तो आपको राउटर और मैसेज प्रोसेसर को रीस्टार्ट करने के लिए, Apigee Edge की सहायता टीम से संपर्क करना होगा. सर्टिफ़िकेट अपडेट करने का सुझाया गया तरीका यह है:
     1. नया कीस्टोर या ट्रस्टस्टोर बनाएं.
     2. नए सर्टिफ़िकेट को नए कीस्टोर या ट्रस्टस्टोर में जोड़ें.
     3. वर्चुअल होस्ट या टारगेट सर्वर/टारगेट एंडपॉइंट में रेफ़रंस को कीस्टोर या ट्रस्टस्टोर में अपडेट करें. ज़्यादा जानकारी के लिए, Cloud के लिए टीएलएस सर्टिफ़िकेट अपडेट करना लेख पढ़ें.
     4. उपनाम मिटाएं. ध्यान दें: अगर आपने किसी उपनाम को मिटा दिया है और उसका इस्तेमाल वर्चुअल होस्ट या टारगेट एंडपॉइंट कर रहा है, तो वर्चुअल होस्ट या टारगेट एंडपॉइंट काम नहीं करेगा.

कीस्टोर/ट्रस्टस्टोर और एलियास बनाना

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

किसी एनवायरमेंट में कीस्टोर बनाने के लिए, आपको सिर्फ़ कीस्टोर का नाम बताना होगा. किसी एनवायरमेंट में नाम वाला कीस्टोर बनाने के बाद, ऐलियास बनाए जा सकते हैं. साथ ही, ऐलियास में सर्ट/की पेयर (कीस्टोर) अपलोड किया जा सकता है या सिर्फ़ सर्ट (ट्रस्टस्टोर) अपलोड किया जा सकता है.

कीस्टोर बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. एनवायरमेंट चुनें. आम तौर पर, यह prod या test होता है.
3. + कीस्टोर पर क्लिक करें.
4. कीस्टोर का नाम डालें. नाम में सिर्फ़ अक्षर और अंक हो सकते हैं.
5. Keystore जोड़ें पर क्लिक करें. नया कीस्टोर, सूची में दिखता है.
6. कोई उपनाम जोड़ने के लिए, इनमें से कोई एक तरीका अपनाएं. यह भी देखें सर्टिफ़िकेट की फ़ाइल के इस्तेमाल किए जा सकने वाले फ़ॉर्मैट.
   • सर्टिफ़िकेट से कोई दूसरा नाम बनाना (सिर्फ़ ट्रस्टस्टोर के लिए)
   • JAR फ़ाइल से कोई उपनाम बनाना (सिर्फ़ कीस्टोर)
   • सर्टिफ़िकेट और कुंजी से कोई दूसरा ईमेल पता बनाएं (सिर्फ़ कीस्टोर के लिए)
   • PKCS12/PFX फ़ाइल (सिर्फ़ कीस्टोर) से कोई उपनाम बनाएं
   • सेल्फ़-साइन किए गए सर्टिफ़िकेट (सिर्फ़ कीस्टोर) से कोई उपनाम बनाना

किसी सर्टिफ़िकेट से दूसरा ईमेल पता बनाना (सिर्फ़ ट्रस्टस्टोर के लिए)

किसी सर्टिफ़िकेट से कोई उपनाम बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. कार्रवाई मेन्यू दिखाने के लिए, कर्सर को कीस्टोर पर रखें और + पर क्लिक करें.
3. उपनाम डालें.
4. सर्टिफ़िकेट की जानकारी में जाकर, टाइप ड्रॉप-डाउन में सिर्फ़ सर्टिफ़िकेट को चुनें.
5. सर्टिफ़िकेट फ़ाइल के बगल में मौजूद, फ़ाइल चुनें पर क्लिक करें. इसके बाद, सर्टिफ़िकेट वाली PEM फ़ाइल पर जाएं और खोलें पर क्लिक करें.
6. एपीआई डिफ़ॉल्ट रूप से यह जांच करता है कि सर्टिफ़िकेट की समयसीमा खत्म तो नहीं हो गई है. पुष्टि की प्रोसेस को स्किप करने के लिए, समयसीमा खत्म हो चुके सर्टिफ़िकेट को अनुमति दें को चुनें. हालांकि, ऐसा करना ज़रूरी नहीं है.
7. सर्टिफ़िकेट अपलोड करने और उपनाम बनाने के लिए, सेव करें को चुनें.

JAR फ़ाइल से कोई दूसरा नाम बनाना (सिर्फ़ कीस्टोर के लिए)

JAR फ़ाइल से कोई उपनाम बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. कार्रवाई मेन्यू दिखाने के लिए, कर्सर को कीस्टोर पर रखें और + पर क्लिक करें.
3. उपनाम डालें.
4. सर्टिफ़िकेट की जानकारी में जाकर, टाइप ड्रॉप-डाउन में JAR फ़ाइल चुनें.
5. JAR फ़ाइल के बगल में मौजूद, फ़ाइल चुनें पर क्लिक करें. इसके बाद, सर्टिफ़िकेट और कुंजी वाली JAR फ़ाइल पर जाएं और खोलें पर क्लिक करें.
6. अगर कुंजी में पासवर्ड है, तो पासवर्ड डालें. अगर कुंजी में पासवर्ड नहीं है, तो इस फ़ील्ड को खाली छोड़ दें.
7. एपीआई डिफ़ॉल्ट रूप से यह जांच करता है कि सर्टिफ़िकेट की समयसीमा खत्म तो नहीं हो गई है. पुष्टि की प्रोसेस को स्किप करने के लिए, समयसीमा खत्म हो चुके सर्टिफ़िकेट को अनुमति दें को चुनें. हालांकि, ऐसा करना ज़रूरी नहीं है.
8. कुंजी और सर्टिफ़िकेट अपलोड करने और उपनाम बनाने के लिए, सेव करें को चुनें.

सर्टिफ़िकेट और कुंजी से कोई दूसरा नाम बनाना (सिर्फ़ कीस्टोर के लिए)

सर्टिफ़िकेट और कुंजी से कोई दूसरा नाम बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. कार्रवाई मेन्यू दिखाने के लिए, कर्सर को कीस्टोर पर रखें और + पर क्लिक करें.
3. उपनाम डालें.
4. प्रमाणपत्र की जानकारी में जाकर, टाइप ड्रॉप-डाउन में प्रमाणपत्र और कुंजी चुनें.
5. सर्टिफ़िकेट फ़ाइल के बगल में मौजूद, फ़ाइल चुनें पर क्लिक करें. इसके बाद, सर्टिफ़िकेट वाली PEM फ़ाइल पर जाएं और खोलें पर क्लिक करें.
6. अगर कुंजी में पासवर्ड है, तो कुंजी का पासवर्ड डालें. अगर कुंजी में पासवर्ड नहीं है, तो इस फ़ील्ड को खाली छोड़ दें.
7. कुंजी वाली फ़ाइल के बगल में मौजूद, फ़ाइल चुनें पर क्लिक करें. इसके बाद, कुंजी वाली PEM फ़ाइल पर जाएं और खोलें पर क्लिक करें.
8. एपीआई डिफ़ॉल्ट रूप से यह जांच करता है कि सर्टिफ़िकेट की समयसीमा खत्म तो नहीं हो गई है. पुष्टि की प्रोसेस को स्किप करने के लिए, समयसीमा खत्म हो चुके सर्टिफ़िकेट को अनुमति दें को चुनें. हालांकि, ऐसा करना ज़रूरी नहीं है.
9. कुंजी और सर्टिफ़िकेट अपलोड करने और उपनाम बनाने के लिए, सेव करें को चुनें.

PKCS12/PFX फ़ाइल (सिर्फ़ कीस्टोर) से कोई उपनाम बनाना

सर्टिफ़िकेट और पासकोड वाली PKCS12 फ़ाइल से कोई एलियास बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. कार्रवाई मेन्यू दिखाने के लिए, कर्सर को कीस्टोर पर रखें और + पर क्लिक करें.
3. उपनाम डालें.
4. सर्टिफ़िकेट की जानकारी में जाकर, टाइप ड्रॉप-डाउन में PKCS12/PFX चुनें.
5. PKCS12/PFX के बगल में मौजूद, फ़ाइल चुनें पर क्लिक करें. इसके बाद, उस फ़ाइल पर जाएं जिसमें कुंजी और सर्टिफ़िकेट मौजूद है. इसके बाद, खोलें पर क्लिक करें.
6. अगर कुंजी का कोई पासवर्ड है, तो PKCS12/PFX फ़ाइल के लिए पासवर्ड डालें. अगर कुंजी का कोई पासवर्ड नहीं है, तो इस फ़ील्ड को खाली छोड़ दें.
7. एपीआई डिफ़ॉल्ट रूप से यह जांच करता है कि सर्टिफ़िकेट की समयसीमा खत्म तो नहीं हो गई है. पुष्टि की प्रोसेस को स्किप करने के लिए, समयसीमा खत्म हो चुके सर्टिफ़िकेट को अनुमति दें को चुनें. हालांकि, ऐसा करना ज़रूरी नहीं है.
8. फ़ाइल अपलोड करने और उपनाम बनाने के लिए, सेव करें को चुनें.

खुद हस्ताक्षर किए गए सर्टिफ़िकेट (सिर्फ़ कीस्टोर) से कोई दूसरा नाम बनाना

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

सेल्फ़-साइन किए गए सर्टिफ़िकेट से कोई उपनाम बनाने के लिए:

1. TLS Keystores पेज पर जाएं.
2. कार्रवाई मेन्यू दिखाने के लिए, कर्सर को कीस्टोर पर रखें और + पर क्लिक करें.
3. उपनाम डालें.
4. सर्टिफ़िकेट की जानकारी में जाकर, टाइप ड्रॉप-डाउन में सेल्फ़-साइन्ड सर्टिफ़िकेट चुनें.
5. नीचे दी गई टेबल का इस्तेमाल करके, फ़ॉर्म भरें.
6. सर्टिफ़िकेट और निजी कुंजी का पेयर बनाने के लिए, सेव करें को चुनें. इसके बाद, इन्हें उपनाम में अपलोड करें.

जनरेट किए गए सर्टिफ़िकेट में, आपको ये अतिरिक्त फ़ील्ड दिखेंगे:

• जारी करने वाली संस्था
  वह इकाई जिसने सर्टिफ़िकेट पर हस्ताक्षर किए और उसे जारी किया. सेल्फ़-साइंड सर्टिफ़िकेट के लिए, यह वह सीएन है जिसे आपने सर्टिफ़िकेट बनाते समय तय किया था.
• मान्य होने की अवधि
  सर्टिफ़िकेट के मान्य होने की अवधि को दो तारीखों के तौर पर दिखाया जाता है: वह तारीख जब सर्टिफ़िकेट के मान्य होने की अवधि शुरू होती है और वह तारीख जब सर्टिफ़िकेट के मान्य होने की अवधि खत्म होती है. दोनों को UTCTime या GeneralizedTime वैल्यू के तौर पर कोड किया जा सकता है.

यहां दी गई टेबल में, फ़ॉर्म फ़ील्ड के बारे में बताया गया है:

कीस्टोर या ट्रस्टस्टोर की जांच करना

Edge यूज़र इंटरफ़ेस (यूआई) में, अपने ट्रस्टस्टोर और कीस्टोर की जांच की जा सकती है. इससे यह पुष्टि की जा सकती है कि उन्हें सही तरीके से कॉन्फ़िगर किया गया है. यह टेस्ट यूज़र इंटरफ़ेस, Edge से बैकएंड सेवा के लिए किए गए टीएलएस अनुरोध की पुष्टि करता है. बैकएंड सेवा को एकतरफ़ा या दोनों तरफ़ से TLS के साथ काम करने के लिए कॉन्फ़िगर किया जा सकता है.

एकतरफ़ा टीएलएस की जांच करने के लिए:

1. TLS Keystores पेज पर जाएं.
2. एनवायरमेंट चुनें. आम तौर पर, यह prod या test होता है.
3. कार्रवाइयों का मेन्यू दिखाने के लिए, अपने कर्सर को उस टीएलएस कीस्टोर पर रखें जिसका आपको टेस्ट करना है. इसके बाद, टेस्ट करें पर क्लिक करें. आपको यह डायलॉग बॉक्स दिखेगा. इसमें ट्रस्टस्टोर का नाम दिखेगा:
   
4. बैकएंड सेवा का होस्टनेम डालें.
5. TLS पोर्ट नंबर डालें. आम तौर पर, यह 443 होता है.
6. विकल्प के तौर पर, कोई भी प्रोटोकॉल या सिफ़र तय करें.
7. जांचें को चुनें.

दोनों तरफ़ से टीएलएस की जांच करने के लिए:

1. अपनी पसंद के ट्रस्टस्टोर के लिए, जांच करें बटन को चुनें.
2. डायलॉग बॉक्स में, SSL टेस्ट टाइप के लिए Two Way चुनें. आपको यह डायलॉग बॉक्स दिखेगा:
   
3. दोनों तरफ़ से TLS कनेक्शन के लिए इस्तेमाल किए गए कीस्टोर का नाम तय करें.
4. सर्टिफ़िकेट और कुंजी वाले कीस्टोर में, उपनाम का नाम डालें.
5. बैकएंड सेवा का होस्टनेम डालें.
6. TLS पोर्ट नंबर डालें. आम तौर पर, यह 443 होता है.
7. विकल्प के तौर पर, कोई भी प्रोटोकॉल या सिफ़र तय करें.
8. जांचें को चुनें.

दोनों तरफ़ से टीएलएस के लिए, ट्रस्टस्टोर में कोई सर्टिफ़िकेट जोड़ना

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

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

दोनों तरफ़ से टीएलएस के लिए इस्तेमाल किए जाने वाले ट्रस्टस्टोर में नए सर्टिफ़िकेट जोड़ने के लिए:

1. पक्का करें कि वर्चुअल होस्ट में ट्रस्टस्टोर का रेफ़रंस इस्तेमाल किया जा रहा हो.
2. ऊपर दिए गए किसी सर्टिफ़िकेट से एलियास बनाना (सिर्फ़ ट्रस्टस्टोर के लिए) में बताए गए तरीके से, ट्रस्टस्टोर में नया सर्टिफ़िकेट अपलोड करें.

3. ट्रस्टस्टोर के रेफ़रंस को अपडेट करके, उसे एक जैसी वैल्यू पर सेट करें. इस अपडेट की वजह से, Edge को ट्रस्टस्टोर और नए सर्टिफ़िकेट को फिर से लोड करना पड़ता है.

   ज़्यादा जानकारी के लिए, रेफ़रंस में बदलाव करना लेख पढ़ें.

कीस्टोर/ट्रस्टस्टोर या उपनाम मिटाना

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

आम तौर पर, कीस्टोर/ट्रस्टस्टोर या उपनाम को मिटाने के लिए, इस प्रोसेस का इस्तेमाल किया जाता है:

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

किसी कीस्टोर को मिटाना

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

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

कोई दूसरा ईमेल पता मिटाना

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

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