প্রাইভেট ক্লাউডের জন্য ভার্চুয়াল হোস্ট কনফিগার করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

অন-প্রাঙ্গণে ইনস্টলেশনের ক্ষেত্রে, ভার্চুয়াল হোস্টের উপর আপনার সম্পূর্ণ নিয়ন্ত্রণ থাকে। আপনি TLS ব্যবহার করে বা না করে, যেকোনও পরিবেশের যেকোনও সংস্থার জন্য ভার্চুয়াল হোস্ট তৈরি করতে পারবেন।

কীভাবে একটি সাধারণ ভার্চুয়াল হোস্ট তৈরি করতে হয় তা এই ডকুমেন্টে বর্ণনা করা হয়েছে। অর্থাৎ, এমন কোনও ব্রাউজার যা TLS প্রোটোকল ব্যবহার করে না। TLS কাজ করে এমন ভার্চুয়াল হোস্ট তৈরি করা সংক্রান্ত উদাহরণ সহ আরও উদাহরণ পেতে, প্রাইভেট ক্লাউডের জন্য API অ্যাক্সেস করতে TLS কনফিগার করা লিঙ্ক দেখুন।

আরও জানুন:

• ভার্চুয়াল হোস্ট সম্পর্কে
• ভার্চুয়াল হোস্ট কনফিগার করা
• TLS কনফিগার করা
• কীস্টোর ও ট্রাস্টস্টোর
• প্রাইভেট ক্লাউডের জন্য API-তে TLS অ্যাক্সেস কনফিগার করা

হোস্ট অ্যালিয়াস সম্পর্কে

ভার্চুয়াল হোস্ট তৈরি করার সময়, আপনাকে অবশ্যই ভার্চুয়াল হোস্টের হোস্ট অ্যালিয়াস উল্লেখ করতে হবে। সাধারণত এটি হল ভার্চুয়াল হোস্টের ডিএনএস নাম।

Edge Router, অনুরোধ হ্যান্ডেল করা API প্রক্সি নির্ধারণ করার অংশ হিসেবে উপলভ্য হোস্ট ছদ্মনামের তালিকার সাথে ইনকামিং অনুরোধের Host হেডার তুলনা করে। ভার্চুয়াল হোস্টের মাধ্যমে অনুরোধ করার সময়, ভার্চুয়াল হোস্টের হোস্ট উপনামের সাথে ম্যাচ করে এমন ডোমেনের নাম উল্লেখ করুন অথবা রাউটারের IP অ্যাড্রেস এবং হোস্ট উপনাম সহ Host হেডার উল্লেখ করুন।

যেমন, আপনি যদি 9001 পোর্টে myapis.apigee.net হোস্ট অ্যালিয়াস সহ একটি ভার্চুয়াল হোস্ট তৈরি করে থাকেন, তাহলে সেই ভার্চুয়াল হোস্টের মাধ্যমে কোনও API-তে cURL অনুরোধ নিম্নলিখিত ফর্মগুলির মধ্যে একটি ব্যবহার করতে পারে:

• myapis.apigee.net-এর জন্য আপনার কোনও DNS এন্ট্রি থাকলে:

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

• myapis.apigee.net-এর জন্য আপনার কোনও DNS এন্ট্রি না থাকলে:

  curl http://routerIP:9001/proxy-base-path/resource-path -H 'host:myapis.apigee.net'

  এই ফর্মে, আপনি রাউটারের IP অ্যাড্রেস নির্দিষ্ট করেন এবং Host হেডারে হোস্টের ছদ্মনাম পাস করেন।

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

ভার্চুয়াল হোস্টের জন্য আপনার কাছে কোনও DNS এন্ট্রি না থাকলে বিকল্প

আপনার কাছে কোনও DNS এন্ট্রি না থাকলে, একটি বিকল্প হল রাউটারের IP অ্যাড্রেস এবং ভার্চুয়াল হোস্টের পোর্টকে হোস্ট অ্যালিয়াস হিসেবে সেট করা, যেমন routerIP:port। উদাহরণ:

192.168.1.31:9001

আপনি নিচে দেওয়া ফর্মে curl কমান্ড দিলে:

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

এই বিকল্পটি পছন্দ করা হয় কারণ এটি Edge UI-এর সাথে ভালভাবে কাজ করে।

আপনার একাধিক রাউটার থাকলে, প্রতিটি রাউটারের জন্য হোস্ট অ্যালিয়াস যোগ করুন, প্রতিটি রাউটারের IP অ্যাড্রেস এবং ভার্চুয়াল হোস্টের পোর্ট উল্লেখ করুন।

