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

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

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

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

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

उदाहरण के लिए, यहां दी गई इमेज में दो वर्चुअल होस्ट की परिभाषाओं वाला एक राउटर दिखाया गया है:

पहला वर्चुअल होस्ट, डोमेन domainName1 पर एचटीटीपीएस अनुरोधों को मैनेज करता है. वहीं, दूसरा वर्चुअल होस्ट domainName2 पर एचटीटीपी अनुरोधों को मैनेज करता है.

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

वर्चुअल होस्ट की परिभाषाओं के बारे में जानकारी

वर्चुअल होस्ट में यह जानकारी शामिल होती है:

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

उदाहरण के लिए, वर्चुअल होस्ट बनाते समय, यह जानकारी दी जाती है:

  • name = myvhost
  • host alias = apis.acme.com
  • port = 443
  • TLS चालू है

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

https://apis.acme.com/{proxy-base-path}/{resource-path}

कहां:

  • {proxy-base-path} को एपीआई प्रॉक्सी बनाते समय तय किया जाता है. यह हर एपीआई प्रॉक्सी के लिए यूनीक होता है. उदाहरण के लिए: 
    https://apis.acme.com/characters
  • {resource-path} एपीआई प्रॉक्सी के ज़रिए ऐक्सेस किए जा सकने वाले किसी संसाधन का पाथ. उदाहरण के लिए: 
    https://apis.acme.com/characters/coyote
https://apis.acme.com/characters/roadrunner

Edge for the Cloud में वर्चुअल होस्ट के बारे में जानकारी

Edge के हर संगठन में, दो एनवायरमेंट (test और prod), हर एनवायरमेंट में दो वर्चुअल होस्ट (default और secure), और हर होस्ट एलियास के लिए डीएनएस रिकॉर्ड अपने-आप शामिल होते हैं.

Apigee की ओर से दिए गए हर वर्चुअल होस्ट के होस्ट एलियास में, संगठन और एनवायरमेंट का नाम शामिल होता है. जैसा कि यहां दी गई टेबल में दिखाया गया है:

एनवायरमेंट वर्चुअल होस्ट का नाम होस्ट एलियास पोर्ट TLS चालू है
prod default {org-name}-prod.apigee.net 80 नहीं
secure {org-name}-prod.apigee.net 443 हां
test default {org-name}-test.apigee.net 80 नहीं
secure {org-name}-test.apigee.net 443 हां

उदाहरण के लिए, prod एनवायरमेंट में "myorg" नाम के संगठन का डिफ़ॉल्ट डोमेन नेम "myorg-prod.apigee.net" है. इसलिए, उस संगठन में एपीआई प्रॉक्सी को ऐक्सेस करने के लिए, इस फ़ॉर्मैट में यूआरएल का इस्तेमाल करें:

http://myorg-prod.apigee.net/{proxy-base-path}/{resource-path}
https://myorg-prod.apigee.net/{proxy-base-path}/{resource-path}

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

Edge में, कस्टम डोमेन का एक उदाहरण यहां दिया गया है:

https://apis.acme.com/{proxy-base-path}/{resource-path}

Edge for Private Cloud में वर्चुअल होस्ट के बारे में जानकारी

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

ऑनबोर्डिंग करने के लिए, Edge Management Server नोड पर यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

यहां configFile में, उपयोगकर्ता, संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाने के लिए ज़रूरी जानकारी शामिल होती है.

उदाहरण के लिए, ये चीज़ें बनाई जाती हैं:

  • संगठन के एडमिन के तौर पर काम करने के लिए, अपनी पसंद का कोई उपयोगकर्ता
  • example नाम का संगठन
  • संगठन में prod नाम का एनवायरमेंट
  • एनवायरमेंट में default नाम का वर्चुअल होस्ट. इससे पोर्ट 9001 पर एचटीटीपी ऐक्सेस की अनुमति मिलती है
  • राउटर को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले डीएनएस नाम का होस्ट एलियास या राउटर का आईपी पता और वर्चुअल होस्ट का पोर्ट. यह IP:9001 फ़ॉर्मैट में होता है.

Edge के ऑन-प्रिमाइसेस वर्शन में, बाद में संगठन, एनवायरमेंट, और वर्चुअल होस्ट जोड़े जा सकते हैं. ज़्यादा जानकारी के लिए, ये लेख देखें:

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

iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9001 -j ACCEPT --verbose

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

http://<router-ip>:9001/{proxy-base-path}/{resource-path}

