আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
এই টপিকে SOAP-ভিত্তিক ওয়েব সার্ভিসের জন্য কীভাবে API প্রক্সি তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে। আপনি Edge-এ দুই ধরনের SOAP প্রক্সি তৈরি করতে পারেন। একটি ব্যাকএন্ড SOAP সার্ভিসের জন্য একটি RESTful ইন্টারফেস তৈরি করে এবং অন্যটি SOAP মেসেজকে ব্যাকএন্ডে "পাস থ্রু" করে। এই টপিকে উভয় কৌশলই বর্ণনা করা হয়েছে।
এই ভিডিওটিতে এপিআই প্রক্সি উইজার্ড ব্যবহার করে Apigee Edge-এ একটি SOAP সার্ভিসকে REST সার্ভিসে রূপান্তর করার একটি সম্পূর্ণ ডেমো দেখানো হয়েছে। তবে, আপনি যদি SOAP-থেকে-REST রূপান্তরের উপর আরও বেশি নিয়ন্ত্রণ চান, তাহলে পলিসি ব্যবহার করে একটি প্রক্সি তৈরি করতে পারেন। আরও তথ্যের জন্য, দেখুন টিউটোরিয়াল: Apigee Edge-এ ম্যানুয়ালি একটি SOAP-থেকে-REST এপিআই প্রক্সি তৈরি ।
একটি SOAP-ভিত্তিক পরিষেবার জন্য একটি RESTful API প্রক্সি তৈরি করা
এই বিভাগে 'Build a Proxy' উইজার্ডে 'REST to SOAP to REST' বিকল্পটি ব্যবহার করে কীভাবে একটি RESTful SOAP API প্রক্সি তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে।
সংক্ষিপ্ত বিবরণ
REST to SOAP to REST অপশনটি একটি RESTful API প্রক্সি তৈরি করার জন্য WSDL প্রসেস করে। Edge WSDL থেকে সার্ভিসটির সমর্থিত অপারেশন, ইনপুট প্যারামিটার ইত্যাদি নির্ধারণ করে। Edge প্রতিটি অপারেশনের জন্য কোন HTTP মেথড ব্যবহার করতে হবে তা "অনুমান" করে। সাধারণত, Edge অপারেশনগুলোকে GET রিকোয়েস্টে রূপান্তরিত করে, যার সুবিধা হলো এগুলো ক্যাশেযোগ্য। Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্টও সেট আপ করে, যা প্রতিটি SOAP অপারেশনের জন্য ভিন্ন হতে পারে।
এই ধরনের প্রক্সির জন্য, Edge স্বয়ংক্রিয়ভাবে একটি OpenAPI স্পেসিফিকেশন তৈরি করে, যা ব্যবহার করে আপনি API ডকুমেন্টেশন তৈরি করতে পারেন।
প্রাথমিক পদক্ষেপ
প্রান্ত
Edge UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য একটি RESTful API প্রক্সি তৈরি করতে:
- apigee.com/edge- এ সাইন ইন করুন।
- বাম দিকের নেভিগেশন বার থেকে Develop > API Proxys নির্বাচন করুন।
- +প্রক্সি-তে ক্লিক করুন।
- SOAP পরিষেবাতে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায় WSDL ফাইলটি প্রদান করুন।
মাঠ বর্ণনা WSDL ফাইল সরবরাহ করুন WSDL-এর উৎস নির্বাচন করুন।
- ওয়েব ঠিকানা (URL) থেকে - WSDL-এর URL-টি লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার লোকাল ডিরেক্টরি থেকে একটি WSDL ফাইল আপলোড করুন। যদি কোনো নির্ভরশীলতা থাকে, তবে আপনি একাধিক ফাইল আপলোড করতে পারেন।
- WSDL-টি যাচাই করতে Validate-এ ক্লিক করুন।
- নিম্নলিখিত প্রক্সি বিবরণ লিখুন:
মাঠ বর্ণনা নাম আপনার API-এর জন্য প্রদর্শিত নাম। আলফানিউমেরিক অক্ষর, ড্যাশ (-) বা আন্ডারস্কোর (_) উল্লেখ করুন। মূল পথ আপনার এপিআই প্রক্সির http(s)://[host] ঠিকানার পরে যে URI অংশটি দেখা যায়। Edge আগত অনুরোধ বার্তাগুলিকে সঠিক এপিআই প্রক্সিতে মেলানোর এবং পাঠানোর জন্য বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : এপিআই প্রক্সি বেস পাথ ডিফল্টরূপে
Nameফিল্ডে নির্দিষ্ট করা মানটিকে সম্পূর্ণ ছোট হাতের অক্ষরে রূপান্তর করে ব্যবহৃত হয়।মূল পাথের পরে যেকোনো অতিরিক্ত রিসোর্স ইউআরএল থাকে। ক্লায়েন্টরা আপনার এপিআই প্রক্সি কল করার জন্য যে সম্পূর্ণ ইউআরএল কাঠামোটি ব্যবহার করবে তা নিচে দেওয়া হলো:
https://[host]/ base_path / conditional_flow_pathদ্রষ্টব্য : বেস পাথ অবশ্যই অনন্য হতে হবে; আপনি একই বেস পাথ দিয়ে দুটি এপিআই প্রক্সি স্থাপন করতে পারবেন না। আপনি যদি একটি স্থাপন করা এপিআই প্রক্সি সম্পাদনা করেন এবং এর বেস পাথ অন্য একটি এপিআই প্রক্সির বেস পাথের সমান করে দেন, তাহলে আপনি এটি সংরক্ষণ করার সময় Edge স্বয়ংক্রিয়ভাবে এপিআই প্রক্সিটি অস্থাপন করে দেবে। এপিআই প্রক্সিটি পুনরায় স্থাপন করার আগে, আপনাকে অবশ্যই বেস পাথটি সম্পাদনা করে অনন্য করতে হবে।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করুন
আপনার এপিআই প্রক্সিগুলোকে ভবিষ্যৎ-প্রস্তুত করতে এপিআই প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন। উদাহরণস্বরূপ,/team/*/membersএর মতো একটি বেস পাথ ক্লায়েন্টদেরকেhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার সুযোগ দেয়, যার ফলে নতুন টিমগুলোকে সাপোর্ট করার জন্য আপনাকে নতুন এপিআই প্রক্সি তৈরি করতে হয় না। উল্লেখ্য যে/**/সমর্থিত নয়।বর্ণনা (ঐচ্ছিক) এপিআই-এর বিবরণ। - পরবর্তী ধাপে যান।
- উইজার্ডের কমন পলিসি পেজে নিম্নলিখিত বিষয়গুলো কনফিগার করুন:
- নিরাপত্তা: অনুমোদন- এর অধীনে নিরাপত্তা অনুমোদনের প্রয়োজনীয়তা। নিরাপত্তা যোগ করা দেখুন।
- সিকিউরিটি: ব্রাউজার-এর অধীনে ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সাপোর্ট। CORS-এর জন্য সাপোর্ট যোগ করা দেখুন।
- আপনার ব্যাকএন্ড সার্ভিসকে উচ্চ ট্র্যাফিক থেকে সুরক্ষিত রাখতে কোটা ব্যবহার করুন। কোটা দেখুন । (পাস-থ্রু অথরাইজেশন নির্বাচন করা থাকলে এটি উপলব্ধ নয়।)
- WSDL অপারেশন পৃষ্ঠায়, API প্রক্সি টাইপ হিসেবে REST to SOAP to REST নির্বাচন করুন।
WSDL ফাইলটিতে Edge যে অপারেশনগুলো "আবিষ্কার" করেছে, তার একটি তালিকা সহ একটি টেবিল প্রদর্শিত হয়। আপনি আপনার API প্রক্সিতে কোন অপারেশনগুলো অন্তর্ভুক্ত করতে চান, তা নির্বাচন ও কনফিগার করতে পারেন। টেবিলটি নিম্নলিখিত চিত্রে দেখানো হয়েছে।
- আপনি কোন ধরনের অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ এলিমেন্টগুলো সেই অপারেশনগুলোকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব সার্ভিসে কল করতে পারেন।
- ঐচ্ছিকভাবে কোনো অপারেশনের জন্য REST API পাথ পরিবর্তন করুন। এই পাথটি API প্রক্সি URL-এ রিসোর্স নেম হিসেবে ব্যবহৃত হবে।
- ঐচ্ছিকভাবে অপারেশনটির সাথে যুক্ত ভার্ব (HTTP মেথড) পরিবর্তন করুন।
- পরবর্তী ধাপে যান।
- উইজার্ডের ভার্চুয়াল হোস্ট পেজে, সেই ভার্চুয়াল হোস্টগুলো নির্বাচন করুন যেগুলোর সাথে এপিআই প্রক্সি ডেপ্লয় করার সময় বাইন্ড হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- পরবর্তী ধাপে যান।
- ডেপ্লয়মেন্ট এনভায়রনমেন্ট(গুলি) নির্বাচন করুন এবং তৈরি ও ডেপ্লয়-এ ক্লিক করুন।
আপনার নতুন এপিআই প্রক্সিটি তৈরি করে নির্বাচিত পরিবেশে স্থাপন করা হয়েছে। - এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে ‘এডিট প্রক্সি’-তে ক্লিক করুন।
ক্লাসিক এজ (প্রাইভেট ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবার জন্য একটি RESTful API প্রক্সি তৈরি করতে:
-
http:// ms-ip :9000এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম। - উপরের নেভিগেশন বারে APIs > API Proxys নির্বাচন করুন।
- ক্লিক করুন + এপিআই প্রক্সি ।
- বিল্ড এ প্রক্সি উইজার্ডে, SOAP সার্ভিস নির্বাচন করুন।
- পরবর্তী ধাপে যান।
- Details পেজে এই নির্বাচনগুলো করুন। একটি WSDL নির্বাচন করার পর আপনাকে অবশ্যই Validate-এ ক্লিক করতে হবে।
এই ক্ষেত্রে এটা করুন WSDL WSDL-এর উৎস নির্বাচন করুন।
- URL - আপনি যে WSDL-টি ব্যবহার করতে চান, তার URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেম থেকে একটি WSDL ফাইল বেছে নিন। অতিরিক্ত নির্ভরশীল ফাইল থাকলে, আপনি সবগুলোই নির্বাচন করতে পারেন।
- উদাহরণ ইউআরএল - সর্বজনীনভাবে উপলব্ধ ওয়েব পরিষেবাগুলির WSDL-এর তালিকা থেকে নির্বাচন করুন। Edge-এর SOAP/API প্রক্সি বৈশিষ্ট্যগুলি পরীক্ষা করার জন্য এগুলি বেশ সুবিধাজনক।
প্রক্সি নাম এটি আপনার তৈরি করা প্রক্সির নাম।
প্রক্সি বেস পাথ আপনার এপিআই প্রক্সির http(s)://[host] ঠিকানার পরে যে URI অংশটি দেখা যায়। Edge আগত অনুরোধ বার্তাগুলিকে সঠিক এপিআই প্রক্সিতে মেলানোর এবং পাঠানোর জন্য বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : এপিআই প্রক্সি বেস পাথ ডিফল্টরূপে
Nameফিল্ডে নির্দিষ্ট করা মানটিকে সম্পূর্ণ ছোট হাতের অক্ষরে রূপান্তর করে ব্যবহৃত হয়।মূল পাথের পরে যেকোনো অতিরিক্ত রিসোর্স ইউআরএল থাকে। ক্লায়েন্টরা আপনার এপিআই প্রক্সি কল করার জন্য যে সম্পূর্ণ ইউআরএল কাঠামোটি ব্যবহার করবে তা নিচে দেওয়া হলো:
https://[host]/ base_path / conditional_flow_pathদ্রষ্টব্য : বেস পাথ অবশ্যই অনন্য হতে হবে; আপনি একই বেস পাথ দিয়ে দুটি এপিআই প্রক্সি স্থাপন করতে পারবেন না। আপনি যদি একটি স্থাপন করা এপিআই প্রক্সি সম্পাদনা করেন এবং এর বেস পাথ অন্য একটি এপিআই প্রক্সির বেস পাথের সমান করে দেন, তাহলে আপনি যখন এটি সংরক্ষণ করবেন, Edge স্বয়ংক্রিয়ভাবে এপিআই প্রক্সিটি অস্থাপন করে দেবে। এপিআই প্রক্সিটি পুনরায় স্থাপন করার আগে, আপনাকে অবশ্যই বেস পাথটি সম্পাদনা করে অনন্য করতে হবে।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করুন
আপনার এপিআই প্রক্সিগুলোকে ভবিষ্যৎ-প্রস্তুত করতে এপিআই প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন। উদাহরণস্বরূপ,/team/*/membersএর মতো একটি বেস পাথ ক্লায়েন্টদেরকেhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার সুযোগ দেয়, যার ফলে নতুন টিমগুলোকে সাপোর্ট করার জন্য আপনাকে নতুন এপিআই প্রক্সি তৈরি করতে হয় না। উল্লেখ্য যে/**/সমর্থিত নয়।বর্ণনা প্রক্সির একটি সংক্ষিপ্ত বিবরণ। - পরবর্তী ধাপে যান।
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ হিসেবে REST to SOAP to REST নির্বাচন করুন।
WSDL ফাইলটিতে Edge যে অপারেশনগুলো "আবিষ্কার" করেছে, তার একটি তালিকা সহ একটি টেবিল প্রদর্শিত হয়। আপনি আপনার API প্রক্সিতে কোন অপারেশনগুলো অন্তর্ভুক্ত করতে চান, তা নির্বাচন ও কনফিগার করতে পারেন। টেবিলটি নিম্নলিখিত চিত্রে দেখানো হয়েছে।
- পোর্ট টাইপ কলাম থেকে আপনি কোন ধরনের অপারেশন ব্যবহার করতে চান তা নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ এলিমেন্টগুলো সেই অপারেশনগুলোকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব সার্ভিসে কল করতে পারেন।
- ঐচ্ছিকভাবে অপারেশনটির সাথে যুক্ত HTTP মেথডটি পরিবর্তন করুন।
দ্রষ্টব্য: প্রতিটি অপারেশনের জন্য কোন HTTP মেথড ব্যবহার করা হবে তা নির্ধারণ করতে Edge একটি 'সেরা অনুমান' করে। সাধারণত GET-কেই বেশি পছন্দ করা হয়, কারণ GET রিকোয়েস্ট ক্যাশ করা যায়। - ঐচ্ছিকভাবে কোনো অপারেশনের জন্য REST API পাথ পরিবর্তন করুন। এই পাথটি API প্রক্সি URL-এ রিসোর্স নেম হিসেবে ব্যবহৃত হবে।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট এবং ডেপ্লয়মেন্ট এনভায়রনমেন্ট নির্বাচন করতে উইজার্ডের বাকি ধাপগুলোতে ক্লিক করুন।
- বিল্ড পেজে, বিল্ড অ্যান্ড ডিপ্লয়- এ ক্লিক করুন। Edge, WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সিটি তৈরি ও ডিপ্লয় করে।
- নতুন এপিআই প্রক্সির সারাংশ পৃষ্ঠায় যান। লক্ষ্য করুন যে, WSDL ফাইলে আবিষ্কৃত অপারেশনগুলোর উপর ভিত্তি করে এক সেট রিসোর্স তৈরি করা হয়েছে।
প্রক্সির ওভারভিউ পৃষ্ঠায়, রিসোর্স তালিকাটি নতুন এপিআই, এর অপারেশন এবং প্যারামিটারগুলির একটি বিশদ বিবরণ প্রদান করে। আপনি এই উপস্থাপনাটিকে এপিআই-এর রেফারেন্স ডকুমেন্টেশন হিসেবে ভাবতে পারেন। Edge আপনার জন্য স্বয়ংক্রিয়ভাবে এপিআই মডেলের এই ভিউটি তৈরি করে। এর বিবরণ এবং পাথের তথ্য দেখতে কেবল একটি রিসোর্স প্রসারিত করুন।
চূড়ান্ত প্রক্সি সম্পর্কে
Edge যখন একটি WSDL-এর উপর ভিত্তি করে একটি API প্রক্সি তৈরি করে, তখন সেই প্রক্সিটি আসলে একটি জটিল ফ্লো হয়, যাতে ডেটা রূপান্তর, ভেরিয়েবল এক্সট্র্যাক্ট ও সেট করা, মেসেজ ম্যানিপুলেট করা এবং আরও অনেক কিছুর জন্য পলিসি অন্তর্ভুক্ত থাকে। একটি WSDL-এর উপর ভিত্তি করে প্রক্সি তৈরি করার পর, API ম্যানেজমেন্ট UI-এর Develop ভিউতে তৈরি হওয়া ফ্লো-টি দেখুন। সেখানে আপনি দেখতে পাবেন ঠিক কোন কোন পলিসি যোগ করা হয়েছে।
উদাহরণস্বরূপ, অনুরোধের দিকে, টার্গেট ইউআরএল সেট করার জন্য একটি AssignMessage পলিসি ব্যবহার করা হয়। প্রতিক্রিয়ার দিকে, প্রতিক্রিয়াটিকে XML থেকে JSON-এ রূপান্তর করতে, প্রতিক্রিয়ার SOAP বডি অংশটিকে একটি ভেরিয়েবলে বের করে আনতে এবং প্রতিক্রিয়ার বার্তা সেট করতে পলিসিগুলো কার্যকর হয়। আপনি যখন প্রক্সি তৈরি করেন, তখন এই পলিসিগুলো (এবং অন্যান্য) স্বয়ংক্রিয়ভাবে যুক্ত হয়ে যায়।
ওপেনএপিআই স্পেক : এই প্রক্সির জন্য স্বয়ংক্রিয়ভাবে তৈরি ওপেনএপিআই স্পেক দেখতে, http(s)://[proxy_domain]/[proxy_base_path]/openapi.json যান। তবে, এই রূপান্তরটি সবসময় নির্ভুল হয় না, কারণ একটি এক্সএমএল স্কিমার সমস্ত নিয়ম একটি ওপেনএপিআই স্পেকে উপস্থাপন করা সম্ভব নয়।
SOAP-ভিত্তিক পরিষেবাতে একটি পাস-থ্রু প্রক্সি তৈরি করা
এই বিভাগে 'Create New Proxy' ডায়ালগে 'Pass-Through Proxy' বিকল্পটি ব্যবহার করে কীভাবে একটি পাস-থ্রু প্রক্সি তৈরি করতে হয় তা ব্যাখ্যা করা হয়েছে।
সংক্ষিপ্ত বিবরণ
পাস-থ্রু প্রক্সি অপশনটি আপনাকে এমন একটি প্রক্সি তৈরি করার সুযোগ দেয়, যা কোনো অনুরোধের SOAP মেসেজকে অপরিবর্তিত অবস্থায় ব্যাকএন্ড সার্ভিসে পাঠিয়ে দেয়। এর ফলে SOAP-ভিত্তিক ওয়েব সার্ভিসের জন্য প্রক্সি তৈরি করা অত্যন্ত সহজ হয়ে যায়। নেপথ্যে, Edge আপনার জন্য যেকোনো রূপান্তর এবং অন্যান্য ফ্লো অ্যাক্টিভিটি স্বয়ংক্রিয়ভাবে পরিচালনা করে। উদাহরণস্বরূপ, যদি অনুরোধটি JSON ফরম্যাটে থাকে, তবে সার্ভিসে POST করার আগে Edge সেটিকে সঠিক নেমস্পেসসহ একটি বৈধ XML SOAP মেসেজে রূপান্তর করার পদক্ষেপ নেয়। একইভাবে, যখন সার্ভিসটি একটি XML-ভিত্তিক SOAP রেসপন্স ফেরত দেয়, তখন Edge সেটিকে ক্লায়েন্টের কাছে ফেরত পাঠানোর আগে পুনরায় JSON-এ অনুবাদ করে। এছাড়াও, Edge ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট আপ করে, যা প্রতিটি SOAP অপারেশনের জন্য ভিন্ন হতে পারে।
এই ধরনের প্রক্সির জন্য, Edge WSDL-টি হোস্ট করে এবং আপনাকে এটি অ্যাক্সেস করার সুযোগ দিতে প্রক্সিতে একটি ফ্লো তৈরি করে। এই Edge-হোস্টেড WSDL-এর ঠিকানা, http(s)://[proxy_domain]/[proxy_base_path]?wsdl , প্রক্সির মাধ্যমে SOAP সার্ভিস কল করা ক্লায়েন্টদের জন্য নতুন সার্ভিস এন্ডপয়েন্ট URL হয়ে যায়।
প্রাথমিক পদক্ষেপ
প্রান্ত
Edge UI ব্যবহার করে একটি SOAP-ভিত্তিক পরিষেবার জন্য পাস-থ্রু প্রক্সি তৈরি করতে:
- apigee.com/edge- এ সাইন ইন করুন।
- বাম দিকের নেভিগেশন বার থেকে Develop > API Proxys নির্বাচন করুন।
- +প্রক্সি-তে ক্লিক করুন।
- SOAP পরিষেবাতে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায় WSDL-এর বিবরণ প্রদান করুন।
মাঠ বর্ণনা WSDL WSDL-এর উৎস নির্বাচন করুন।
- ওয়েব ঠিকানা (URL) থেকে - WSDL-এর URL-টি লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার লোকাল ডিরেক্টরি থেকে একটি WSDL ফাইল আপলোড করুন। যদি কোনো নির্ভরশীলতা থাকে, তবে আপনি একাধিক ফাইল আপলোড করতে পারেন।
নাম এপিআই প্রক্সির নাম।
মূল পথ আপনার এপিআই প্রক্সির http(s)://[host] ঠিকানার পরের URI খণ্ডাংশ। Edge আগত অনুরোধ বার্তাগুলিকে সঠিক এপিআই প্রক্সিতে মেলানোর এবং পাঠানোর জন্য বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : এপিআই ভার্সনিং বিষয়ে Apigee-এর সুপারিশের জন্য, "Web API Design: The Missing Link " ই-বুকের " Versioning " অংশটি দেখুন।
বেস পাথের পরে যেকোনো অতিরিক্ত রিসোর্স ইউআরএল থাকে। ক্লায়েন্টরা আপনার এপিআই প্রক্সি কল করার জন্য যে সম্পূর্ণ ইউআরএল কাঠামোটি ব্যবহার করবে তা নিচে দেওয়া হলো:
https://[host]/ base_path /conditional_flow_pathদ্রষ্টব্য : বেস পাথ অবশ্যই অনন্য হতে হবে। আপনি যদি পরবর্তীতে এই প্রক্সিটি সম্পাদনা করেন এবং এর বেস পাথ অন্য কোনো এপিআই প্রক্সির বেস পাথের সমান করে দেন, তাহলে এটি সংরক্ষণ করার সাথে সাথে এপিআই প্রক্সিটি স্বয়ংক্রিয়ভাবে আনডিপ্লয় হয়ে যাবে। পুনরায় ডিপ্লয় করার আগে আপনাকে অবশ্যই বেস পাথটি সম্পাদনা করতে হবে।
বেস পাথে ওয়াইল্ডকার্ড ব্যবহার করা
আপনার প্রক্সিগুলোকে ভবিষ্যৎ-প্রস্তুত করার জন্য আপনি এপিআই প্রক্সি বেস পাথে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করতে পারেন। উদাহরণস্বরূপ,/team/*/membersএর মতো একটি বেস পাথ ক্লায়েন্টদেরকেhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার সুযোগ দেয়, যার ফলে নতুন টিমগুলোকে সাপোর্ট করার জন্য আপনাকে নতুন এপিআই প্রক্সি তৈরি করতে হয় না। উল্লেখ্য যে, /**/ সমর্থিত নয়।দ্রষ্টব্য : আপনি যদি 'Base Path' ফিল্ডের বিষয়বস্তু স্পষ্টভাবে সম্পাদনা না করেন, তাহলে API প্রক্সি বেস পাথ ডিফল্টরূপে 'Name' ফিল্ডে নির্দিষ্ট করা মানটিকে সম্পূর্ণ ছোট হাতের অক্ষরে রূপান্তরিত করে ব্যবহৃত হবে।
বর্ণনা (ঐচ্ছিক) এপিআই-এর বিবরণ। - পরবর্তী ধাপে যান।
- উইজার্ডের কমন পলিসি পেজে নিম্নলিখিত বিষয়গুলো কনফিগার করুন:
- নিরাপত্তা অনুমোদনের আবশ্যকতা। নিরাপত্তা যোগ করা দেখুন।
- ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সমর্থন। CORS-এর জন্য সমর্থন যোগ করা দেখুন।
- আপনার ব্যাকএন্ড পরিষেবাটিকে অতিরিক্ত ট্র্যাফিক থেকে সুরক্ষিত রাখার জন্য কোটা। কোটা দেখুন। (পাস-থ্রু অথরাইজেশন নির্বাচন করা থাকলে এটি উপলব্ধ নয়।)
- মনিটাইজেশন-সক্ষম সংস্থাগুলির জন্য মনিটাইজেশন সীমা প্রয়োগ। এপিআই প্রক্সিগুলিতে মনিটাইজেশন সীমা প্রয়োগ দেখুন।
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ হিসেবে Pass-Through SOAP নির্বাচন করুন।
- আপনি কোন ধরনের অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ এলিমেন্টগুলো সেই অপারেশনগুলোকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব সার্ভিসে কল করতে পারেন।
- পরবর্তী ধাপে যান।
- উইজার্ডের ভার্চুয়াল হোস্ট পেজে, সেই ভার্চুয়াল হোস্টগুলো নির্বাচন করুন যেগুলোর সাথে এপিআই প্রক্সি ডেপ্লয় করার সময় বাইন্ড হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- ডেপ্লয়মেন্ট এনভায়রনমেন্ট(গুলি) নির্বাচন করুন এবং তৈরি ও ডেপ্লয়-এ ক্লিক করুন।
আপনার নতুন এপিআই প্রক্সিটি তৈরি করে নির্বাচিত পরিবেশে স্থাপন করা হয়েছে। - এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে ‘এডিট প্রক্সি’-তে ক্লিক করুন।
ক্লাসিক এজ (প্রাইভেট ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে একটি SOAP-ভিত্তিক পরিষেবার জন্য পাস-থ্রু প্রক্সি তৈরি করতে:
-
http:// ms-ip :9000এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম। - উপরের নেভিগেশন বারে APIs > API Proxys নির্বাচন করুন।
- ক্লিক করুন + এপিআই প্রক্সি ।
- বিল্ড এ প্রক্সি উইজার্ডে, SOAP সার্ভিস নির্বাচন করুন।
- পরবর্তী ধাপে যান।
- Details পেজে এই নির্বাচনগুলো করুন। একটি WSDL নির্বাচন করার পর আপনাকে অবশ্যই Validate-এ ক্লিক করতে হবে।
এই ক্ষেত্রে এটা করুন WSDL WSDL-এর উৎস নির্বাচন করুন।
- URL - আপনি যে WSDL-টি ব্যবহার করতে চান, তার URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেম থেকে একটি WSDL ফাইল বেছে নিন। অতিরিক্ত নির্ভরশীল ফাইল থাকলে, আপনি সবগুলোই নির্বাচন করতে পারেন।
- উদাহরণ ইউআরএল - সর্বজনীনভাবে উপলব্ধ ওয়েব পরিষেবাগুলির WSDL-এর তালিকা থেকে নির্বাচন করুন। Edge-এর SOAP/API প্রক্সি বৈশিষ্ট্যগুলি পরীক্ষা করার জন্য এগুলি বেশ সুবিধাজনক।
প্রক্সি নাম এটি আপনার তৈরি করা প্রক্সির নাম।
প্রক্সি বেস পাথ প্রক্সি বেস পাথ হলো একটি URI খণ্ডাংশ যা এই API প্রক্সি দ্বারা উন্মুক্ত করা API-টিকে অনন্যভাবে শনাক্ত করে। API সার্ভিসেস আগত অনুরোধ বার্তাগুলোকে সঠিক API প্রক্সিতে মেলানো এবং পাঠানোর জন্য বেস পাথ URI ব্যবহার করে। (বেস পাথটি API-এর ডোমেইনের সাথে যুক্ত করা হয়, যা আপনার প্রতিষ্ঠানের নাম এবং যে পরিবেশে API প্রক্সিটি স্থাপন করা হয়েছে তার উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে তৈরি হয়।) প্রজেক্টের নামে একটি ভার্সন নম্বর অন্তর্ভুক্ত করা একটি উত্তম অভ্যাস, যেমন, /v1/delayedstockquote। এটি নির্ধারণ করবে যে গ্রাহক অ্যাপগুলো আপনার API-কে কীভাবে আহ্বান করবে।দ্রষ্টব্য : আপনি যদি প্রক্সি বেস পাথ ফিল্ডের বিষয়বস্তু স্পষ্টভাবে সম্পাদনা না করেন, তাহলে প্রক্সি বেস পাথ ডিফল্টরূপে প্রক্সি নেমের জন্য নির্দিষ্ট করা মানটিকেই সম্পূর্ণ ছোট হাতের অক্ষরে রূপান্তর করে নেবে।
বর্ণনা প্রক্সির একটি সংক্ষিপ্ত বিবরণ। - পরবর্তী ধাপে যান।
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ হিসেবে Pass-Through SOAP নির্বাচন করুন।
দ্রষ্টব্য: একটি সারণী প্রদর্শিত হয় যেখানে প্রতিটি WSDL অপারেশন এবং তার সংশ্লিষ্ট SOAP পেলোড তালিকাভুক্ত থাকে। এই পেলোডটিই ব্যাকএন্ড SOAP পরিষেবাতে "পাঠানো" হয়।
- পোর্ট টাইপ কলাম থেকে আপনি কোন ধরনের অপারেশন ব্যবহার করতে চান তা নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ এলিমেন্টগুলো সেই অপারেশনগুলোকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব সার্ভিসে কল করতে পারেন।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট এবং ডেপ্লয়মেন্ট এনভায়রনমেন্ট নির্বাচন করতে উইজার্ডের বাকি ধাপগুলোতে ক্লিক করুন।
- বিল্ড পেজে, বিল্ড অ্যান্ড ডিপ্লয়- এ ক্লিক করুন। Edge, WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সিটি তৈরি ও ডিপ্লয় করে।
চূড়ান্ত প্রক্সি সম্পর্কে
যখন Edge একটি পাস-থ্রু প্রক্সি তৈরি করে, তখন ফলস্বরূপ প্রক্সিটি আসলে একটি জটিল ফ্লো হয়, যাতে ডেটা রূপান্তর, ভেরিয়েবল এক্সট্র্যাক্ট ও সেট করা, মেসেজ ম্যানিপুলেট করা এবং আরও অনেক কিছুর জন্য পলিসি অন্তর্ভুক্ত থাকে। পাস-থ্রু প্রক্সি তৈরি করার পরে, API ম্যানেজমেন্ট UI-এর ডেভেলপ ভিউতে ফলস্বরূপ ফ্লোটি দেখুন। সেখানে, আপনি দেখতে পাবেন ঠিক কোন কোন পলিসি যোগ করা হয়েছে।
উদাহরণস্বরূপ, নিচের চিত্রটি একটি পাস-থ্রু প্রক্সির টার্গেট এন্ডপয়েন্ট প্রিফ্লো অংশটি দেখাচ্ছে। রিকোয়েস্টের দিকে, টার্গেট ইউআরএল সেট করার জন্য একটি অ্যাসাইনমেসেজ পলিসি ব্যবহার করা হয়। রেসপন্সের দিকে, রেসপন্সকে এক্সএমএল থেকে জেএসওএন-এ রূপান্তর করতে, রেসপন্সের সোপ বডি অংশটিকে একটি ভেরিয়েবলে এক্সট্র্যাক্ট করতে এবং রেসপন্স মেসেজ সেট করতে পলিসিগুলো এক্সিকিউট হয়। আপনি যখন প্রক্সি তৈরি করেন, তখন এই পলিসিগুলো (এবং অন্যান্য) স্বয়ংক্রিয়ভাবে যুক্ত হয়ে যায়।
Edge-hosted WSDL : এই ধরনের প্রক্সির জন্য তৈরি হওয়া Edge-hosted WSDL দেখতে, http(s)://[proxy_domain]/[proxy_base_path] ?wsdl যান।
উন্নত SOAP-to-REST প্রক্সি উন্নয়ন
পূর্ববর্তী বিভাগগুলিতে Edge-এর API প্রক্সি উইজার্ড ব্যবহার করে একটি SOAP-to-REST API প্রক্সি তৈরি করার পদ্ধতি আলোচনা করা হয়েছে। তবে, আপনি যদি SOAP-to-REST রূপান্তরের উপর আরও সূক্ষ্ম নিয়ন্ত্রণ চান, তাহলে আপনি উইজার্ডের দেওয়া অটোমেশনকে বাইপাস করে ম্যানুয়ালি পলিসি যোগ ও কনফিগার করার মাধ্যমে আপনার কাঙ্ক্ষিত আচরণ পেতে পারেন। আরও তথ্যের জন্য, দেখুন “টিউটোরিয়াল: Apigee Edge-এ ম্যানুয়ালি একটি SOAP-to-REST API প্রক্সি তৈরি” ।