আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
আপনি একাধিক API জুড়ে গতানুগতিক অনুরোধের প্রাক-প্রক্রিয়াকরণ (boilerplate request pre-processing) বা প্রতিক্রিয়ার উত্তর-প্রক্রিয়াকরণের (response post-processing) কাজ শেয়ার্ড ফ্লো (shared flows) দিয়ে করাতে পারেন। একটি ফ্লো হুক (flow hook) ব্যবহার করে, আপনি একটি শেয়ার্ড ফ্লো সংযুক্ত করেন, যাতে এটি একটি নির্দিষ্ট পরিবেশে স্থাপন করা সমস্ত API প্রক্সির জন্য একই স্থানে কার্যকর হয়। এর ফলে আপনি আলাদাভাবে বাস্তবায়িত ও স্থাপন করা একটি ধারাবাহিক লজিক পান, যা কোনো প্রক্সির বাস্তবায়ন কোডের অংশ নয়।
যেহেতু ফ্লো হুকের সাথে সংযুক্ত কোড এপিআই প্রক্সির মূল লজিকের প্রেক্ষাপটের বাইরে থাকে, তাই এর কিছু আচরণ এপিআই প্রক্সি থেকে ভিন্ন হয়। নিম্নলিখিত বিষয়গুলো মনে রাখবেন:
- ফ্লো হুকে একটি শেয়ার্ড ফ্লো সংযুক্ত করতে আপনার অবশ্যই অনুমতি থাকতে হবে। আপনাকে অবশ্যই একজন অর্গ অ্যাডমিন হতে হবে।
- আপনি প্রতিটি ফ্লো হুকের সাথে শুধুমাত্র একটি শেয়ার্ড ফ্লো সংযুক্ত করতে পারবেন।
- আপনি একই শেয়ার করা ফ্লো একাধিক ফ্লো হুকের সাথে সংযুক্ত করতে পারেন।
- যদি কোনো ফ্লো হুকের সাথে সংযুক্ত শেয়ার্ড ফ্লো কোনো ফল্ট তৈরি করে অথবা শেয়ার্ড ফ্লোটি কার্যকর করার সময় কোনো ত্রুটি দেখা দেয়, তাহলে বার্তাটি প্রত্যাখ্যাত হবে এবং ফল্টটি কলারের কাছে ফেরত পাঠানো হবে।
- ফ্লো হুক কার্যকর করার সময় কোনো বার্তা প্রত্যাখ্যাত হলে, তার বিবরণ কল করা প্রক্সির প্রেক্ষাপটে অ্যানালিটিক্সে লগ করা হবে। শেয়ার্ড ফ্লোটি একটি কাস্টম কোড এবং ত্রুটির বার্তা সহ একটি ফল্টও থ্রো করতে পারে।
নিম্নলিখিত ভিডিওটিতে দেখানো হয়েছে, কীভাবে ক্লাসিক এজ UI-তে একটি শেয়ার্ড ফ্লো-কে ফ্লো হুকের সাথে সংযুক্ত করে তারপর সেটিকে ট্রেস করতে হয়।
নিম্নলিখিত ভিডিওটিতে দেখানো হয়েছে, কীভাবে নিউ এজ এক্সপেরিয়েন্স UI-তে একটি শেয়ার্ড ফ্লো-কে ফ্লো হুকের সাথে সংযুক্ত করে তারপর সেটিকে ট্রেস করতে হয়।
ফ্লো হুকের মাধ্যমে কোনো প্রক্সির সাথে সংযুক্ত একটি শেয়ার্ড ফ্লো, ব্যাপক পলিসি আবশ্যকতাগুলো কার্যকর করার লজিকের জন্য একটি চমৎকার জায়গা প্রদান করে। উদাহরণস্বরূপ, কল্পনা করুন যে আপনার একটি দল বিভিন্ন লাইন অফ বিজনেস (LOB) এর প্রতিনিধিত্বকারী একাধিক দলের জন্য একটি একক নিরাপত্তা আবশ্যকতা পরিচালনা করছে। প্রতিটি LOB দল তাদের নিজস্ব আবশ্যকতা অনুযায়ী API তৈরি করতে পারে এবং এর জন্য বৃহত্তর নিরাপত্তা আবশ্যকতাগুলোর কথা বিবেচনা করার প্রয়োজন হয় না। নিরাপত্তা দলটি সেই নিরাপত্তা আবশ্যকতাগুলো একটি শেয়ার্ড ফ্লো-তে প্রয়োগ করতে পারে, তারপর একটি ফ্লো হুক ব্যবহার করে ফ্লো-টিকে Apigee Edge এনভায়রনমেন্টের সাথে সংযুক্ত করতে পারে। যেহেতু শেয়ার্ড ফ্লো-টি প্রক্সি কোডের অংশ নয়, তাই নিরাপত্তা দলটি LOB কোডে হস্তক্ষেপ না করেই প্রয়োজন অনুযায়ী এটি সংশোধন করতে পারে।
ফ্লো হুকের মাধ্যমে সংযুক্ত শেয়ার্ড ফ্লোগুলো , প্রক্সি হুকের এনভায়রনমেন্টে ডেপ্লয় করা প্রতিটি এপিআই প্রক্সির জন্য সেই নির্দিষ্ট অবস্থানে এক্সিকিউট হয়। এই কারণে, ফ্লো হুক ব্যবহার করার সুবিধা শুধুমাত্র একটি Apigee Edge অর্গের অ্যাডমিনিস্ট্রেটরদের জন্যই উপলব্ধ।
শেয়ার্ড ফ্লো সম্পর্কে আরও জানতে, পুনঃব্যবহারযোগ্য শেয়ার্ড ফ্লো দেখুন।
আপনি Apigee Edge ম্যানেজমেন্ট কনসোল ব্যবহার করে একটি ফ্লো হুকের সাথে একটি শেয়ার্ড ফ্লো সংযুক্ত করতে পারেন। আপনি নিম্নলিখিত প্রতিটি স্থানে একটি ফ্লো হুকের সাথে সর্বাধিক একটি শেয়ার্ড ফ্লো সংযুক্ত করতে পারেন:
- যেসব লজিক একটি প্রক্সি এন্ডপয়েন্ট কার্যকর হওয়ার আগেই প্রয়োগ করা প্রয়োজন, সেগুলোর জন্য প্রি-প্রক্সি ফ্লো হুক ।
উদাহরণস্বরূপ, একটি এনভায়রনমেন্টের সমস্ত এপিআই জুড়ে নিরাপত্তা প্রয়োগ করার জন্য আপনার লজিক থাকতে পারে।
- যেসব লজিক কোনো টার্গেট কল করার আগেই প্রয়োগ করা প্রয়োজন, সেগুলোর জন্য প্রি-টার্গেট ফ্লো হুক ।
উদাহরণস্বরূপ, অনুরোধটি ব্যাকএন্ডে পৌঁছানোর আগেই আপনি লগিং প্রয়োগ করতে পারেন। এছাড়াও, অনুরোধ থেকে নির্দিষ্ট কিছু ফিল্ড সরিয়ে দিয়ে আপনি মিডিয়েশন কার্যকর করতে পারেন।
- টার্গেট রেসপন্স কার্যকর হওয়ার পরে যে লজিক প্রয়োগ করা প্রয়োজন, তার জন্য পোস্ট-টার্গেট ফ্লো হুক ।
ব্যাকএন্ড থেকে প্রতিক্রিয়া ফিরে আসার ঠিক পরেই এটি কার্যকর করা হবে। আপনি এটি ব্যবহার করে ব্যাকএন্ডের প্রতিক্রিয়া লগ করতে পারেন অথবা প্রতিক্রিয়া থেকে সংবেদনশীল ফিল্ডগুলি সরিয়ে দিয়ে কোনো মধ্যস্থতা সম্পাদন করতে পারেন।
- যেসব লজিক প্রক্সি এন্ডপয়েন্টের পরে এবং ক্লায়েন্টের কাছে রেসপন্স পাঠানোর ঠিক আগে প্রয়োগ করা প্রয়োজন, সেগুলোর জন্য পোস্ট-প্রক্সি ফ্লো হুক।
এর মধ্যে CORS-এর জন্য কিছু প্রয়োগমূলক লজিক, রেসপন্স লগ করা, অথবা কোনো ম্যাশআপ বা ফরম্যাটিং করা অন্তর্ভুক্ত থাকতে পারে।
একটি শেয়ার্ড ফ্লোকে ফ্লো হুকের সাথে সংযুক্ত করা
একটি শেয়ার্ড ফ্লোকে ফ্লো হুকের সাথে সংযুক্ত করতে হলে, আপনাকে অবশ্যই শেয়ার্ড ফ্লোটি ধারণকারী অর্গানাইজেশনের একজন অ্যাডমিনিস্ট্রেটর হতে হবে।
- নিচে বর্ণিত পদ্ধতি অনুযায়ী ফ্লো হুকস পেজটি অ্যাক্সেস করুন।
প্রান্ত
Edge UI ব্যবহার করে ফ্লো হুকস পেজটি অ্যাক্সেস করতে:
- apigee.com/edge- এ সাইন ইন করুন।
- আপনার শেয়ার করা ফ্লো ধারণকারী সংস্থাটি নির্বাচন করুন। আপনার সংস্থাগুলোর মধ্যে পরিবর্তন করা দেখুন।
এই সংস্থা থেকে কোনো পরিবেশে ডেপ্লয় করা যেকোনো এপিআই প্রক্সি এবং শেয়ার্ড ফ্লো-এর জন্য শেয়ার্ড ফ্লো-টি উপলব্ধ হবে। এটি এই সংস্থার বাইরে থেকে উপলব্ধ হবে না।
- বাম দিকের নেভিগেশন বার থেকে অ্যাডমিন > এনভায়রনমেন্টস > ফ্লো হুকস নির্বাচন করুন।
ক্লাসিক এজ (প্রাইভেট ক্লাউড)
ক্লাসিক এজ UI ব্যবহার করে ফ্লো হুকস পেজটি অ্যাক্সেস করতে:
-
http:// ms-ip :9000এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম। - আপনার শেয়ার করা ফ্লো ধারণকারী সংস্থাটি নির্বাচন করুন। আপনার সংস্থাগুলোর মধ্যে পরিবর্তন করা দেখুন।
এই সংস্থা থেকে কোনো পরিবেশে ডেপ্লয় করা যেকোনো এপিআই প্রক্সি এবং শেয়ার্ড ফ্লো-এর জন্য শেয়ার্ড ফ্লো-টি উপলব্ধ হবে। এটি এই সংস্থার বাইরে থেকে উপলব্ধ হবে না।
- উপরের নেভিগেশন বারে APIs > Environment Configuration > Flow Hooks নির্বাচন করুন।
- ফ্লো হুকগুলির তালিকা থেকে, শেয়ার্ড ফ্লোটি কোথায় কার্যকর করতে চান তার উপর ভিত্তি করে সেই ফ্লো হুকটি শনাক্ত করুন যার সাথে আপনি শেয়ার্ড ফ্লোটি সংযুক্ত করতে চান।
ফ্লো হুকের অবস্থান বর্ণনা প্রি-প্রক্সি ফ্লো হুক একটি প্রক্সি এন্ডপয়েন্ট কার্যকর হওয়ার আগে প্রি-টার্গেট ফ্লো হুক একটি টার্গেট এন্ডপয়েন্ট কার্যকর হওয়ার আগে লক্ষ্য-পরবর্তী প্রবাহ হুক লক্ষ্য প্রতিক্রিয়া কার্যকর হওয়ার পরে পোস্ট-প্রক্সি ফ্লো হুক প্রক্সি এন্ডপয়েন্টের পরে এবং ক্লায়েন্টের কাছে প্রতিক্রিয়া পাঠানোর ঠিক আগে - অ্যাকশন কলামটি প্রদর্শন করতে তালিকার ফ্লো হুকের উপর আপনার কার্সার রাখুন।
- ক্লিক করুন
. - শেয়ার্ড ফ্লো ডায়ালগে, শেয়ার্ড ফ্লো ড্রপডাউন থেকে আপনি যে শেয়ার্ড ফ্লোটি সংযুক্ত করতে চান সেটি নির্বাচন করুন।
- OK ক্লিক করুন।
- প্রয়োজন অনুযায়ী শেয়ার করা ফ্লোগুলোকে অন্যান্য ফ্লো হুকের সাথে সংযুক্ত করুন।