आम तौर पर, अपने एपीआई को ग्राहकों के लिए आईपी पते और पोर्ट नंबर के साथ पब्लिश नहीं किया जाता. इसके बजाय, राउटर और पोर्ट के लिए डीएनएस एंट्री तय की जाती है. उदाहरण के लिए:

http://myAPI.myCo.com/{proxy-base-path}/{resource-path}

डीएनएस एंट्री तय करते समय, आपको एक वर्चुअल होस्ट भी बनाना होगा. इसके लिए, होस्ट एलियास को डीएनएस एंट्री के डोमेन नेम पर सेट करना होगा. ऊपर दिए गए उदाहरण के मुताबिक, वर्चुअल होस्ट बनाते समय, आपको myAPI.myCo.com का होस्ट एलियास तय करना होगा.

होस्ट एलियास और डीएनएस नेम के बारे में जानकारी

वर्चुअल होस्ट के लिए सेट की जाने वाली एक प्रॉपर्टी, होस्ट एलियास होती है. होस्ट एलियास आम तौर पर, वर्चुअल होस्ट का डीएनएस नेम होता है. होस्ट एलियास सेट करने का तरीका, Edge के इंस्टॉलेशन के टाइप पर निर्भर करता है: Cloud या Private Cloud.

Edge for the Cloud में होस्ट एलियास और डीएनएस नेम

Edge for the Cloud में, Edge का संगठन पहली बार बनाते समय, Apigee अपने-आप दो एनवायरमेंट (test और prod), हर एनवायरमेंट में दो वर्चुअल होस्ट (default और secure), और हर वर्चुअल होस्ट के लिए डीएनएस रिकॉर्ड बनाता है.

वर्चुअल होस्ट के होस्ट एलियास में, संगठन और एनवायरमेंट का नाम शामिल होता है. इसलिए, वर्चुअल होस्ट के ज़रिए किए गए अनुरोध का फ़ॉर्मैट यह होता है:

  • http://{org-name}-prod.apigee.net/{proxy-base-path}/{resource-path}
  • https://{org-name}-prod.apigee.net/{proxy-base-path}/{resource-path}
  • http://{org-name}-test.apigee.net/{proxy-base-path}/{resource-path}
  • https://{org-name}-test.apigee.net/{proxy-base-path}/{resource-path}

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

यहां दी गई इमेज में, Edge के ज़रिए एपीआई अनुरोध को प्रोसेस करने के सामान्य कॉन्फ़िगरेशन के बारे में बताया गया है:

इस उदाहरण में:

  • api.acme.com आपका पसंदीदा डोमेन नेम है.
  • api.acme.com को acme-prod.apigee.net पर पॉइंट करने के लिए, डीएनएस एंट्री और सीएनएएमई रिकॉर्ड तय किया जाता है.
  • अनुरोध में Host हेडर शामिल होता है. इसका इस्तेमाल, राउटर यह तय करने के लिए करता है कि कौनसे वर्चुअल होस्ट, अनुरोध को मैनेज करते हैं.

इस उदाहरण में, वर्चुअल होस्ट की परिभाषा में यह जानकारी दी जाती है:

  • name = myvhost
  • host alias = apis.acme.com
  • port = 443
  • टीएलएस ऐक्सेस चालू करें

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

Edge for Private Cloud में होस्ट एलियास और डीएनएस नेम

Edge for the Cloud की तरह, वर्चुअल होस्ट बनाए जाते हैं. इनके लिए, होस्ट एलियास के तौर पर अपने डोमेन नेम का इस्तेमाल किया जाता है. इसके बाद, उन वर्चुअल होस्ट को ऐक्सेस करने के लिए, अपनी डीएनएस एंट्री और सीएनएएमई रिकॉर्ड बनाया जाता है.

Cloud और Private Cloud के बीच एक अंतर यह है कि Cloud में, Apigee आपके संगठनों के लिए डीएनएस नेम अपने-आप बनाता है. ये इस फ़ॉर्मैट में होते हैं:

  • name=default: http://{org-name}-{env-name}.apigee.net (राउटर पोर्ट 80)
  • name=secure: https://{org-name}-{env-name}.apigee.net (राउटर पोर्ट 443)

Edge for the Private Cloud में, आपको अपने राउटर के आईपी पते और पोर्ट के लिए डीएनएस एंट्री बनानी होंगी.

उदाहरण के लिए, वर्चुअल होस्ट की परिभाषा में यह जानकारी दी जाती है:

  • name = myvhost
  • host alias = apis.acme.com
  • port = 9001
  • टीएलएस ऐक्सेस चालू करें

यहां दी गई इमेज में, Edge के ज़रिए एपीआई अनुरोध को प्रोसेस करने के सामान्य कॉन्फ़िगरेशन के बारे में बताया गया है:

