Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

वर्चुअल होस्ट कॉन्फ़िगर करना

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

पैसे देकर खाता इस्तेमाल करने वाले Cloud के ग्राहक और Private Cloud के सभी Edge ग्राहक, किसी संगठन में वर्चुअल होस्ट बना सकते हैं. वर्चुअल होस्ट बनाने वाले उपयोगकर्ता के पास संगठन के एडमिन की भूमिका होनी चाहिए. इसके अलावा, उसके पास कस्टम भूमिका में वर्चुअल होस्ट में बदलाव करने की अनुमति होनी चाहिए. अन्य भूमिकाओं वाले उपयोगकर्ताओं के पास वर्चुअल होस्ट बनाने की अनुमति नहीं होती.

ध्यान दें: Cloud के लिए Edge के वर्चुअल होस्ट बनाने के लिए, आपको टीएलएस की सुविधा चालू करनी होगी. इसके अलावा, आपके पास Symantec या VeriSign जैसी किसी भरोसेमंद इकाई से साइन किया गया सर्टिफ़िकेट होना चाहिए. अगर आपके पास Cloud के लिए Edge का ऐसा खाता है जिसके लिए पेमेंट किया जाता है और आपके पास अब तक टीएलएस सर्टिफ़िकेट और पासकोड नहीं है, तो Apigee के मुफ़्त में आज़माने वाले वर्शन के सर्टिफ़िकेट और पासकोड का इस्तेमाल करके, वर्चुअल होस्ट बनाया जा सकता है. खुद साइन किए गए सर्टिफ़िकेट या खुद साइन करने वाली सीए से साइन किए गए लीफ़ सर्टिफ़िकेट का इस्तेमाल नहीं किया जा सकता. टीएलएस के बारे में जानकारी पाने के लिए, टीएलएस/एसएसएल देखें.

ध्यान दें: Cloud के लिए Edge के ऐसे ग्राहक जिनके पास मुफ़्त और आज़माने वाले वर्शन के खाते हैं वे वर्चुअल होस्ट नहीं बना सकते या उनमें बदलाव नहीं कर सकते. साथ ही, वे सिर्फ़ उन वर्चुअल होस्ट का इस्तेमाल कर सकते हैं जो Edge के लिए रजिस्टर करते समय उनके लिए बनाए गए थे. Edge के कीमत वाले प्लान के बारे में ज़्यादा जानने के लिए, https://apigee.com/api-management/#/pricing पर जाएं.

वर्चुअल होस्ट के बारे में जानने के लिए, यह वीडियो देखें.

वर्चुअल होस्ट बनाना

वर्चुअल होस्ट बनाने के लिए, यह बुनियादी तरीका अपनाएं. आपके लिए सही तरीका इस बात पर निर्भर करता है कि आप Cloud या Private Cloud के ग्राहक हैं, साथ ही, इस बात पर भी निर्भर करता है कि आपने टीएलएस की सुविधा चालू की है या नहीं:

सार्वजनिक तौर पर दिखने वाले अपने डोमेन के लिए, डीएनएस एंट्री और सीएनएएमई रिकॉर्ड बनाएं.
ध्यान दें: Private Cloud के ग्राहक, डीएनएस एंट्री और सीएनएएमई रिकॉर्ड के बिना, आईपी पते से वर्चुअल होस्ट बना सकते हैं. ज़्यादा जानकारी के लिए, Private Cloud के लिए वर्चुअल होस्ट कॉन्फ़िगर करना देखें.
वर्चुअल होस्ट पर टीएलएस की सुविधा चालू करने के लिए:

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

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

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

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

https://api.myCompany.com/v1/project-base-path/resource-path

उदाहरण के लिए:

https://api.myCompany.com/v1/weather/forecastrss?w=12797282

एपीआई या यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके वर्चुअल होस्ट बनाना

Edge API या Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, वर्चुअल होस्ट बनाया जा सकता है.