অথবা, আপনি হোস্ট অ্যালিয়াসকে একটি ভ্যালু সেট করতে পারেন, যেমন 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

তারপরে, আপনার যদি কোনও DNS এন্ট্রি থাকে, তাহলে আপনি সেইভাবে অনুরোধ করতে পারবেন:

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

প্রাইভেট ক্লাউড 4.16.01 ও তার পরবর্তী যেকোনও ভার্সনের জন্য Edge-এ ভার্চুয়াল হোস্ট পোর্ট সম্পর্কে

ভার্চুয়াল হোস্ট তৈরি করার সময়, ভার্চুয়াল হোস্টের ব্যবহার করা রাউটার পোর্ট নির্দিষ্ট করেন। যেমন, পোর্ট 9001.

Apigee for Private Cloud রিলিজ 4.16.01 এবং এর পরের যেকোনও ভার্সনের জন্য, ডিফল্ট হিসেবে, রাউটার "apigee" ব্যবহারকারী হিসেবে রান করে, যার কাছে সাধারণত 1024 এবং এর নিচের পোর্ট সহ বিশেষ পোর্ট অ্যাক্সেস করার সুবিধা থাকে না। আপনি যদি এমন একটি ভার্চুয়াল হোস্ট তৈরি করতে চান যা রাউটারকে সুরক্ষিত পোর্টের সাথে বাইন্ড করে, তাহলে আপনাকে সেইসব পোর্টে অ্যাক্সেস থাকা ব্যবহারকারী হিসেবে রাউটারকে কনফিগার করতে হবে। আরও জানতে ভার্চুয়াল হোস্ট সেট-আপ করা দেখুন।

ভার্চুয়াল হোস্ট তৈরি করা

এই বিভাগে, প্রাইভেট ক্লাউডের জন্য Apigee Edge-এ কীভাবে ভার্চুয়াল হোস্ট তৈরি করতে হয় তা বর্ণনা করা হয়েছে। মনে রাখবেন, নতুন ভার্চুয়াল হোস্ট তৈরি করতে হলে, আপনাকে অবশ্যই একজন প্রতিষ্ঠান অ্যাডমিনিস্ট্রেটর হতে হবে।

আপনি API বা Edge UI ব্যবহার করে প্রাইভেট ক্লাউডের জন্য Apigee Edge-এ ভার্চুয়াল হোস্ট তৈরি করতে পারেন। এগুলি নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।

ব্রাউজার ব্যবহার করে ভার্চুয়াল হোস্ট তৈরি করা

এই বিভাগে, কীভাবে ব্রাউজার (শুধুমাত্র Edge UI) ব্যবহার করে ভার্চুয়াল হোস্ট তৈরি করতে হয় তা বর্ণনা করা হয়েছে।

Edge UI-তে নতুন ভার্চুয়াল হোস্ট তৈরি করতে:

1. Edge ম্যানেজমেন্ট UI-তে লগ-ইন করুন।
2. অ্যাডমিন > ভার্চুয়াল হোস্ট বিকল্প বেছে নিন।

3. ড্রপ-ডাউন তালিকা থেকে এনভায়র্নমেন্ট বেছে নিন।

   Edge সেই এনভায়র্নমেন্টের জন্য ভার্চুয়াল হোস্টের একটি তালিকা দেখায়।

4. নতুন ভার্চুয়াল হোস্ট তৈরি করতে, + ভার্চুয়াল হোস্ট বিকল্প বেছে নিন।

   Edge ভার্চুয়াল হোস্ট তৈরি করুন ফর্মটি দেখায়।

   এছাড়াও, আপনি আগে থেকে থাকা ভার্চুয়াল হোস্টের নাম এডিট করতে সেটিতে ক্লিক করতে পারেন।

5. আপনার নতুন ভার্চুয়াল হোস্টকে সংজ্ঞায়িত করুন। মনে রাখবেন, বেস URL ফিল্ডে অবশ্যই প্রোটোকল থাকতে হবে (যেমন, ফিল্ডের ভ্যালুর আগে "http://" বা "https://" লিখুন।)

   এছাড়াও, মনে রাখবেন যে:

   • আপনি যতগুলি ভার্চুয়াল হোস্ট তৈরি করতে চান, তার কোনও সীমা নেই
   • TLS ঐচ্ছিক এবং এটি ভার্সন 1.0, 1.1 বা 1.2 হতে পারে
   • ভার্চুয়াল হোস্টের পোর্ট কনফিগার করা যায়