इस उदाहरण में:

  • api.acme.com आपका पसंदीदा डोमेन नेम है.
  • api.acme.com को राउटर के आईपी पते और पोर्ट पर पॉइंट करने के लिए, डीएनएस एंट्री और CNAME रिकॉर्ड तय किया जाता है.
  • अनुरोध में Host हेडर शामिल होता है. इसका इस्तेमाल, राउटर यह तय करने के लिए करता है कि कौनसे वर्चुअल होस्ट, अनुरोध को मैनेज करते हैं.

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

होस्ट एलियास और वाइल्डकार्ड

होस्ट एलियास में, "*" वाइल्डकार्ड वर्ण शामिल किया जा सकता है. "*" वाइल्डकार्ड वर्ण, होस्ट एलियास की शुरुआत में (पहले "." से पहले) ही हो सकता है. इसे अन्य वर्णों के साथ मिक्स नहीं किया जा सकता.

वाइल्डकार्ड का इस्तेमाल करने वाले मान्य होस्ट एलियास का एक उदाहरण यहां दिया गया है:

*.example.com

अमान्य उदाहरण यहां दिए गए हैं:

  www.*.example.com
  w*.example.com

वर्चुअल होस्ट एलियास में वाइल्डकार्ड का इस्तेमाल करने से, एपीआई प्रॉक्सी, कई सबडोमेन के लिए किए गए कॉल को मैनेज कर सकती हैं. जैसे, alpha.example.com, beta.example.com या live.example.com. वाइल्डकार्ड एलियास का इस्तेमाल करने से, प्रॉडक्ट की सीमाओं के अंदर रहने के लिए, हर एनवायरमेंट में कम वर्चुअल होस्ट का इस्तेमाल किया जा सकता है. ऐसा इसलिए, क्योंकि वाइल्डकार्ड वाले वर्चुअल होस्ट को सिर्फ़ एक वर्चुअल होस्ट के तौर पर गिना जाता है.

वर्चुअल होस्ट के टीएलएस सर्टिफ़िकेट में, सर्टिफ़िकेट के सीएन नाम में मैचिंग वाइल्डकार्ड होना चाहिए. उदाहरण के लिए, *.example.com.

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

Edge में, वर्चुअल होस्ट को एक्सएमएल ऑब्जेक्ट के तौर पर दिखाया जाता है. उदाहरण के लिए, यहां दिए गए एक्सएमएल ऑब्जेक्ट में, वर्चुअल होस्ट की परिभाषा दी गई है: 

<VirtualHost name="vhostName">
    <HostAliases>
        <HostAlias>hostAlias</HostAlias>
    </HostAliases>
    <Interfaces>
        <!-- Private Cloud only -->
        <Interface>interfaceName</Interface>
    <Port>portNumber</Port>
    <BaseURL>http://myCo.com<</BaseUrl>
    <OCSPStapling>off</OCSPStapling>
    <RetryOptions/>
   <SSLInfo>
        <Enabled>trueFalse</Enabled>
        <ClientAuthEnabled>trueFalse</ClientAuthEnabled>
        <KeyStore>ref://keystoreRef</KeyStore>
        <KeyAlias>keyAlias</KeyAlias>
        <TrustStore>ref://truststoreRef</TrustStore>
        <IgnoreValidationErrors>trueFalse</IgnoreValidationErrors>
    </SSLInfo>
    <Properties>
        <Property name="proxy_read_timeout">timeout</Property>
        <Property name="keepalive_timeout">timeout</Property>
        <Property name="proxy_request_buffering">onOff</Property>
        <Property name="proxy_buffering">onOff</Property>
        <Property name="ssl_protocols">protocolList</Property>
        <Property name="ssl_ciphers">cipherList</Property>
    </Properties>
</VirtualHost>

सेट की जा सकने वाली प्रॉपर्टी की सूची, इस बात पर निर्भर करती है कि Edge for the Cloud या Edge for the Private Cloud का इस्तेमाल किया जा रहा है. Edge for the Private Cloud का इस्तेमाल करने पर, उपलब्ध प्रॉपर्टी की सूची, Edge के वर्शन पर भी निर्भर करती है. वर्चुअल होस्ट की सभी प्रॉपर्टी के बारे में पूरी जानकारी पाने के लिए, वर्चुअल होस्ट की प्रॉपर्टी का रेफ़रंस देखें.

Edge के अपने वर्शन के लिए वर्चुअल होस्ट बनाने के बारे में ज़्यादा जानने के लिए, ये लेख देखें: