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

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

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

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

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

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

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

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

अपनी वेबसाइट पर कीस्टोर और ट्रस्टस्टोर लागू करना किनारे

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

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

कीस्टोर और ट्रस्टस्टोर के बीच का अंतर उन प्रविष्टियों के प्रकार से लिया जाता है जिन्हें वे इनमें शामिल हैं और TLS हैंडहैकिंग में इनका इस्तेमाल कैसे किया जाता है:

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

किसी वर्चुअल होस्ट या टारगेट एंडपॉइंट के लिए TLS को कॉन्फ़िगर करते समय, कीस्टोर और ट्रस्टस्टोर अलग-अलग रोल के साथ मिलता है. वर्चुअल होस्ट या टारगेट को कॉन्फ़िगर करते समय एंडपॉइंट का इस्तेमाल करते हैं, तो <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>

इस उदाहरण में, आप इसके लिए वर्चुअल होस्ट की ओर से इस्तेमाल किए जाने वाले कीस्टोर और उपनाम का नाम तय करते हैं उसके TLS कीस्टोर हैं. कीस्टोर का नाम बताने के लिए, किसी पहचान फ़ाइल का इस्तेमाल किया जाता है, ताकि उसे बदला जा सके सर्टिफ़िकेट की समयसीमा खत्म होने के बाद. उपनाम में वर्चुअल होस्ट की पहचान करने के लिए इस्तेमाल किया जाने वाला प्रमाणपत्र/कुंजी का जोड़ा शामिल है को कनेक्ट करता है. इस उदाहरण में, कोई Truststore नहीं है आवश्यक.

अगर Truststore की ज़रूरत है, उदाहरण के लिए 2-तरफ़ा TLS कॉन्फ़िगरेशन के लिए, तो Truststore के बारे में बताने के लिए <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> टैग में सिर्फ़ कीस्टोर का रेफ़रंस दिया गया है, यह काम करता है विशिष्ट उपनाम दर्ज नहीं करें. कीस्टोर के हर उपनाम में एक सर्टिफ़िकेट या एक सर्टिफ़िकेट चेन होती है. इसका इस्तेमाल TLS हैंड्सहैकिंग प्रोसेस के हिस्से के तौर पर किया जाता है.

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

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

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

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

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

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

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

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

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

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

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

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

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

या:

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

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

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

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

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

उदाहरण के लिए, सभी सर्टिफ़िकेट को एक 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 फ़ाइलों के रूप में दिखाए जाते हैं, तो आप openssl का इस्तेमाल कर सकते हैं कमांड की मदद से, सर्टिफ़िकेट की चेन से एक PKCS12/PFX फ़ाइल बनाई जा सकती है, जैसा कि नीचे दिखाया गया है:

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

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

दो-तरफ़ा TLS प्रमाणीकरण के दौरान, सर्वर की ओर से भेजता है तो क्लाइंट प्रमाणीकरण सफल होता है client_cert_1.

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

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

TLS कीस्टोर पेज को एक्सप्लोर करें

नीचे बताए गए अनुसार TLS कीस्टोर पेज को एक्सेस करें.

TLS कीस्टोर पेज दिखता है:

जैसा कि पिछले डायग्राम में बताया गया है, TLS कीस्टोर पेज की मदद से, ये काम किए जा सकते हैं:

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

कोई उपनाम देखें

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

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

   उपनाम प्रमाणपत्र और कुंजी की जानकारी दिखाई जाती है.
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
   आपके पास उपनाम के बारे में पूरी जानकारी देखने का विकल्प होता है. इसमें, उपनाम की समयसीमा खत्म होने की तारीख भी शामिल है.

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

कीस्टोर/ट्रस्टस्टोर और उपनाम बनाएं

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

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

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

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

किसी प्रमाणपत्र से उपनाम बनाना (ट्रस्टस्टोर सिर्फ़)

किसी प्रमाणपत्र से उपनाम बनाने के लिए:

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

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

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

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

किसी प्रमाणपत्र से उपनाम बनाना और कुंजी (सिर्फ़ कीस्टोर)

किसी प्रमाणपत्र और कुंजी से उपनाम बनाने के लिए:

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

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

प्रमाणपत्र और कुंजी वाली किसी PKCS12 फ़ाइल से उपनाम बनाने के लिए:

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

