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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

एकतरफ़ा 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/SSL देखें TLS इस्तेमाल करने के बारे में जानकारी.

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

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

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

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

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

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

कीस्टोर और ट्रस्टस्टोर:

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

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

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

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

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

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

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

इस उदाहरण में, आपने 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 में साइन इन करें.

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

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

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

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

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

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

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

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

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

    वर्चुअल होस्ट टैब नाम, पोर्ट, और
                 उपनाम वगैरह.

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

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

देख रहा है Edge API वाला वर्चुअल होस्ट

वर्चुअल होस्ट के बारे में जानकारी देखने के लिए, Edge API का भी इस्तेमाल किया जा सकता है. इसके लिए उदाहरण के लिए, लिस्ट वर्चुअल Hosts 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 का नाम है वर्चुअल होस्ट. उदाहरण के लिए, vhost_name को "सुरक्षित" बताया जा सकता है से Apigee के बनाए गए डिफ़ॉल्ट सुरक्षित वर्चुअल होस्ट का कॉन्फ़िगरेशन देखें:

<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> का मतलब है क्लाइंट "सुरक्षित" के होस्ट उपनाम का इस्तेमाल करके एपीआई प्रॉक्सी को कॉल कर सकता है वर्चुअल होस्ट.

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

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

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

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

    Edge

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

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

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

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

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

    क्लासिक 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> एट्रिब्यूट का इस्तेमाल करें. इस उदाहरण में, वैल्यू "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" है.