ফ্লো হুক ব্যবহার করে শেয়ার করা ফ্লো অ্যাটাচ করা

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

আপনি একাধিক API জুড়ে শেয়ার করা ফ্লোকে বয়লারপ্লেট অনুরোধ প্রি-প্রসেসিং বা উত্তর পোস্ট-প্রসেসিং করতে দিতে পারেন। ফ্লো হুক-এর সাহায্যে, আপনি একটি শেয়ার করা ফ্লো অ্যাটাচ করেন যাতে নির্দিষ্ট এনভায়রনমেন্টে ডেপ্লয় করা সব API প্রক্সি একই জায়গায় এক্সিকিউট হয়। এর ফলে আপনি আলাদাভাবে প্রয়োগ ও ডিপ্লয় করা লজিকের একটি সিকোয়েন্স পান যা প্রক্সি ইমপ্লিমেন্টেশন কোডের অংশ নয়।

ফ্লো হুকের সাথে অ্যাটাচ করা কোড API প্রক্সি কোড লজিকের বাইরে থাকে বলে, এর কিছু আচরণ API প্রক্সি থেকে আলাদা হয়। নিম্নলিখিত বিষয়গুলি মনে রাখবেন:

• ফ্লো হুকে শেয়ার করা ফ্লো অ্যাটাচ করার জন্য আপনার কাছে অবশ্যই অনুমতি থাকতে হবে। আপনাকে অবশ্যই একজন org অ্যাডমিন হতে হবে।
• আপনি প্রতিটি ফ্লো হুকে শুধুমাত্র একটি শেয়ার করা ফ্লো অ্যাটাচ করতে পারবেন।
• আপনি একাধিক ফ্লো হুকে একই শেয়ার করা ফ্লো অ্যাটাচ করতে পারবেন।
• ফ্লো হুকের সাথে অ্যাটাচ করা শেয়ার্ড ফ্লো কোনও ফল্ট তৈরি করলে বা শেয়ার্ড ফ্লো এক্সিকিউট করার সময় কোনও সমস্যা হলে, মেসেজটি বাতিল করা হবে এবং ফল্টটি কলারের কাছে ফেরত পাঠানো হবে।
• ফ্লো হুক এক্সিকিউট করার সময় কোনও মেসেজ বাতিল করা হলে, কল করা প্রক্সি প্রসঙ্গে Analytics-এ বিবরণ লগ করা হবে। শেয়ার করা ফ্লো কাস্টম কোড ও সমস্যার মেসেজ সহ একটি ফল্টও দেখাতে পারে

ক্লাসিক Edge UI-তে, কীভাবে একটি শেয়ার করা ফ্লোকে ফ্লো হুকের সাথে কানেক্ট করতে হয়, তারপর তা ট্রেস করতে হয় তা নিচের ভিডিওতে দেখানো হয়েছে।

নতুন Edge এক্সপিরিয়েন্স UI-তে, কীভাবে কোনও শেয়ার করা ফ্লোকে ফ্লো হুকের সাথে কানেক্ট করতে হয় এবং তারপরে তা ট্র্যাক করতে হয়, তা নিম্নলিখিত ভিডিওতে দেখানো হয়েছে।

ফ্লো হুকের মাধ্যমে প্রক্সির সাথে অ্যাটাচ করা শেয়ারড ফ্লো, এমন লজিক প্রয়োগ করার জন্য একটি দুর্দান্ত জায়গা প্রদান করে যা ব্যাপক নীতি সংক্রান্ত প্রয়োজনীয়তা এনফোর্স করে। যেমন, ধরে নিন আপনার একটি টিম একাধিক টিমের জন্য একটি নিরাপত্তা সংক্রান্ত প্রয়োজনীয়তা ম্যানেজ করছে, এই টিমগুলি বিভিন্ন ধরনের ব্যবসা (LOB) পরিচালনা করে। প্রতিটি LOB টিম তাদের নিজস্ব প্রয়োজন অনুযায়ী API ডেভেলপ করতে পারে এবং এর জন্য তাদের বৃহত্তর নিরাপত্তা সংক্রান্ত প্রয়োজনীয়তা বিবেচনা করতে হয় না। নিরাপত্তা টিম সেইসব নিরাপত্তা প্রয়োজনীয়তা শেয়ার করা ফ্লোতে প্রয়োগ করতে পারে, তারপর ফ্লো হুক ব্যবহার করে Apigee Edge এনভায়রনমেন্টে ফ্লো অ্যাটাচ করতে পারে। যেহেতু শেয়ার্ড ফ্লো প্রক্সি কোডের অংশ নয়, তাই LOB কোডে কোনও হস্তক্ষেপ না করেই নিরাপত্তা টিম প্রয়োজন মতো এটি সংশোধন করতে পারে।

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

শেয়ার করা ফ্লো সম্পর্কে আরও জানতে, পুনর্ব্যবহারযোগ্য শেয়ার করা ফ্লো দেখুন।

আপনি Apigee Edge ম্যানেজমেন্ট কনসোল ব্যবহার করে ফ্লো হুকে শেয়ার করা ফ্লো অ্যাটাচ করেন। আপনি নিচের প্রতিটি জায়গায় ফ্লো হুকে সর্বাধিক একটি শেয়ার করা ফ্লো অ্যাটাচ করতে পারবেন:

• প্রক্সি এন্ডপয়েন্ট এক্সিকিউট করার আগে প্রয়োগ করতে হবে এমন লজিকের জন্য প্রি-প্রক্সি ফ্লো হুক।

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