किसी ईमेल पते से उपनाम बनाना खुद हस्ताक्षर किया हुआ सर्टिफ़िकेट (सिर्फ़ कीस्टोर के लिए)

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

स्व-हस्ताक्षरित प्रमाणपत्र से एक उपनाम बनाने के लिए:

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

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

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

नीचे दिए गए टेबल में फ़ॉर्म फ़ील्ड के बारे में बताया गया है:

फ़ॉर्म फ़ील्ड	ब्यौरा	डिफ़ॉल्ट	ज़रूरी है
उपनाम	उपनाम. ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	हां
कुंजी का साइज़	कुंजी का साइज़, बिट में. डिफ़ॉल्ट और ज़्यादा से ज़्यादा वैल्यू 2048 बिट है.	2048	नहीं
सिग्नेचर एल्गोरिदम	निजी पासकोड जनरेट करने के लिए सिग्नेचर एल्गोरिदम. मान्य वैल्यू "SHA512withRSA" हैं, "SHA384आरएसए के साथ" और "SHA256withRSA" (डिफ़ॉल्ट).	SHA256RSA के साथ	नहीं
सर्टिफ़िकेट कितने दिनों तक मान्य रहेगा	सर्टिफ़िकेट के मान्य रहने की अवधि, दिनों में. धनात्मक गैर शून्य मान स्वीकार करता है.	365	नहीं
सामान्य नाम	संगठन के सामान्य नाम (सीएन) से पूरी तरह क्वालिफ़ाइड डोमेन नेम की पहचान की जाती है सर्टिफ़िकेट से जुड़े होते हैं. आम तौर पर, इसे होस्ट और डोमेन नेम बनाया जाता है. उदाहरण के लिए, api.enterprise.apigee.com, www.apigee.com वगैरह. ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं. सर्टिफ़िकेट टाइप के आधार पर, CN एक ही डोमेन से जुड़े एक या उससे ज़्यादा होस्टनेम हो सकता है (उदाहरण के लिए, example.com, www.example.com), वाइल्डकार्ड का नाम (उदाहरण के लिए, *.example.com) या डोमेन की सूची. ऐसा न करें कोई भी प्रोटोकॉल (http:// या https://), पोर्ट नंबर या रिसॉर्स पाथ शामिल करें. यह सर्टिफ़िकेट सिर्फ़ तब मान्य होता है, जब अनुरोध का होस्टनेम इनमें से कम से कम किसी एक से मेल खाता हो सर्टिफ़िकेट के सामान्य नाम.	लागू नहीं	हां
ईमेल	ईमेल पता. ज़्यादा से ज़्यादा 255 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	नहीं
संगठन इकाई का नाम	संगठन की टीम का नाम. ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	नहीं
संगठन का नाम	संगठन का नाम. ज़्यादा से ज़्यादा 64 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	नहीं
शहर	शहर/कस्बे का नाम. ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	नहीं
राज्य/प्रांत	राज्य/प्रांत का नाम. ज़्यादा से ज़्यादा 128 वर्ण इस्तेमाल किए जा सकते हैं.	लागू नहीं	नहीं
देश	दो अक्षरों वाला देश कोड. उदाहरण के लिए, भारत के लिए IN, अमेरिका के लिए अमेरिका.	लागू नहीं	नहीं
वैकल्पिक नाम	वैकल्पिक होस्ट नामों की सूची. अतिरिक्त पहचान को सब्जेक्ट से कनेक्ट करने की अनुमति देता है चुनें. तय किए गए विकल्पों में इंटरनेट इलेक्ट्रॉनिक मेल पता, एक डीएनएस शामिल है नाम, एक आईपी पता, और एक यूनिफ़ॉर्म रिसॉर्स आइडेंटिफ़ायर (यूआरआई). हर वैल्यू के लिए ज़्यादा से ज़्यादा 255 वर्ण. नामों को कॉमा से या दबाकर हर नाम के बाद Enter बटन दबाएं.	लागू नहीं	नहीं

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

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

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

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

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

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

टू-वे TLS के लिए ट्रस्टस्टोर में सर्टिफ़िकेट जोड़ें

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

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

दो-तरफ़ा TLS के लिए इस्तेमाल किए जाने वाले Truststore में नए प्रमाणपत्र जोड़ने के लिए:

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

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

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

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

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

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

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

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

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

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

उपनाम मिटाना

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

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