यहां दिए गए ज़्यादातर उदाहरणों में, Edge API का इस्तेमाल किया गया है. Edge के यूज़र इंटरफ़ेस (यूआई) में वर्चुअल होस्ट बनाने, उनमें बदलाव करने, और उन्हें मिटाने के लिए, यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने का तरीका:

apigee.com/edge में साइन इन करें
Private Cloud के Edge ग्राहक, http://ms-ip:9000 (कंपनी की इमारत में) का इस्तेमाल करते हैं. यहां ms-ip मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
बाईं ओर मौजूद नेविगेशन बार में, एडमिन > वर्चुअल होस्ट को चुनें.
कोई एनवायरमेंट चुनें. जैसे, prod या test.
एनवायरमेंट के लिए तय किए गए वर्चुअल होस्ट दिखते हैं.
वर्चुअल होस्ट बनाने के लिए, + वर्चुअल होस्ट को चुनें. इसके अलावा, किसी मौजूदा वर्चुअल होस्ट में बदलाव करने के लिए, उसका नाम चुनें.

एचटीटीपी के लिए वर्चुअल होस्ट बनाना

Private Cloud के Edge ग्राहक, एचटीटीपी का इस्तेमाल करके वर्चुअल होस्ट बना सकते हैं.

ऐसा वर्चुअल होस्ट बनाने के लिए जिसमें टीएलएस की सुविधा काम नहीं करती, एक एक्सएमएल ऑब्जेक्ट बनाएं. इसमें वर्चुअल होस्ट की जानकारी तय करें. उदाहरण के लिए, इस एक्सएमएल ऑब्जेक्ट में ऐसे वर्चुअल होस्ट की जानकारी तय की गई है जो एचटीटीपी प्रोटोकॉल का इस्तेमाल करता है:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>api.myCompany.com</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>80</Port>
</VirtualHost>

इस जानकारी में, ये काम किए जाते हैं:

name को myVHost के तौर पर तय किया जाता है. एपीआई प्रॉक्सी या एपीआई कॉल में वर्चुअल होस्ट को रेफ़र करने के लिए, इस नाम का इस्तेमाल किया जाता है.
होस्ट उपनाम को api.myCompany.com के तौर पर तय किया जाता है. यह सार्वजनिक तौर पर दिखने वाला डोमेन है. इसका इस्तेमाल, डीएनएस की जानकारी और CNAME रिकॉर्ड के हिसाब से तय किए गए आपके एपीआई को ऐक्सेस करने के लिए किया जाता है.
port नंबर को 80 के तौर पर तय किया जाता है. अगर पोर्ट नंबर नहीं दिया जाता है, तो डिफ़ॉल्ट रूप से पोर्ट 443 पर सेट होता है.
वर्चुअल होस्ट में अन्य प्रॉपर्टी भी सेट की जा सकती हैं. सभी प्रॉपर्टी के रेफ़रंस के लिए, वर्चुअल होस्ट प्रॉपर्टी रेफ़रंस देखें.

अगर आपके पास पहले से कोई एपीआई प्रॉक्सी है, तो <HTTPConnection> एलिमेंट Proxy Endpoint में वर्चुअल होस्ट जोड़ें. सभी नई एपीआई प्रॉक्सी में वर्चुअल होस्ट अपने-आप जुड़ जाता है. वर्चुअल होस्ट का इस्तेमाल करने के लिए, एपीआई प्रॉक्सी को कॉन्फ़िगर करना देखें. अगर आपको कोई ऐसी नई एपीआई प्रॉक्सी बनानी है जिसे किसी खास वर्चुअल होस्ट के ज़रिए ऐक्सेस नहीं किया जाना चाहिए, तो आपको उस एपीआई प्रॉक्सी में बदलाव करके, उसके ProxyEndpoint से उस वर्चुअल होस्ट को हटाना होगा.

