আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
এই বিষয় ব্যাখ্যা করে কিভাবে SOAP-ভিত্তিক ওয়েব পরিষেবাগুলির জন্য API প্রক্সি তৈরি করতে হয়। আপনি এজ-এ দুই ধরনের SOAP প্রক্সি তৈরি করতে পারেন। একটি ব্যাকএন্ড SOAP পরিষেবাতে একটি RESTful ইন্টারফেস তৈরি করে এবং অন্যটি ব্যাকএন্ডে SOAP বার্তার একটি "পাস থ্রু" সঞ্চালন করে। উভয় কৌশল এই বিষয়ে বর্ণনা করা হয়.
এই ভিডিওটি API প্রক্সি উইজার্ড ব্যবহার করে Apigee Edge-এর সাথে একটি SOAP পরিষেবাকে REST পরিষেবাতে পরিণত করার একটি এন্ড-টু-এন্ড ডেমো প্রদান করে৷ যাইহোক, আপনি যদি SOAP-থেকে-REST রূপান্তরের উপর আরও নিয়ন্ত্রণ চান, আপনি নীতিগুলি ব্যবহার করে একটি প্রক্সি তৈরি করতে পারেন। আরও তথ্যের জন্য, টিউটোরিয়াল দেখুন: Apigee Edge-এ SOAP-to-REST API প্রক্সির ম্যানুয়াল নির্মাণ ।
একটি SOAP-ভিত্তিক পরিষেবাতে একটি RESTful API প্রক্সি তৈরি করা
বিল্ড এ প্রক্সি উইজার্ডে REST থেকে SOAP থেকে REST বিকল্পের সাথে কীভাবে একটি RESTful SOAP API প্রক্সি তৈরি করা যায় এই বিভাগে ব্যাখ্যা করা হয়েছে।
ওভারভিউ
REST to SOAP to REST বিকল্পটি একটি RESTful API প্রক্সি তৈরি করতে WSDL প্রক্রিয়া করে। এজ WSDL থেকে পরিষেবার সমর্থিত ক্রিয়াকলাপ, ইনপুট পরামিতি এবং আরও অনেক কিছু নির্ধারণ করে। এজ "অনুমান করে" প্রতিটি অপারেশনের জন্য কোন HTTP পদ্ধতি ব্যবহার করতে হবে। সাধারণত, এজ অপারেশনগুলিকে GET অনুরোধে অনুবাদ করে, যার ক্যাশেযোগ্য হওয়ার সুবিধা রয়েছে। এজ ব্যাকএন্ড টার্গেট এন্ডপয়েন্টও সেট আপ করে, যা প্রতি SOAP অপারেশনে পরিবর্তিত হতে পারে।
এই ধরনের প্রক্সির জন্য, এজ একটি OpenAPI স্পেসিফিকেশন স্বয়ংক্রিয়ভাবে তৈরি করে, যা আপনি API ডকুমেন্টেশন তৈরি করতে ব্যবহার করতে পারেন।
মৌলিক পদক্ষেপ
প্রান্ত
এজ UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবাতে একটি RESTful API প্রক্সি তৈরি করতে:
- apigee.com/edge এ সাইন ইন করুন।
- বাম নেভিগেশন বারে বিকাশ > API প্রক্সি নির্বাচন করুন।
- +প্রক্সিতে ক্লিক করুন।
- SOAP পরিষেবাতে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, WSDL ফাইল প্রদান করুন।
মাঠ বর্ণনা WSDL ফাইল প্রদান করুন WSDL এর উৎস নির্বাচন করুন।
- ওয়েব ঠিকানা (URL) থেকে - WSDL এর URL লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার স্থানীয় ডিরেক্টরি থেকে একটি WSDL ফাইল আপলোড করুন। নির্ভরতা থাকলে আপনি একাধিক ফাইল আপলোড করতে পারেন।
- WSDL যাচাই করতে Validate এ ক্লিক করুন।
- নিম্নলিখিত প্রক্সি বিবরণ লিখুন:
মাঠ বর্ণনা নাম আপনার API-এর জন্য নাম প্রদর্শিত হয়েছে। আলফানিউমেরিক অক্ষর, ড্যাশ (-), বা আন্ডারস্কোর (_) নির্দিষ্ট করুন। ভিত্তি পথ URI খণ্ড যা আপনার API প্রক্সির http(গুলি)://[হোস্ট] ঠিকানার পরে প্রদর্শিত হয়৷ সঠিক API প্রক্সিতে ইনকামিং রিকোয়েস্ট মেসেজ মেলে ও রুট করতে এজ বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : এপিআই প্রক্সি বেস পাথ
Nameক্ষেত্রের জন্য নির্দিষ্ট মানকে ডিফল্ট করে সব ছোট হাতের ক্ষেত্রে রূপান্তরিত হয়।বেস পাথ অনুসরণ করে অতিরিক্ত রিসোর্স ইউআরএল। ক্লায়েন্টরা আপনার API প্রক্সি কল করতে ব্যবহার করবে এমন সম্পূর্ণ URL গঠন এখানে রয়েছে:
https://[host]/ base_path / conditional_flow_pathদ্রষ্টব্য : বেস পাথ অনন্য হতে হবে; আপনি একই বেস পাথ দিয়ে দুটি API প্রক্সি স্থাপন করতে পারবেন না। আপনি যদি একটি স্থাপন করা API প্রক্সি সম্পাদনা করেন এবং বেস পাথটিকে অন্য এপিআই প্রক্সির বেস পাথের মতো একই মান সেট করেন, আপনি যখন এটি সংরক্ষণ করেন তখন এজ স্বয়ংক্রিয়ভাবে API প্রক্সিটিকে আনডিপ্লোয় করে দেয়। আপনি API প্রক্সি পুনরায় স্থাপন করার আগে, আপনাকে বেস পাথ সম্পাদনা করতে হবে যাতে এটি অনন্য হয়।
বেস পাথগুলিতে ওয়াইল্ডকার্ড ব্যবহার করুন
আপনার API প্রক্সিগুলিকে ভবিষ্যত প্রমাণ করতে API প্রক্সি বেস পাথগুলিতে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন৷ উদাহরণস্বরূপ,/team/*/membersএর একটি বেস পাথ ক্লায়েন্টদেরhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার অনুমতি দেয় আপনাকে নতুন তৈরি করার প্রয়োজন ছাড়াই নতুন দলকে সমর্থন করার জন্য API প্রক্সি। নোট করুন যে/**/সমর্থিত নয়।বর্ণনা (ঐচ্ছিক) API-এর বিবরণ। - পরবর্তী ক্লিক করুন.
- উইজার্ডের সাধারণ নীতি পৃষ্ঠায়, নিম্নলিখিতগুলি কনফিগার করুন:
- নিরাপত্তার অধীনে নিরাপত্তা অনুমোদনের প্রয়োজনীয়তা: অনুমোদন । নিরাপত্তা যোগ করা দেখুন।
- নিরাপত্তার অধীনে ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সমর্থন: ব্রাউজার । CORS-এর জন্য সমর্থন যোগ করা দেখুন।
- কোটার অধীনে উচ্চ ট্রাফিক থেকে আপনার ব্যাকএন্ড পরিষেবাকে রক্ষা করার জন্য কোটা। কোটা দেখুন। (পাস-থ্রু অনুমোদন নির্বাচন করা থাকলে উপলব্ধ নয়।)
- WSDL অপারেশন পৃষ্ঠায়, API প্রক্সি টাইপ REST থেকে SOAP থেকে REST নির্বাচন করুন।
ডাব্লুএসডিএল ফাইলে এজ "আবিষ্কৃত" ক্রিয়াকলাপগুলির তালিকা করে একটি টেবিল উপস্থিত হয়। আপনি আপনার API প্রক্সিতে কোন ক্রিয়াকলাপগুলিকে অন্তর্ভুক্ত করতে চান তা নির্বাচন এবং কনফিগার করতে পারেন৷ টেবিলটি নিম্নলিখিত চিত্রে দেখানো হয়েছে।
- আপনি কোন সেট অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ উপাদানগুলি এমন অপারেশনগুলিকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব পরিষেবাতে কল করতে পারেন।
- ঐচ্ছিকভাবে একটি অপারেশনের জন্য REST API পাথ পরিবর্তন করুন। এপিআই প্রক্সি ইউআরএলে রিসোর্স নাম হিসেবে পাথ ব্যবহার করা হবে।
- ঐচ্ছিকভাবে অপারেশনের সাথে যুক্ত Verb (HTTP পদ্ধতি) পরিবর্তন করুন।
- পরবর্তী ক্লিক করুন.
- উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, ভার্চুয়াল হোস্ট নির্বাচন করুন যেগুলি মোতায়েন করার সময় API প্রক্সি আবদ্ধ হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- পরবর্তী ক্লিক করুন.
- স্থাপনার পরিবেশ(গুলি) নির্বাচন করুন এবং তৈরি করুন এবং স্থাপন করুন ক্লিক করুন
আপনার নতুন API প্রক্সি তৈরি করা হয়েছে এবং নির্বাচিত পরিবেশে স্থাপন করা হয়েছে। - API প্রক্সির বিবরণ পৃষ্ঠা প্রদর্শন করতে প্রক্সি সম্পাদনা করুন ক্লিক করুন।
ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে SOAP-ভিত্তিক পরিষেবাতে একটি RESTful API প্রক্সি তৈরি করতে:
-
http:// ms-ip :9000এ সাইন ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP ঠিকানা বা DNS নাম। - শীর্ষ নেভিগেশন বারে APIs > API প্রক্সি নির্বাচন করুন।
- + API প্রক্সিতে ক্লিক করুন।
- বিল্ড এ প্রক্সি উইজার্ডে, SOAP পরিষেবা নির্বাচন করুন।
- পরবর্তী ক্লিক করুন.
- বিশদ পৃষ্ঠায়, এই নির্বাচনগুলি করুন। একটি WSDL নির্বাচন করার পর আপনাকে অবশ্যই ভ্যালিডেট ক্লিক করতে হবে।
এই মাঠে এটা করো ডব্লিউএসডিএল WSDL এর উৎস নির্বাচন করুন।
- URL - আপনি যে WSDL ব্যবহার করতে চান তার URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেমে একটি WSDL ফাইল চয়ন করুন। যে ক্ষেত্রে অতিরিক্ত নির্ভরশীল ফাইল আছে, আপনি তাদের সব নির্বাচন করতে পারেন।
- উদাহরণ URL - সর্বজনীনভাবে উপলব্ধ ওয়েব পরিষেবাগুলির জন্য WSDL-এর একটি তালিকা থেকে নির্বাচন করুন। এজ এর SOAP/API প্রক্সি বৈশিষ্ট্যগুলি চেষ্টা করার জন্য এটি কার্যকর।
প্রক্সি নাম এটি আপনি যে প্রক্সি তৈরি করছেন তার নাম।
প্রক্সি বেস পাথ URI খণ্ড যা আপনার API প্রক্সির http(গুলি)://[হোস্ট] ঠিকানার পরে প্রদর্শিত হয়৷ সঠিক API প্রক্সিতে ইনকামিং রিকোয়েস্ট মেসেজ মেলে ও রুট করতে এজ বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : এপিআই প্রক্সি বেস পাথ সমস্ত ছোট হাতের ক্ষেত্রে রূপান্তরিত
Nameক্ষেত্রের জন্য নির্দিষ্ট করা মানকে ডিফল্ট করে।বেস পাথ অনুসরণ করে অতিরিক্ত রিসোর্স ইউআরএল। ক্লায়েন্টরা আপনার API প্রক্সি কল করতে ব্যবহার করবে এমন সম্পূর্ণ URL গঠন এখানে রয়েছে:
https://[host]/ base_path / conditional_flow_pathদ্রষ্টব্য : বেস পাথ অনন্য হতে হবে; আপনি একই বেস পাথ দিয়ে দুটি API প্রক্সি স্থাপন করতে পারবেন না। আপনি যদি একটি স্থাপন করা API প্রক্সি সম্পাদনা করেন এবং বেস পাথটিকে অন্য এপিআই প্রক্সির বেস পাথের মতো একই মান সেট করেন, আপনি যখন এটি সংরক্ষণ করেন তখন এজ স্বয়ংক্রিয়ভাবে API প্রক্সিটিকে আনডিপ্লোয় করে দেয়। আপনি API প্রক্সি পুনরায় স্থাপন করার আগে, আপনাকে বেস পাথ সম্পাদনা করতে হবে যাতে এটি অনন্য হয়।
বেস পাথগুলিতে ওয়াইল্ডকার্ড ব্যবহার করুন
আপনার API প্রক্সিগুলিকে ভবিষ্যত প্রমাণ করতে API প্রক্সি বেস পাথগুলিতে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করুন৷ উদাহরণস্বরূপ,/team/*/membersএর একটি বেস পাথ ক্লায়েন্টদেরhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার অনুমতি দেয় আপনাকে নতুন তৈরি করার প্রয়োজন ছাড়াই নতুন দলকে সমর্থন করার জন্য API প্রক্সি। নোট করুন যে/**/সমর্থিত নয়।বর্ণনা প্রক্সি একটি সংক্ষিপ্ত বিবরণ. - পরবর্তী ক্লিক করুন.
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ REST থেকে SOAP থেকে REST নির্বাচন করুন।
ডাব্লুএসডিএল ফাইলে এজ "আবিষ্কৃত" ক্রিয়াকলাপগুলির তালিকা করে একটি টেবিল উপস্থিত হয়। আপনি আপনার API প্রক্সিতে কোন ক্রিয়াকলাপগুলিকে অন্তর্ভুক্ত করতে চান তা নির্বাচন এবং কনফিগার করতে পারেন৷ টেবিলটি নিম্নলিখিত চিত্রে দেখানো হয়েছে।
- পোর্ট টাইপ কলাম থেকে নির্বাচন করুন কোন সেট অপারেশন আপনি ব্যবহার করতে চান। WSDL-এ, পোর্ট টাইপ উপাদানগুলি এমন অপারেশনগুলিকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব পরিষেবাতে কল করতে পারেন।
- ঐচ্ছিকভাবে অপারেশনের সাথে যুক্ত HTTP পদ্ধতি পরিবর্তন করুন।
দ্রষ্টব্য: প্রতিটি ক্রিয়াকলাপের জন্য ব্যবহার করার জন্য HTTP পদ্ধতি নির্ধারণে Edge একটি "সর্বোত্তম অনুমান" করে। GET সাধারণত পছন্দ করা হয় কারণ GET অনুরোধগুলি ক্যাশে করা যেতে পারে। - ঐচ্ছিকভাবে একটি অপারেশনের জন্য REST API পাথ পরিবর্তন করুন। এপিআই প্রক্সি ইউআরএলে রিসোর্স নাম হিসেবে পাথ ব্যবহার করা হবে।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট নির্বাচন এবং স্থাপনার পরিবেশের জন্য বাকি উইজার্ডের মাধ্যমে ক্লিক করুন।
- বিল্ড পৃষ্ঠায়, বিল্ড এবং ডিপ্লোয় ক্লিক করুন। এজ WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সি তৈরি করে এবং স্থাপন করে।
- নতুন API প্রক্সির জন্য সারাংশ পৃষ্ঠায় যান। উল্লেখ্য যে WSDL ফাইলে আবিষ্কৃত ক্রিয়াকলাপগুলির উপর ভিত্তি করে সংস্থানগুলির একটি সেট তৈরি করা হয়েছে।
প্রক্সির ওভারভিউ পৃষ্ঠায়, সম্পদ তালিকা নতুন API, এর ক্রিয়াকলাপ এবং পরামিতিগুলির একটি বিশদ বিবরণ প্রদান করে। আপনি API এর রেফারেন্স ডকুমেন্টেশন হিসাবে এই উপস্থাপনা মনে করতে পারেন. এজ আপনার জন্য স্বয়ংক্রিয়ভাবে API মডেলের এই ভিউ তৈরি করে। শুধুমাত্র একটি সম্পদের বিবরণ এবং পথের তথ্য দেখতে প্রসারিত করুন।
চূড়ান্ত প্রক্সি সম্পর্কে
যখন এজ একটি WSDL-এর উপর ভিত্তি করে একটি API প্রক্সি তৈরি করে, ফলে প্রক্সিটি আসলে একটি জটিল প্রবাহ যা ডেটা রূপান্তর, ভেরিয়েবল বের করা এবং সেট করা, ম্যানিপুলেট বার্তা এবং আরও অনেক কিছুর নীতি অন্তর্ভুক্ত করে। আপনি একটি WSDL-এর উপর ভিত্তি করে একটি প্রক্সি তৈরি করার পরে, API ম্যানেজমেন্ট UI-এর বিকাশ দৃশ্যে ফলস্বরূপ প্রবাহটি দেখুন। সেখানে, আপনি ঠিক কোন নীতিগুলি যোগ করা হয়েছে তা দেখতে পারেন।
উদাহরণস্বরূপ, অনুরোধের দিকে, লক্ষ্য URL সেট করতে একটি AssignMessage নীতি ব্যবহার করা হয়। প্রতিক্রিয়ার দিকে, XML থেকে JSON-এ প্রতিক্রিয়া রূপান্তরিত করার জন্য নীতিগুলি কার্যকর করে, প্রতিক্রিয়ার SOAP বডি অংশটিকে একটি পরিবর্তনশীলে বের করে এবং প্রতিক্রিয়া বার্তা সেট করে। আপনি যখন প্রক্সি তৈরি করেন তখন এই নীতিগুলি (এবং অন্যান্য) স্বয়ংক্রিয়ভাবে যুক্ত হয়৷
OpenAPI Spec : এই প্রক্সিটির জন্য স্বয়ংক্রিয়ভাবে তৈরি OpenAPI স্পেক দেখতে, http(s)://[proxy_domain]/[proxy_base_path]/openapi.json দেখুন। যাইহোক, রূপান্তরটি সর্বদা সঠিক হয় না, যেহেতু একটি XML স্কিমার সমস্ত নিয়ম একটি OpenAPI স্পেকের মধ্যে উপস্থাপন করা যায় না।
একটি SOAP-ভিত্তিক পরিষেবাতে একটি পাস-থ্রু প্রক্সি তৈরি করা
নতুন প্রক্সি তৈরি করুন ডায়ালগে পাস-থ্রু প্রক্সি বিকল্পের মাধ্যমে কীভাবে একটি পাস-থ্রু প্রক্সি তৈরি করা যায় তা এই বিভাগে ব্যাখ্যা করে।
ওভারভিউ
পাস-থ্রু প্রক্সি বিকল্পটি আপনাকে একটি প্রক্সি তৈরি করতে দেয় যা ব্যাকএন্ড পরিষেবা "আনটাচড" এর অনুরোধে SOAP বার্তাটি পাস করে, এটি একটি SOAP-ভিত্তিক ওয়েব পরিষেবার জন্য একটি প্রক্সি তৈরি করা খুব সহজ করে তোলে। পর্দার আড়ালে, এজ স্বয়ংক্রিয়ভাবে আপনার জন্য যেকোনো রূপান্তর এবং অন্যান্য প্রবাহ কার্যক্রম পরিচালনা করে। উদাহরণস্বরূপ, যদি অনুরোধটি JSON ফর্ম্যাটে হয়, তবে এজ এটিকে পরিষেবাতে পোস্ট করার আগে সঠিক নামস্থান সহ একটি বৈধ XML SOAP বার্তায় রূপান্তর করার পদক্ষেপ নেয়৷ একইভাবে, যখন পরিষেবাটি একটি XML-ভিত্তিক SOAP প্রতিক্রিয়া প্রদান করে, তখন ক্লায়েন্টকে ফেরত দেওয়ার আগে এজ এটিকে JSON-এ অনুবাদ করে। উপরন্তু, এজ ব্যাকএন্ড টার্গেট এন্ডপয়েন্ট সেট আপ করে, যা SOAP অপারেশন অনুযায়ী পরিবর্তিত হতে পারে।
এই ধরনের প্রক্সির জন্য, এজ WSDL হোস্ট করে এবং প্রক্সিতে একটি প্রবাহ তৈরি করে যাতে আপনি এটি অ্যাক্সেস করতে পারেন। এই এজ-হোস্টেড WSDL-এর ঠিকানা, http(s)://[proxy_domain]/[proxy_base_path]?wsdl , প্রক্সির মাধ্যমে SOAP পরিষেবাতে কল করা ক্লায়েন্টদের জন্য নতুন পরিষেবা শেষ পয়েন্ট URL হয়ে ওঠে৷
মৌলিক পদক্ষেপ
প্রান্ত
এজ UI ব্যবহার করে একটি SOAP-ভিত্তিক পরিষেবাতে একটি পাস-থ্রু প্রক্সি তৈরি করতে:
- apigee.com/edge এ সাইন ইন করুন।
- বাম নেভিগেশন বারে বিকাশ > API প্রক্সি নির্বাচন করুন।
- +প্রক্সিতে ক্লিক করুন।
- SOAP পরিষেবাতে ক্লিক করুন।
- প্রক্সি বিবরণ পৃষ্ঠায়, WSDL বিশদ প্রদান করুন।
মাঠ বর্ণনা ডব্লিউএসডিএল WSDL এর উৎস নির্বাচন করুন।
- ওয়েব ঠিকানা (URL) থেকে - WSDL এর URL লিখুন বা পেস্ট করুন।
- আমার কম্পিউটার থেকে - আপনার স্থানীয় ডিরেক্টরি থেকে একটি WSDL ফাইল আপলোড করুন। নির্ভরতা থাকলে আপনি একাধিক ফাইল আপলোড করতে পারেন।
নাম API প্রক্সির নাম।
ভিত্তি পথ আপনার API প্রক্সির http(গুলি)://[হোস্ট] ঠিকানার পরে URI খণ্ড। সঠিক API প্রক্সিতে ইনকামিং রিকোয়েস্ট মেসেজ মেলে ও রুট করতে এজ বেস পাথ URI ব্যবহার করে।
দ্রষ্টব্য : API সংস্করণে Apigee-এর সুপারিশের জন্য, ওয়েব API ডিজাইনে সংস্করণ দেখুন : দ্য মিসিং লিঙ্ক ই-বুক।
বেস পাথের পরে কোনো অতিরিক্ত রিসোর্স URL আছে। ক্লায়েন্টরা আপনার API প্রক্সি কল করতে ব্যবহার করবে এমন সম্পূর্ণ URL গঠন এখানে রয়েছে:
https://[host]/ base_path /conditional_flow_pathদ্রষ্টব্য : মূল পথটি অবশ্যই অনন্য হতে হবে। আপনি যদি পরে এই প্রক্সিটি সম্পাদনা করেন এবং এর ভিত্তি পথটি অন্য এপিআই প্রক্সির মতো সেট করেন, আপনি যখন এটি সংরক্ষণ করেন তখন এই API প্রক্সিটি স্বয়ংক্রিয়ভাবে নিষ্ক্রিয় হয়ে যায়। আপনি এটি পুনঃনিয়োগ করার আগে আপনাকে অবশ্যই বেস পাথ সম্পাদনা করতে হবে।
বেস পাথগুলিতে একটি ওয়াইল্ডকার্ড ব্যবহার করা
আপনি আপনার প্রক্সিগুলিকে ভবিষ্যত প্রমাণ করতে API প্রক্সি বেস পাথগুলিতে এক বা একাধিক
/*/ওয়াইল্ডকার্ড ব্যবহার করতে পারেন৷ উদাহরণস্বরূপ,/team/*/membersএর একটি বেস পাথ ক্লায়েন্টদেরhttps://[host]/team/ blue /membersএবংhttps://[host]/team/ green /membersকল করার অনুমতি দেয় আপনাকে নতুন তৈরি করার প্রয়োজন ছাড়াই নতুন দলকে সমর্থন করার জন্য API প্রক্সি। নোট করুন যে /**/ সমর্থিত নয়।দ্রষ্টব্য : এপিআই প্রক্সি বেস পাথ ডিফল্ট নাম ক্ষেত্রের জন্য নির্দিষ্ট করা মানটিকে সমস্ত ছোট হাতের ক্ষেত্রে রূপান্তরিত করে যদি না আপনি বেস পাথ ক্ষেত্রের বিষয়বস্তু স্পষ্টভাবে সম্পাদনা করেন।
বর্ণনা (ঐচ্ছিক) API-এর বিবরণ। - পরবর্তী ক্লিক করুন.
- উইজার্ডের সাধারণ নীতি পৃষ্ঠায়, নিম্নলিখিতগুলি কনফিগার করুন:
- নিরাপত্তা অনুমোদনের প্রয়োজনীয়তা। নিরাপত্তা যোগ করা দেখুন।
- ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS) এর জন্য সমর্থন। CORS-এর জন্য সমর্থন যোগ করা দেখুন।
- উচ্চ ট্রাফিক থেকে আপনার ব্যাকএন্ড পরিষেবা রক্ষা করার জন্য কোটা। কোটা দেখুন। (পাস-থ্রু অনুমোদন নির্বাচন করা থাকলে উপলব্ধ নয়।)
- নগদীকরণ-সক্ষম প্রতিষ্ঠানের জন্য নগদীকরণ সীমা প্রয়োগ। এপিআই প্রক্সিগুলিতে নগদীকরণের সীমা প্রয়োগ করুন দেখুন।
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ Pass-through SOAP নির্বাচন করুন।
- আপনি কোন সেট অপারেশন ব্যবহার করতে চান তা নির্দিষ্ট করতে ড্রপ-ডাউন থেকে একটি পোর্ট টাইপ নির্বাচন করুন। WSDL-এ, পোর্ট টাইপ উপাদানগুলি এমন অপারেশনগুলিকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব পরিষেবাতে কল করতে পারেন।
- পরবর্তী ক্লিক করুন.
- উইজার্ডের ভার্চুয়াল হোস্ট পৃষ্ঠায়, ভার্চুয়াল হোস্ট নির্বাচন করুন যেগুলি মোতায়েন করার সময় API প্রক্সি আবদ্ধ হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
- স্থাপনার পরিবেশ(গুলি) নির্বাচন করুন এবং তৈরি করুন এবং স্থাপন করুন ক্লিক করুন
আপনার নতুন API প্রক্সি তৈরি করা হয়েছে এবং নির্বাচিত পরিবেশে স্থাপন করা হয়েছে৷ - API প্রক্সির বিবরণ পৃষ্ঠা প্রদর্শন করতে প্রক্সি সম্পাদনা করুন ক্লিক করুন।
ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে একটি SOAP-ভিত্তিক পরিষেবাতে একটি পাস-থ্রু প্রক্সি তৈরি করতে:
-
http:// ms-ip :9000এ সাইন ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP ঠিকানা বা DNS নাম। - শীর্ষ নেভিগেশন বারে APIs > API প্রক্সি নির্বাচন করুন।
- + API প্রক্সিতে ক্লিক করুন।
- বিল্ড এ প্রক্সি উইজার্ডে, SOAP পরিষেবা নির্বাচন করুন।
- পরবর্তী ক্লিক করুন.
- বিশদ পৃষ্ঠায়, এই নির্বাচনগুলি করুন। একটি WSDL নির্বাচন করার পর আপনাকে অবশ্যই ভ্যালিডেট ক্লিক করতে হবে।
এই মাঠে এটা করো ডব্লিউএসডিএল WSDL এর উৎস নির্বাচন করুন।
- URL - আপনি যে WSDL ব্যবহার করতে চান তার URL লিখুন।
- ফাইল - আপনার ফাইল সিস্টেমে একটি WSDL ফাইল চয়ন করুন। যে ক্ষেত্রে অতিরিক্ত নির্ভরশীল ফাইল আছে, আপনি তাদের সব নির্বাচন করতে পারেন।
- উদাহরণ URL - সর্বজনীনভাবে উপলব্ধ ওয়েব পরিষেবাগুলির জন্য WSDL-এর একটি তালিকা থেকে নির্বাচন করুন। এজ এর SOAP/API প্রক্সি বৈশিষ্ট্যগুলি চেষ্টা করার জন্য এটি কার্যকর।
প্রক্সি নাম এটি আপনি যে প্রক্সি তৈরি করছেন তার নাম।
প্রক্সি বেস পাথ প্রক্সি বেস পাথ হল একটি URI ফ্র্যাগমেন্ট যা এই API প্রক্সি দ্বারা উন্মুক্ত API-কে স্বতন্ত্রভাবে সনাক্ত করে। API পরিষেবাগুলি সঠিক API প্রক্সিতে ইনকামিং অনুরোধ বার্তাগুলিকে মেলাতে এবং রুট করতে বেস পাথ URI ব্যবহার করে৷ (বেস পাথ API-এর ডোমেনে যুক্ত করা হয়, যা স্বয়ংক্রিয়ভাবে আপনার প্রতিষ্ঠানের নাম এবং পরিবেশ যেখানে API প্রক্সি স্থাপন করা হয় তার উপর ভিত্তি করে তৈরি হয়।) প্রকল্পের নামে একটি সংস্করণ নম্বর অন্তর্ভুক্ত করা একটি সর্বোত্তম অভ্যাস, উদাহরণস্বরূপ, /v1/delayedstockquote। এটি নির্ধারণ করবে কিভাবে আপনার এপিআই ভোক্তা অ্যাপস দ্বারা আহ্বান করা হবে।দ্রষ্টব্য : প্রক্সি বেস পাথ ডিফল্ট প্রক্সি নামের জন্য নির্দিষ্ট মানটিকে সমস্ত ছোট হাতের ক্ষেত্রে রূপান্তরিত করে, যদি না আপনি প্রক্সি বেস পাথ ক্ষেত্রের বিষয়বস্তু স্পষ্টভাবে সম্পাদনা করেন।
বর্ণনা প্রক্সি একটি সংক্ষিপ্ত বিবরণ. - পরবর্তী ক্লিক করুন.
- WSDL পৃষ্ঠায়, API প্রক্সি টাইপ Pass-through SOAP নির্বাচন করুন।
দ্রষ্টব্য: প্রতিটি WSDL ক্রিয়াকলাপ এবং এর সংশ্লিষ্ট SOAP পেলোড তালিকাভুক্ত একটি টেবিল প্রদর্শিত হয়। এটি সেই পেলোড যা ব্যাকএন্ড SOAP পরিষেবাতে "পাস করা হয়"৷
- পোর্ট টাইপ কলাম থেকে নির্বাচন করুন কোন সেট অপারেশন আপনি ব্যবহার করতে চান। WSDL-এ, পোর্ট টাইপ উপাদানগুলি এমন অপারেশনগুলিকে সংজ্ঞায়িত করে যা আপনি একটি ওয়েব পরিষেবাতে কল করতে পারেন।
- নিরাপত্তা যোগ করতে, ভার্চুয়াল হোস্ট নির্বাচন এবং স্থাপনার পরিবেশের জন্য বাকি উইজার্ডের মাধ্যমে ক্লিক করুন।
- বিল্ড পৃষ্ঠায়, বিল্ড এবং ডিপ্লোয় ক্লিক করুন। এজ WSDL-এর উপর ভিত্তি করে নতুন API প্রক্সি তৈরি করে এবং স্থাপন করে।
চূড়ান্ত প্রক্সি সম্পর্কে
যখন এজ একটি পাস-থ্রু প্রক্সি তৈরি করে, ফলে প্রক্সিটি আসলে একটি জটিল প্রবাহ যা ডেটা রূপান্তর, এক্সট্র্যাক্ট এবং ভেরিয়েবল সেট করা, ম্যানিপুলেট মেসেজ এবং আরও অনেক কিছুর নীতি অন্তর্ভুক্ত করে। আপনি পাস-থ্রু প্রক্সি তৈরি করার পরে, API ব্যবস্থাপনা UI-এর বিকাশ দৃশ্যে ফলস্বরূপ প্রবাহটি দেখুন। সেখানে, আপনি ঠিক কোন নীতিগুলি যোগ করা হয়েছে তা দেখতে পারেন।
উদাহরণ স্বরূপ, নিম্নলিখিত চিত্রটি একটি পাস-থ্রু প্রক্সির টার্গেট এন্ডপয়েন্ট প্রিফ্লো অংশ দেখায়। অনুরোধের দিকে, লক্ষ্য URL সেট করতে একটি AssignMessage নীতি ব্যবহার করা হয়। প্রতিক্রিয়ার দিকে, XML থেকে JSON-এ প্রতিক্রিয়া রূপান্তরিত করার জন্য নীতিগুলি কার্যকর করে, প্রতিক্রিয়ার SOAP বডি অংশটিকে একটি পরিবর্তনশীলে বের করে এবং প্রতিক্রিয়া বার্তা সেট করে। আপনি যখন প্রক্সি তৈরি করেন তখন এই নীতিগুলি (এবং অন্যান্য) স্বয়ংক্রিয়ভাবে যুক্ত হয়৷
এজ-হোস্টেড WSDL : এই ধরনের প্রক্সির জন্য তৈরি হওয়া এজ-হোস্টেড WSDL দেখতে, http(s)://[proxy_domain]/[proxy_base_path] ?wsdl এ যান।
উন্নত SOAP-টু-REST প্রক্সি ডেভেলপমেন্ট
পূর্ববর্তী বিভাগগুলি এজ-এ API প্রক্সি উইজার্ড ব্যবহার করে একটি SOAP-to-REST API প্রক্সি তৈরিকে কভার করেছে। যাইহোক, আপনি যদি SOAP-থেকে-REST রূপান্তরের উপর আরও সূক্ষ্ম নিয়ন্ত্রণ চান, আপনি উইজার্ড দ্বারা প্রদত্ত অটোমেশনকে বাইপাস করতে পারেন এবং আপনি যে আচরণটি চান তা পেতে ম্যানুয়ালি যোগ এবং নীতিগুলি কনফিগার করে একটি প্রক্সি তৈরি করতে পারেন৷ আরও তথ্যের জন্য, টিউটোরিয়াল দেখুন: Apigee Edge-এ SOAP-to-REST API প্রক্সির ম্যানুয়াল নির্মাণ ।