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

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

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

वर्चुअल होस्ट के लिए वीडियो परिचय देखें.

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

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

  1. सार्वजनिक तौर पर दिखने वाले डोमेन के लिए, डीएनएस एंट्री और CNAME रिकॉर्ड बनाएं.
  2. वर्चुअल होस्ट पर TLS को चालू करने पर:
    1. यहां बताई गई प्रक्रिया का इस्तेमाल करके, कीस्टोर बनाएं और उसे कॉन्फ़िगर करें: कीस्टोर और Truststore.
    2. अपने सर्टिफ़िकेट और पासकोड को कीस्टोर पर अपलोड करें. पक्का करें कि आपके सर्टिफ़िकेट में बताया गया डोमेन नेम, उस होस्ट अन्य नाम से मेल खाता हो जिसका इस्तेमाल आपको वर्चुअल होस्ट के लिए करना है.
    3. Edge यूज़र इंटरफ़ेस या एपीआई का इस्तेमाल करके कीस्टोर का रेफ़रंस बनाएं. रेफ़रंस, कीस्टोर का नाम और पहचान फ़ाइल के टाइप के बारे में KeyStore बताता है. पहचान फ़ाइलें बनाने और उनमें बदलाव करने के बारे में ज़्यादा जानने के लिए, पहचान फ़ाइलों के साथ काम करना देखें.
    4. अगर आप दो-तरफ़ा TLS कर रहे हैं, तो एक ट्रस्टस्टोर बनाएं, सर्टिफ़िकेट अपलोड करें, और ट्रस्टस्टोर के लिए रेफ़रंस बनाएं. यहां बताई गई प्रक्रिया का इस्तेमाल करके, ट्रस्टस्टोर बनाएं: Keystores और Truststores.
  3. वर्चुअल होस्ट बनाएं एपीआई का इस्तेमाल करके, वर्चुअल होस्ट बनाएं. अगर TLS को चालू किया जा रहा है, तो यह पक्का करें कि आपने सही कीस्टोर रेफ़रंस, ट्रस्टस्टोर रेफ़रंस, और कुंजी उपनाम बताया हो.
  4. अगर आपके पास कोई मौजूदा एपीआई प्रॉक्सी है, तो वर्चुअल होस्ट को प्रॉक्सीEndpoint में जोड़ें. वर्चुअल होस्ट, सभी नई एपीआई प्रॉक्सी में अपने-आप जुड़ जाता है. वर्चुअल होस्ट का इस्तेमाल करने के लिए, एपीआई प्रॉक्सी कॉन्फ़िगर करने का तरीका देखें.

वर्चुअल होस्ट का इस्तेमाल करने के लिए एपीआई प्रॉक्सी को अपडेट करने और होस्ट के उपनाम के लिए डीएनएस एंट्री और 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 यूज़र इंटरफ़ेस (यूआई) में वर्चुअल होस्ट बनाने, उनमें बदलाव करने, और उन्हें मिटाने के लिए यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करने के लिए:

  1. apigee.com/edge में साइन इन करें

    प्राइवेट क्लाउड ग्राहकों के लिए एज http://ms-ip:9000 (ऑन-प्रिमाइसेस) का इस्तेमाल करता है, जहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.

  2. बाएं नेविगेशन बार में, एडमिन >वर्चुअल होस्ट चुनें.
  3. एनवायरमेंट को चुनें, जैसे कि prod या test.
    एनवायरमेंट के लिए तय किए गए वर्चुअल होस्ट दिखाए जाते हैं.
  4. वर्चुअल होस्ट बनाने के लिए, + वर्चुअल होस्ट चुनें या इसमें बदलाव करने के लिए, किसी मौजूदा वर्चुअल होस्ट का नाम चुनें.

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

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

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

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

इस परिभाषा में, आप:

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

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

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

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
डोमेन को अनुरोध कर सकते हैं

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

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

<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> एलिमेंट को 'सही' पर सेट करके TLS चालू किया जाता है. साथ ही, <KeyStore> और <KeyAliase> एलिमेंट का इस्तेमाल करके, TLS कनेक्शन के लिए इस्तेमाल किए जाने वाले कीस्टोर और कुंजी के बारे में बताने के लिए, अन्य नाम तय किया जाता है.

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

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

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

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

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

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

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

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

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

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

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

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

<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> को 'सही है' पर सेट करके, दो-तरफ़ा TLS चालू करें.
  • <TrustStore> एलिमेंट का इस्तेमाल करके, Truststore के रेफ़रंस के बारे में बताएं. ट्रस्टस्टोर के पास क्लाइंट का सर्टिफ़िकेट जारी करने वाले और सर्टिफ़िकेट की सीए चेन होती है. ये दोनों चीज़ें ज़रूरी हैं.

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

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

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

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

इस उदाहरण में, 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 यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके वर्चुअल होस्ट के बारे में जानकारी देखने के लिए:

  1. apigee.com/edge में साइन इन करें.

    प्राइवेट क्लाउड ग्राहकों के लिए एज http://ms-ip:9000 (ऑन-प्रिमाइसेस) का इस्तेमाल करता है, जहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.

  2. बाएं नेविगेशन बार में, एडमिन > वर्चुअल होस्ट चुनें.
  3. एनवायरमेंट को चुनें, जैसे कि prod या test.

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

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

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

क्लासिक एज (प्राइवेट क्लाउड)

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

  1. http://ms-ip:9000 में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
  2. बाएं नेविगेशन बार में, एडमिन > वर्चुअल होस्ट चुनें.
  3. एनवायरमेंट को चुनें, जैसे कि prod या test.
  4. वर्चुअल होस्ट टैब पर क्लिक करें.

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

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

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

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

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 को "सुरक्षित" के तौर पर सेट किया जा सकता है:

<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>

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

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

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

जगह:

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

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

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

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

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

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

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

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

  1. नीचे बताए गए तरीके के मुताबिक, एपीआई प्रॉक्सी एडिटर को ऐक्सेस करें.

    Edge

    Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एपीआई प्रॉक्सी एडिटर ऐक्सेस करने के लिए:

    1. apigee.com/edge में साइन इन करें.

      प्राइवेट क्लाउड ग्राहकों के लिए एज http://ms-ip:9000 (ऑन-प्रिमाइसेस) का इस्तेमाल करता है, जहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.

    2. बाएं नेविगेशन बार में, डेवलप करें > एपीआई प्रॉक्सी चुनें.
    3. सूची में मौजूद वह एपीआई प्रॉक्सी चुनें जिसमें बदलाव करना है.

    क्लासिक एज (प्राइवेट क्लाउड)

    क्लासिक Edge यूज़र इंटरफ़ेस (यूआई) से एपीआई प्रॉक्सी एडिटर ऐक्सेस करने के लिए:

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

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

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

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

  • लोड बैलेंसर में एसएसएल बंद होना
  • लोड बैलेंसर और Apigee राऊटर के बीच पोर्ट मैपिंग होती है
  • पाथ रीराइटिंग के साथ कॉन्फ़िगर किया गया लोड बैलेंसर

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" है.