इसके बाद, इस वर्चुअल होस्ट के ज़रिए किसी एपीआई प्रॉक्सी को ऐक्सेस किया जा सकता है. इसके लिए, इस यूआरएल पर अनुरोध करें:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

वर्चुअल होस्ट बनाने के लिए, वर्चुअल होस्ट बनाएं एपीआई का इस्तेमाल करें:

curl -X POST -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="myVHost">
        <HostAliases>
            <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>80</Port>
    </VirtualHost>' \
  -u sysAdminEmail:password

ध्यान दें: Private Cloud के Edge में, एपीआई कॉल, डोमेन नेम ms-ip:8080 पर किए जाते हैं. यहां ms-ip, Edge Management Server का आईपी है. Cloud के Edge ग्राहक, डोमेन api.enterprise.apigee.com

पर अनुरोध करते हैं

एक-तरफ़ा टीएलएस के लिए वर्चुअल होस्ट बनाना

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

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>
</VirtualHost>

इस जानकारी में, <Enable> एलिमेंट को 'सही' पर सेट करके टीएलएस की सुविधा चालू की जाती है. साथ ही, <KeyStore> और <KeyAliase> एलिमेंट का इस्तेमाल करके, टीएलएस कनेक्शन के लिए इस्तेमाल किए जाने वाले कीस्टोर और पासकोड एलियास की जानकारी तय की जाती है.

ध्यान दें: Edge में पहले एसएसएल की सुविधा काम करती थी. इसलिए, टीएलएस को कॉन्फ़िगर करने के लिए इस्तेमाल किए जाने वाले टैग का नाम <SSLInfo> है.

टीएलएस का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, टीएलएस/एसएसएल देखें.

वर्चुअल होस्ट में कीस्टोर और ट्रस्टस्टोर का नाम तय करने का तरीका चुनना

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

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

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

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

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

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

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

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

दो-तरफ़ा टीएलएस के लिए वर्चुअल होस्ट बनाना

दो-तरफ़ा टीएलएस की सुविधा चालू करने के लिए, <ClientAuthEnabled> एलिमेंट को true पर सेट करें. साथ ही, <TrustStore> एलिमेंट के साथ रेफ़रंस का इस्तेमाल करके, ट्रस्टस्टोर की जानकारी तय करें. ट्रस्टस्टोर में, क्लाइंट के सर्टिफ़िकेट जारी करने वाली इकाई और सर्टिफ़िकेट की सीए चेन की जानकारी होती है. यह जानकारी ज़रूरी है. दो-तरफ़ा टीएलएस के लिए, क्लाइंट को भी सही तरीके से कॉन्फ़िगर किया जाना चाहिए.

दो-तरफ़ा टीएलएस के लिए वर्चुअल होस्ट बनाने के लिए, एक एक्सएमएल ऑब्जेक्ट बनाएं. इसमें वर्चुअल होस्ट की जानकारी तय करें:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>true</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
        <TrustStore>ref://myTestTruststoreRef</TrustStore>
    </SSLInfo>
</VirtualHost>

इस जानकारी में, ये काम किए जाते हैं:

<ClientAuthEnabled> को 'सही' पर सेट करके, दो-तरफ़ा टीएलएस की सुविधा चालू की जाती है.
<TrustStore> एलिमेंट का इस्तेमाल करके, ट्रस्टस्टोर के रेफ़रंस की जानकारी तय की जाती है. ट्रस्टस्टोर में, क्लाइंट के सर्टिफ़िकेट जारी करने वाली इकाई और सर्टिफ़िकेट की सीए चेन की जानकारी होती है. यह जानकारी ज़रूरी है.

वर्चुअल होस्ट में बदलाव करना

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

चेतावनी: मौजूदा वर्चुअल होस्ट में बदलाव करने पर, Edge के वर्शन के हिसाब से पाबंदियां लागू होती हैं. वर्चुअल होस्ट में बदलाव करने से पहले:

