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

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

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

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

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

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

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

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

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

पहचान फ़ाइल बनाना

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

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

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

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 यूज़र इंटरफ़ेस (यूआई) में रेफ़रंस की वैल्यू बदलने के लिए:

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

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

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