• টার্গেট কল করার আগে প্রয়োগ করতে হবে এমন লজিকের জন্য প্রি-টার্গেট ফ্লো হুক।

  যেমন, অনুরোধ ব্যাকএন্ডে পৌঁছানোর আগেই আপনি লগিং প্রয়োগ করতে পারেন। এছাড়াও, আপনি অনুরোধ থেকে নির্দিষ্ট কিছু ফিল্ড সরিয়ে দিয়ে মধ্যস্থতা এনফোর্স করতে পারেন।

• টার্গেট উত্তর এক্সিকিউট হওয়ার পরে প্রয়োগ করতে হবে এমন লজিকের জন্য পোস্ট-টার্গেট ফ্লো হুক।

  ব্যাকএন্ড থেকে উত্তর পাওয়ার সাথে সাথেই এটি প্রয়োগ করা হবে। আপনি এটি ব্যবহার করতে পারেন ব্যাকএন্ড থেকে পাওয়া উত্তর লগ করতে অথবা ব্যাকএন্ড থেকে পাওয়া উত্তরে থাকা সংবেদনশীল ফিল্ড সরিয়ে দিয়ে কিছু মধ্যস্থতা করতে।

• প্রক্সি এন্ডপয়েন্টের পরে এবং ক্লায়েন্টকে উত্তর পাঠানোর ঠিক আগে প্রয়োগ করতে হবে এমন লজিকের জন্য পোস্ট-প্রক্সি ফ্লো হুক।

  এর মধ্যে CORS-এর জন্য কিছু এনফোর্সমেন্ট লজিক, উত্তর লগ করা বা কিছু মিক্স-আপ বা ফর্ম্যাটিং করা অন্তর্ভুক্ত থাকতে পারে।

ফ্লো হুকে শেয়ার করা ফ্লো অ্যাটাচ করা

ফ্লো হুকে শেয়ার করা ফ্লো অ্যাটাচ করতে, আপনাকে অবশ্যই শেয়ার করা ফ্লো থাকা সংস্থার অ্যাডমিনিস্ট্রেটর হতে হবে।

1. নিচে যেভাবে বর্ণনা করা হয়েছে, সেইভাবে ফ্লো হুক পৃষ্ঠা অ্যাক্সেস করুন।

   Edge

   Edge UI ব্যবহার করে Flow Hooks পৃষ্ঠা অ্যাক্সেস করতে:

   1. apigee.com/edge লিঙ্কে গিয়ে সাইন-ইন করুন।
   2. আপনার শেয়ার করা ফ্লো যে প্রতিষ্ঠানে আছে সেটি বেছে নিন। আপনার প্রতিষ্ঠানের মধ্যে পরিবর্তন করা দেখুন।

      এই সংস্থার কোনও এনভায়রনমেন্টে ডেপ্লয় করা যেকোনও API প্রক্সি ও শেয়ার্ড ফ্লোর জন্য শেয়ার করা ফ্লো উপলভ্য হবে। এই সংস্থার বাইরে এটি উপলভ্য হবে না।

   3. বাঁদিকের নেভিগেশন বার থেকে অ্যাডমিন > এনভায়রনমেন্ট > ফ্লো হুক বিকল্প বেছে নিন।

   ক্লাসিক Edge (প্রাইভেট ক্লাউড)

   ক্লাসিক Edge UI ব্যবহার করে Flow Hooks পৃষ্ঠা অ্যাক্সেস করতে:

   1. http://ms-ip:9000-এ সাইন-ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP অ্যাড্রেস বা DNS নাম।
   2. আপনার শেয়ার করা ফ্লো যে প্রতিষ্ঠানে আছে সেটি বেছে নিন। আপনার প্রতিষ্ঠানের মধ্যে পরিবর্তন করা দেখুন।

      এই সংস্থার কোনও এনভায়রনমেন্টে ডেপ্লয় করা যেকোনও API প্রক্সি ও শেয়ার্ড ফ্লোর জন্য শেয়ার করা ফ্লো উপলভ্য হবে। এই সংস্থার বাইরে এটি উপলভ্য হবে না।

   3. সবচেয়ে উপরে নেভিগেশন বারে API > এনভায়রনমেন্ট কনফিগারেশন > ফ্লো হুক বিকল্প বেছে নিন।
2. শেয়ার করা ফ্লো কোথায় এক্সিকিউট করতে চান তার উপর ভিত্তি করে, ফ্লো হুকগুলির তালিকা থেকে, আপনি যে ফ্লো হুকের সাথে শেয়ার করা ফ্লো অ্যাটাচ করতে চান সেটি শনাক্ত করুন ।

   ফ্লো হুক লোকেশন	বিবরণ
   প্রি-প্রক্সি ফ্লো হুক	প্রক্সি এন্ডপয়েন্ট এক্সিকিউট করার আগে
   প্রি-টার্গেট ফ্লো হুক	টার্গেট এন্ডপয়েন্ট এক্সিকিউট করার আগে
   পোস্ট-টার্গেট ফ্লো হুক	টার্গেট উত্তর এক্সিকিউট হওয়ার পরে
   প্রক্সি-পরবর্তী Flow Hook	প্রক্সি এন্ডপয়েন্টের পরে এবং ক্লায়েন্টকে উত্তর পাঠানোর ঠিক আগে

3. অ্যাকশন কলাম দেখতে, তালিকায় ফ্লো হুকের উপরে কার্সর নিয়ে যান।
4. -এ ক্লিক করুন।
5. শেয়ার করা ফ্লো ডায়ালগে, শেয়ার করা ফ্লো ড্রপডাউন থেকে আপনি যে শেয়ার করা ফ্লো অ্যাটাচ করতে চান সেটি বেছে নিন।
6. ঠিক আছে বিকল্পে ক্লিক করুন।
7. প্রয়োজন অনুযায়ী অন্যান্য ফ্লো হুকে শেয়ার করা ফ্লো অ্যাটাচ করুন।