इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

कंपनी की इमारत में इंस्टॉल करने पर, वर्चुअल होस्ट पर आपका पूरा कंट्रोल होता है. आप बना सकते हैं TLS का इस्तेमाल करके, किसी भी संगठन के लिए, किसी भी माहौल में वर्चुअल होस्ट.

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

ज़्यादा जानें:

होस्ट के उपनामों के बारे में जानकारी

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

साथ ही, वर्चुअल होस्ट के लिए होस्ट का अन्य नाम और पोर्ट नंबर का कॉम्बिनेशन यूनीक होना चाहिए सभी वर्चुअल होस्ट के लिए, जो Edge इंस्टॉलेशन में इस्तेमाल होते हैं. अगर आपने पोर्ट नंबर (80 या 443 को छोड़कर) कॉन्फ़िगर किया है, यह यूनीक होना चाहिए. साथ ही, इसमें ओवरलैप होने वाला पोर्ट कॉन्फ़िगरेशन नहीं होना चाहिए मौजूदा होस्ट.

वर्चुअल होस्ट बनाते समय, आपको वर्चुअल होस्ट के होस्ट का उपनाम बताना होगा. आम तौर पर, यह वर्चुअल होस्ट का डीएनएस नाम होता है.

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

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

अगर आपके पास myapis.apigee.net के लिए डीएनएस एंट्री है, तो:
```
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
```
अगर आपके पास myapis.apigee.net के लिए डीएनएस एंट्री नहीं है, तो:
```
curl http://routerIP:9001/proxy-base-path/resource-path -H 'host:myapis.apigee.net'
```
इस फ़ॉर्म में, आप राऊटर का आईपी पता तय कर दें और होस्ट उपनाम को Host हेडर.

ध्यान दें: curl कमांड, ज़्यादातर ब्राउज़र वगैरह सुविधाएं, Host हेडर को अपने-आप डोमेन सेट अप किया है, ताकि आप फ़ॉर्म में कर्ल कमांड का इस्तेमाल कर सकें:
```
curl http://routerIP:9001/proxy-base-path/resource-path
```

आपके लिए उपलब्ध विकल्प वर्चुअल होस्ट के लिए डीएनएस एंट्री नहीं है

आपके पास डीएनएस एंट्री न होने पर, एक विकल्प यह है कि आप होस्ट उपनाम को वर्चुअल होस्ट का राऊटर और पोर्ट, जैसे कि routerIP:port. जैसे:

192.168.1.31:9001

जब आप नीचे दिए गए फ़ॉर्म में curl निर्देश देते हैं:

curl http://routerIP:9001/proxy-base-path/resource-path

इस विकल्प को प्राथमिकता दी जाती है, क्योंकि यह Edge यूआई के साथ ठीक से काम करता है.

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

वैकल्पिक रूप से, आप होस्ट एलियास को किसी मान पर सेट कर सकते हैं, जैसे temp.hostalias.com. इसके बाद, आपको हर अनुरोध पर Host हेडर पास करना होगा:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

या अपनी /etc/hosts फ़ाइल में होस्ट का अन्य नाम जोड़ें. उदाहरण के लिए, इस पंक्ति को /etc/hosts:

192.168.1.31 temp.hostalias.com

इसके बाद, यह अनुरोध किया जा सकता है कि आपके पास डीएनएस एंट्री है:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path

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

वर्चुअल होस्ट बनाते समय, आप वह राऊटर पोर्ट तय करते हैं जिसका इस्तेमाल वर्चुअल होस्ट करता है. इसके लिए उदाहरण के लिए, पोर्ट 9001.

Apigee for Private Cloud के वर्शन 4.16.01 और इसके बाद के वर्शन के लिए, डिफ़ॉल्ट रूप से राऊटर इस तरह काम करता है: उपयोगकर्ता "apigee" जिसके पास खास अधिकार वाले पोर्ट का ऐक्सेस नहीं है. आम तौर पर, 1024 और इससे पहले के पोर्ट. अगर आपने आपको ऐसा वर्चुअल होस्ट बनाना है जो राऊटर को किसी सुरक्षित पोर्ट से बाइंड कर सके. इसके लिए, आपको राऊटर को ऐसे पोर्ट के ऐक्सेस वाले उपयोगकर्ता के तौर पर चलाने के लिए कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए वर्चुअल होस्ट सेट अप करना देखें.

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

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

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