6. আপনার নতুন ভার্চুয়াল হোস্ট সেভ করতে তৈরি করুন বোতামে ক্লিক করুন।

API-এর সাহায্যে ভার্চুয়াল হোস্ট তৈরি করা

API-এর সাহায্যে ভার্চুয়াল হোস্ট তৈরি করতে, এমন একটি XML অবজেক্ট তৈরি করুন যা ভার্চুয়াল হোস্টকে সংজ্ঞায়িত করে। যেমন, নিম্নলিখিত XML অবজেক্ট একটি ভার্চুয়াল হোস্টকে সংজ্ঞায়িত করে যা HTTP প্রোটোকল ব্যবহার করে:

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

লক্ষ্য করুন যে ভার্চুয়াল হোস্টের মধ্যে একটি name প্রপার্টি আছে। ভার্চুয়াল হোস্ট ব্যবহার করার জন্য API প্রক্সি কনফিগার করতে আপনি name প্রপার্টির ভ্যালু ব্যবহার করেন।

তারপরে, আপনি এই ভার্চুয়াল হোস্টের মাধ্যমে API প্রক্সি অ্যাক্সেস করতে পারবেন, এর জন্য আপনাকে এখানে অনুরোধ করতে হবে:

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

যেখানে:

• http বা https: ভার্চুয়াল হোস্ট TLS-এর সাথে কাজ করার জন্য কনফিগার করা থাকলে, HTTPS ব্যবহার করুন। ভার্চুয়াল হোস্ট TLS-এর সাথে কাজ না করলে, HTTP ব্যবহার করুন।
• routerIP:port হল ভার্চুয়াল হোস্টের IP অ্যাড্রেস ও পোর্ট নম্বর।
• আপনি API প্রক্সি তৈরি করার সময় proxy-base-path এবং resource-path সংজ্ঞায়িত করা হয়।

সাধারণত, আপনি IP অ্যাড্রেস ও পোর্ট নম্বর সহ গ্রাহকদের কাছে API প্রকাশ করেন না। পরিবর্তে, আপনি রাউটার ও পোর্টের জন্য একটি DNS এন্ট্রি নির্ধারণ করেন। যেমন:

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

আপনি যদি DNS এন্ট্রি নির্ধারণ করেন, তাহলে আপনাকে অবশ্যই ভার্চুয়াল হোস্টের জন্য হোস্ট অ্যালিয়াস তৈরি করতে হবে যা DNS এন্ট্রির ডোমেন নামের সাথে ম্যাচ করে। হোস্টের ছদ্মনাম অবশ্যই সেই স্ট্রিংয়ের সাথে মিলতে হবে যা ক্লায়েন্ট Host হেডারে পাস করে। উপরের উদাহরণ থেকে, আপনি api.myCompany.com-এর একটি হোস্ট ছদ্মনাম নির্দিষ্ট করবেন।

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

HTTP প্রোটোকল ব্যবহার করে এমন ভার্চুয়াল হোস্ট তৈরি করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. ভার্চুয়াল হোস্ট তৈরি করুন API ব্যবহার করে ভার্চুয়াল হোস্ট তৈরি করুন, যেখানে ms-IP হল ম্যানেজমেন্ট সার্ভার নোডের 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

2. হোস্ট অ্যালিয়াসের সাথে ম্যাচ করে এমন ভার্চুয়াল হোস্টের জন্য ডিএনএস রেকর্ড তৈরি করুন।
3. আপনার কোনও আগে থেকে থাকা API প্রক্সি থাকলে, Proxy Endpoint-এ <HTTPConnection> এলিমেন্টে ভার্চুয়াল হোস্ট যোগ করুন। সব নতুন API প্রক্সিতে ভার্চুয়াল হোস্ট অটোমেটিক যোগ করা হয়। ভার্চুয়াল হোস্ট ব্যবহার করার জন্য API প্রক্সি কনফিগার করা দেখুন।

ভার্চুয়াল হোস্ট পরিবর্তন করা

ভার্চুয়াল হোস্ট পরিবর্তন করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. ভার্চুয়াল হোস্ট আপডেট করুন API ব্যবহার করে ভার্চুয়াল হোস্ট আপডেট করুন, যেখানে <ms-IP> হল ম্যানেজমেন্ট সার্ভার নোডের 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

2. শুধুমাত্র 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. সব রাউটারের জন্য একই প্রসেস রিপিট করুন।