Cloud के ग्राहकों को वर्चुअल होस्ट में बदलाव करते समय, लागू होने वाली पाबंदियों के बारे में पता होना चाहिए. ज़्यादा जानकारी के लिए, Cloud के लिए वर्चुअल होस्ट कॉन्फ़िगर करना देखें.
Private Cloud के ग्राहकों को वर्चुअल होस्ट में बदलाव करते समय, लागू होने वाली पाबंदियों के बारे में पता होना चाहिए. ज़्यादा जानकारी के लिए, Private Cloud के लिए वर्चुअल होस्ट कॉन्फ़िगर करना देखें.

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

इस उदाहरण में, proxy_read_timeout प्रॉपर्टी की वैल्यू सेट की गई है:

curl -X PUT -H "Content-Type:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
    -d '<VirtualHost  name="myTLSVHost">
         <HostAliases>
           <HostAlias>api.myCompany.com</HostAlias>
         </HostAliases>
         <Port>443</Port>
         <SSLInfo>
           <Enabled>true</Enabled>
           <ClientAuthEnabled>false</ClientAuthEnabled>
           <KeyStore>ref://myTestKeystoreRef</KeyStore>
           <KeyAlias>myKeyAlias</KeyAlias>
         </SSLInfo>
         <Properties>
           <Property name="proxy_read_timeout">50</Property>
         </Properties>
     </VirtualHost>' \
    -u orgAdminEmail:password

वर्चुअल होस्ट मिटाना

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

वर्चुअल होस्ट मिटाने के लिए, वर्चुअल होस्ट मिटाएं एपीआई का इस्तेमाल करें:

curl -X DELETE \
  https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
  -u orgAdminEmail:password

वर्चुअल होस्ट के बारे में जानकारी देखना

किसी एनवायरमेंट में तय किए गए वर्चुअल होस्ट के बारे में जानकारी देखने के लिए, यहां बताया गया तरीका अपनाएं.

Edge

Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, वर्चुअल होस्ट के बारे में जानकारी देखने के लिए:

apigee.com/edge में साइन इन करें.
Private Cloud के Edge ग्राहक, http://ms-ip:9000 (कंपनी की इमारत में) का इस्तेमाल करते हैं. यहां ms-ip मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
बाईं ओर मौजूद नेविगेशन बार में, एडमिन > वर्चुअल होस्ट को चुनें.
कोई एनवायरमेंट चुनें. जैसे, prod या test.
एनवायरमेंट के लिए तय किए गए वर्चुअल होस्ट दिखते हैं. अगर वर्चुअल होस्ट को कीस्टोर या ट्रस्टस्टोर का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, ज़्यादा जानकारी देखने के लिए, दिखाएं पर क्लिक करें.

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

बाईं ओर मौजूद नेविगेशन बार में, एडमिन > एनवायरमेंट > टीएलएस कीस्टोर को चुनें.
एनवायरमेंट चुनें. आम तौर पर, यह prod या test होता है.
सर्टिफ़िकेट देखने के लिए, कीस्टोर को बड़ा करें.

Classic Edge (Private Cloud)

Classic Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, वर्चुअल होस्ट के बारे में जानकारी देखने के लिए:

http://ms-ip:9000 में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
बाईं ओर मौजूद नेविगेशन बार में, एडमिन > वर्चुअल होस्ट को चुनें.
कोई एनवायरमेंट चुनें. जैसे, prod या test.
वर्चुअल होस्ट टैब पर क्लिक करें.
एनवायरमेंट के लिए तय किए गए वर्चुअल होस्ट दिखते हैं. अगर वर्चुअल होस्ट को कीस्टोर या ट्रस्टस्टोर का इस्तेमाल करने के लिए कॉन्फ़िगर किया गया है, ज़्यादा जानकारी देखने के लिए, दिखाएं पर क्लिक करें.

सबसे ऊपर मौजूद नेविगेशन बार में, एडमिन > टीएलएस सर्टिफ़िकेट को चुनें.
एनवायरमेंट चुनें. आम तौर पर, यह prod या test होता है.
सर्टिफ़िकेट देखने के लिए, कीस्टोर को बड़ा करें.

Edge API का इस्तेमाल करके वर्चुअल होस्ट देखना

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

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts \
    -u orgAdminEmail:pWord

यहां orgAdminEmail:pWord, संगठन के एडमिन का उपयोगकर्ता नाम और पासवर्ड है. साथ ही, org_name/env_name में, वर्चुअल होस्ट वाले संगठन और एनवायरमेंट की जानकारी तय की जाती है. रिस्पॉन्स का उदाहरण:

[
 "default",
 "secure"
]

किसी खास वर्चुअल होस्ट के बारे में जानकारी देखने के लिए, वर्चुअल होस्ट की जानकारी पाएं एपीआई का इस्तेमाल करें:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
    -u orgAdminEmail:pWord

यहां vhost_name वर्चुअल होस्ट का नाम है. उदाहरण के लिए, Apigee की ओर से बनाए गए डिफ़ॉल्ट सुरक्षित वर्चुअल होस्ट का कॉन्फ़िगरेशन देखने के लिए, vhost_name को "secure" के तौर पर तय किया जा सकता है:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <Properties/>
    <Interfaces/>
    <RetryOptions/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

ध्यान दें: Private Cloud के Edge में, api.enterprise.apigee.com डोमेन नेम को ms-ip:8080 से बदलें. यहां ms-ip, Edge Management Server का आईपी है.

वर्चुअल होस्ट का इस्तेमाल करने के लिए, एपीआई प्रॉक्सी को कॉन्फ़िगर करना

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

https://host-alias/proxy-base-path/resource-path

यहां:

host-alias आम तौर पर, वर्चुअल होस्ट का डीएनएस नाम होता है.
proxy-base-path एपीआई प्रॉक्सी बनाते समय तय किया जाता है. यह हर एपीआई प्रॉक्सी के लिए यूनीक होता है.
resource-path एपीआई प्रॉक्सी के ज़रिए ऐक्सेस किए जा सकने वाले किसी संसाधन का पाथ होता है.

किसी एपीआई प्रॉक्सी के लिए इस्तेमाल किए जाने वाले वर्चुअल होस्ट को कंट्रोल करना

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

<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>default</VirtualHost>
</HTTPProxyConnection>

उदाहरण के लिए, <VirtualHost>secure</VirtualHost> का मतलब है कि क्लाइंट, "secure" वर्चुअल होस्ट के होस्ट एलियास का इस्तेमाल करके, एपीआई प्रॉक्सी को कॉल कर सकता है.

आम तौर पर, एपीआई प्रॉक्सी से जुड़े वर्चुअल होस्ट में बदलाव तब किया जाता है, जब:

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

किसी एपीआई प्रॉक्सी से जुड़े वर्चुअल होस्ट में बदलाव करने के लिए:

एपीआई प्रॉक्सी एडिटर को ऐक्सेस करें. इसके लिए, यहां बताया गया तरीका अपनाएं.
Edge

Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी एडिटर को ऐक्सेस करने के लिए:
1. apigee.com/edge में साइन इन करें.
  Private Cloud के Edge ग्राहक, http://ms-ip:9000 (कंपनी की इमारत में) का इस्तेमाल करते हैं. यहां ms-ip मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
2. बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी को चुनें.
3. सूची में, वह एपीआई प्रॉक्सी चुनें जिसमें आपको बदलाव करना है.
Classic Edge (Private Cloud)

ध्यान दें: Classic Edge का यूज़र इंटरफ़ेस (यूआई) सिर्फ़ Private Cloud के Edge के साथ उपलब्ध है.

