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

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

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

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

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

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

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

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

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

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

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

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

  • नाम = myvhost
  • होस्ट का उपनाम = apis.acme.com
  • पोर्ट = 443
  • TLS चालू है

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

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

कहां:

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

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

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

Apigee से दिए गए हर वर्चुअल होस्ट के होस्ट के उपनाम में, संगठन का नाम और एनवायरमेंट का डेटा, जैसा कि इस टेबल में दिखाया गया है:

परिवेश वर्चुअल होस्ट का नाम होस्ट का दूसरा ईमेल पता पोर्ट टीएलएस चालू होना
प्रोडक्शन डिफ़ॉल्ट {org-name}-prod.apigee.net 80 नहीं
सुरक्षित {org-name}-prod.apigee.net 443 हां
टेस्ट डिफ़ॉल्ट {org-name}-test.apigee.net 80 नहीं
सुरक्षित {org-name}-test.apigee.net 443 हां

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

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

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

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

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

Edge Management सर्वर नोड पर शामिल करने के लिए, यहां दिया गया कमांड चलाएं:

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

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

उदाहरण के लिए, आपने:

  • आपके संगठन के एडमिन के तौर पर काम करने वाला उपयोगकर्ता
  • example नाम का संगठन
  • prod नाम के संगठन में एक एनवायरमेंट
  • default नाम के एनवायरमेंट में मौजूद वर्चुअल होस्ट, जो पोर्ट पर एचटीटीपी ऐक्सेस करने की अनुमति देता है 9,001
  • राऊटर को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले डीएनएस नाम का होस्ट उपनाम या राऊटर के आईपी पते और 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.

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

Edge में क्लाउड में, पहली बार Edge संगठन बनाने पर, Apigee दो एनवायरमेंट बनाता है (test और prod), दो वर्चुअल होस्ट हर एनवायरमेंट (डिफ़ॉल्ट और सुरक्षित) और हर एनवायरमेंट के लिए डीएनएस रिकॉर्ड वर्चुअल होस्ट.

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

  • 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 डोमेन. ऐसा करें इसलिए, पहले आपको अपनी डीएनएस एंट्री और CNAME रिकॉर्ड खुद बनाना होगा.

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

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

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

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

  • नाम = myvhost
  • होस्ट का उपनाम = apis.acme.com
  • पोर्ट = 443
  • TLS ऐक्सेस चालू करें

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

होस्ट का उपनाम और प्राइवेट क्लाउड के लिए Edge में डीएनएस नाम

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

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

  • नाम=डिफ़ॉल्ट: http://{org-name}-{env-name}.apigee.net (रूटर पोर्ट 80)
  • नाम=सुरक्षित: https://{org-name}-{env-name}.apigee.net (रूटर पोर्ट 443)

प्राइवेट क्लाउड के लिए Edge में, आपको आईपी पते और पोर्ट के लिए डीएनएस एंट्री बनानी होंगी का सुझाव भी देता है.

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

  • नाम = myvhost
  • होस्ट का उपनाम = apis.acme.com
  • पोर्ट = 9001
  • TLS ऐक्सेस चालू करें

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

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

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

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

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

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

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

*.example.com

ये उदाहरण अमान्य हैं:

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

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

वर्चुअल होस्ट के लिए TLS सर्टिफ़िकेट के सीएन नाम में, मेल खाने वाला वाइल्डकार्ड होना चाहिए. उदाहरण के लिए, *.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>

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

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