रेफ़रंस का इस्तेमाल करना

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

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

    <SSLInfo> 
        <Enabled>true</Enabled> 
        <ClientAuthEnabled>false</ClientAuthEnabled> 
        <KeyStore>ref://myTestKeystoreRef</KeyStore> 
        <KeyAlias>myKeyAlias</KeyAlias> 
    </SSLInfo>

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

सिर्फ़ कीस्टोर और ट्रस्टस्टोर का रेफ़रंस इस्तेमाल किया जा सकता है. ऐलियास का रेफ़रंस इस्तेमाल नहीं किया जा सकता. किसी कीस्टोर का रेफ़रंस बदलते समय, पक्का करें कि सर्टिफ़िकेट का दूसरा नाम, पुराने कीस्टोर में मौजूद नाम के जैसा ही हो.

कीस्टोर और ट्रस्टस्टोर के रेफ़रंस इस्तेमाल करने पर लगी पाबंदियां

कीस्टोर और ट्रस्टस्टोर के रेफ़रंस का इस्तेमाल करते समय, आपको इस पाबंदी का ध्यान रखना होगा:

• वर्चुअल होस्ट में सिर्फ़ कीस्टोर और ट्रस्टस्टोर के रेफ़रंस का इस्तेमाल किया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब एसएनआई काम करता हो और Apigee राऊटर पर एसएसएल बंद कर दिया गया हो.
• अगर आपके पास Apigee राऊटर के सामने लोड बैलेंसर है और लोड बैलेंसर पर टीएलएस बंद कर दिया जाता है, तो वर्चुअल होस्ट में कीस्टोर और ट्रस्टस्टोर के रेफ़रंस का इस्तेमाल नहीं किया जा सकता.

रेफ़रंस बनाना

Edge यूज़र इंटरफ़ेस (यूआई) में रेफ़रंस बनाने के लिए:

1. https://enterprise.apigee.com पर जाकर, Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में लॉग इन करें.
2. Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) मेन्यू में, अपने संगठन का नाम चुनें.
3. Edge यूज़र इंटरफ़ेस (यूआई) के वर्शन के हिसाब से:
   1. अगर Classic Edge UI का इस्तेमाल किया जा रहा है, तो APIs > Environment Configuration चुनें.
   2. अगर New Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो एडमिन > एनवायरमेंट चुनें.
4. एनवायरमेंट चुनें (आम तौर पर, prod या test)
5. संदर्भ टैब चुनें.
6. + रेफ़रंस बटन चुनें. आपको यह पॉप-अप दिखेगा:
   
7. इनके बारे में बताएं:
   1. रेफ़रंस का नाम.
   2. रेफ़रंस से जुड़ी इकाई, जिसका मतलब है कि कीस्टोर या ट्रस्टस्टोर का नाम.
   3. सेव करें को चुनें.

इसके अलावा, keystoreref नाम का रेफ़रंस बनाने के लिए, Create Reference एपीआई कॉल का इस्तेमाल करें:

curl -X POST  -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references \
-d '<ResourceReference name="keystoreref">
    <Refers>myTestKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password

रेफ़रंस में कीस्टोर का नाम और उसका टाइप बताया जाता है. ट्रस्टस्टोर का रेफ़रंस बनाने के लिए, एक ही एपीआई कॉल का इस्तेमाल करें.

रेफ़रंस में बदलाव करना

Edge UI में किसी रेफ़रंस की वैल्यू में बदलाव करने के लिए:

1. https://enterprise.apigee.com पर जाकर, Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में लॉग इन करें.
2. Edge मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) मेन्यू में, अपने संगठन का नाम चुनें.
3. Edge यूज़र इंटरफ़ेस (यूआई) के वर्शन के हिसाब से:
   1. अगर Classic Edge UI का इस्तेमाल किया जा रहा है, तो APIs > Environment Configuration चुनें.
   2. अगर New Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो एडमिन > एनवायरमेंट चुनें.
4. एनवायरमेंट चुनें (आम तौर पर, prod या test)
5. संदर्भ टैब चुनें.
6. रेफ़रंस टैब में, रेफ़रंस के लिए बदलाव करें बटन को चुनें.
7. नए कीस्टोर या ट्रस्टस्टोर के बारे में बताने के लिए, रेफ़रंस अपडेट करें. चेतावनी: पक्का करें कि नए कीस्टोर में मौजूद एलियास का नाम, पुराने कीस्टोर में मौजूद एलियास के नाम से मेल खाता हो.
8. सेव करें को चुनें.

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

curl -X PUT -H "Content-Type:application/xml" https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/references/keystoreref \
-d '<ResourceReference name="keystoreref">
    <Refers>myNewKeystore</Refers>
    <ResourceType>KeyStore</ResourceType>
</ResourceReference>' -u orgAdminEmail:password