ब्राउज़र का इस्तेमाल करके वर्चुअल होस्ट बनाना

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

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

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

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

किसी मौजूदा वर्चुअल होस्ट के नाम पर क्लिक करके भी उसमें बदलाव किया जा सकता है.
अपना नया वर्चुअल होस्ट तय करें. ध्यान दें कि बेस यूआरएल फ़ील्ड में प्रोटोकॉल इस्तेमाल किया जा सकता है (जैसे, फ़ील्ड की वैल्यू से पहले "http://" या "https://" लगाएं.)
इसके अलावा, इन बातों पर भी ध्यान दें:
- जितने वर्चुअल होस्ट बनाए जा सकते हैं उनकी संख्या
- TLS ज़रूरी नहीं है और यह 1.0, 1.1 या 1.2 वर्शन हो सकता है
- वर्चुअल होस्ट के पोर्ट को कॉन्फ़िगर किया जा सकता है
अपना नया वर्चुअल होस्ट सेव करने के लिए बनाएं बटन पर क्लिक करें.

एपीआई की मदद से वर्चुअल होस्ट बनाना

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

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:port</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

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

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

http://routerIP:port/proxy-base-path/resource-path
https://routerIP:port/proxy-base-path/resource-path

कहां:

http या https: अगर वर्चुअल होस्ट को TLS का इस्तेमाल करने के लिए, एचटीटीपीएस का इस्तेमाल करें. अगर वर्चुअल होस्ट, TLS के साथ काम नहीं करता है, तो एचटीटीपी का इस्तेमाल करें.
routerIP:port, वर्चुअल होस्ट का आईपी पता और पोर्ट नंबर है.
proxy-base-path और resource-path को तब तय किया जाता है, जब एपीआई प्रॉक्सी.

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

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

अगर आपने डीएनएस एंट्री तय की है, तो आपको वर्चुअल होस्ट के लिए होस्ट का अन्य नाम बनाना होगा जो डीएनएस एंट्री के डोमेन नेम से मेल खाता है. होस्ट का उपनाम, उस स्ट्रिंग से मेल खाना चाहिए जो Host हेडर में क्लाइंट पास होता है. ऊपर दिए गए उदाहरण से, आप api.myCompany.com का एक होस्ट उपनाम तय करेंगे.

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

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

वर्चुअल होस्ट बनाने का तरीका किसी प्रॉडक्ट की बिक्री के लिए Virtual Host API, जहां ms-IP है मैनेजमेंट सर्वर नोड का आईपी पता या डोमेन नेम:

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

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

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

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

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

वर्चुअल होस्ट को अपडेट करने के लिए ऐसा Virtual Host API अपडेट करें जिसमें <ms-IP> का आईपी पता हो या प्रबंधन सर्वर नोड के डोमेन नाम से मेल खाने चाहिए. आपको अनुरोध के मुख्य भाग में वर्चुअल होस्ट का इस्तेमाल करें, न कि सिर्फ़ उन एलिमेंट में जिन्हें आप बदलना चाहते हैं. इसमें उदाहरण के लिए, वर्चुअल होस्ट के पोर्ट नंबर को 9008 से 9009 में बदला जाता है:
```
curl -X PUT -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
  -d '<VirtualHost name="newVHost">
    <HostAliases>
      <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9009</Port>
  </VirtualHost>' \
  -u email:password
```
Edge for Private Cloud के वर्शन 4.16.01 और 4.16.05 के लिए, अगर आपने बदलाव किया है है और आप पोर्ट में बदलाव किए बिना TLS को चालू या बंद कर सकते हैं नंबर, फिर:
1. राऊटर बंद करें:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
```
2. /opt/nginx/conf.d में मौजूद कोई भी फ़ाइल मिटाएं:
```
rm -f /opt/nginx/conf.d/*
```
3. राऊटर शुरू करें:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router start
```
4. सभी राऊटर के लिए इसे दोहराएं.