Classic Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, एपीआई प्रॉक्सी एडिटर को ऐक्सेस करने के लिए:
1. http://ms-ip:9000 में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
2. सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > एपीआई प्रॉक्सी को चुनें.
3. सूची में, वह एपीआई प्रॉक्सी चुनें जिसमें आपको बदलाव करना है.
डेवलप करें टैब पर क्लिक करें.
प्रॉक्सी एंडपॉइंट में, डिफ़ॉल्ट को चुनें.
कोड वाले सेक्शन में:
1. उन वर्चुअल होस्ट के लिए <VirtualHost> एलिमेंट हटाएं जो एपीआई प्रॉक्सी के साथ काम नहीं करते.
2. नए वर्चुअल होस्ट के नाम के साथ, नया <VirtualHost> एलिमेंट जोड़ें. उदाहरण के लिए, अगर नए वर्चुअल होस्ट का नाम MyVirtualHost है, तो यह टैग जोड़ें:
```
<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>MyVirtualHost</VirtualHost>
</HTTPProxyConnection>
```
एपीआई प्रॉक्सी को सेव करें. अगर एपीआई प्रॉक्सी को डिप्लॉय किया गया है, तो उसे सेव करने पर, नई सेटिंग के साथ फिर से डिप्लॉय किया जाता है.

किसी एपीआई प्रॉक्सी के लिए, Edge के यूज़र इंटरफ़ेस (यूआई) पर दिखने वाला बेस यूआरएल सेट करना

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

ज़्यादातर मामलों में, Edge के यूज़र इंटरफ़ेस (यूआई) पर दिखने वाला यूआरएल, प्रॉक्सी के लिए बाहरी अनुरोध करने का सही यूआरएल होता है. हालांकि, कुछ कॉन्फ़िगरेशन के लिए, दिखने वाला यूआरएल सही नहीं होता. उदाहरण के लिए, इनमें से किसी भी कॉन्फ़िगरेशन की वजह से, दिखने वाला यूआरएल, प्रॉक्सी के लिए बाहरी अनुरोध करने के लिए इस्तेमाल किए जाने वाले असली यूआरएल से मेल नहीं खा सकता:

लोड बैलेंसर पर एसएसएल की सुविधा बंद की गई हो
लोड बैलेंसर और Apigee Router के बीच पोर्ट मैपिंग की गई हो
पाथ रीराइटिंग के साथ कॉन्फ़िगर किया गया लोड बैलेंसर

Edge, वर्चुअल होस्ट पर <BaseUrl> नाम का एक एट्रिब्यूट इस्तेमाल करता है. इसकी मदद से, Edge के यूज़र इंटरफ़ेस (यूआई) पर दिखने वाले यूआरएल को बदला जा सकता है. यहां वर्चुअल होस्ट ऑब्जेक्ट का एक उदाहरण दिया गया है. इसमें <BaseUrl> एट्रिब्यूट शामिल है. इस उदाहरण में, Edge के यूज़र इंटरफ़ेस (यूआई) पर "http://myCo.com" वैल्यू दिखती है:

<VirtualHost name="myTLSVHost">
  <HostAliases>
    <HostAlias>api.myCompany.com</HostAlias>
  </HostAliases>
  <BaseUrl>http://myCo.com</BaseUrl>
  <Port>443</Port>
  <SSLInfo>
    <Enabled>true</Enabled>
    <ClientAuthEnabled>false</ClientAuthEnabled>
    <KeyStore>ref://myTestKeystoreRef</KeyStore>
    <KeyAlias>myKeyAlias</KeyAlias>
  </SSLInfo>
</VirtualHost>

ध्यान दें कि <BaseUrl> की वैल्यू में प्रोटोकॉल (यानी, "http://" या "https://") शामिल होना चाहिए.

अगर <BaseUrl> सेट नहीं किया जाता है, तो Edge के यूज़र इंटरफ़ेस (यूआई) पर डिफ़ॉल्ट यूआरएल "api.myCompany.com" दिखेगा. जबकि, असली होस्ट एलियास "http://myCo.com" है.