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