একটি সাধারণ API প্রক্সি তৈরি করুন

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন
.info- তে যান।

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

এপিআই প্রক্সি আপনার ব্যাকএন্ড সার্ভিস ইমপ্লিমেন্টেশনকে ডেভেলপারদের ব্যবহৃত এপিআই থেকে বিচ্ছিন্ন করে। এটি ডেভেলপারদের আপনার ব্যাকএন্ড সার্ভিসের ভবিষ্যৎ পরিবর্তন থেকে সুরক্ষিত রাখে। আপনি যখন ব্যাকএন্ড সার্ভিস আপডেট করেন, তখন ডেভেলপাররা সেই পরিবর্তনগুলো থেকে সুরক্ষিত থাকায় কোনো বাধা ছাড়াই এপিআই কল করা চালিয়ে যেতে পারেন।

এপিআই প্রক্সি তৈরি করার প্রক্রিয়া সম্পর্কে একটি সামগ্রিক ধারণা পেতে এই ভিডিওটি দেখুন।

UI ব্যবহার করে একটি API প্রক্সি তৈরি করা

এপিআই প্রক্সি তৈরি করার সবচেয়ে সহজ উপায় হলো ক্রিয়েট প্রক্সি উইজার্ড ব্যবহার করা।

প্রান্ত

Edge UI ব্যবহার করে Create Proxy উইজার্ড অ্যাক্সেস করতে:

  1. apigee.com/edge- এ সাইন ইন করুন।
  2. বাম দিকের নেভিগেশন বার থেকে Develop > API Proxys নির্বাচন করুন।
  3. +প্রক্সি-তে ক্লিক করুন।

ক্রিয়েট প্রক্সি উইজার্ডটি একটি এপিআই প্রক্সি তৈরি করতে এবং এতে ন্যূনতম বৈশিষ্ট্য যোগ করার ধাপগুলো প্রদর্শন করে ও আপনাকে সেগুলোর মাধ্যমে পথ দেখায়।

ক্রিয়েট প্রক্সি উইজার্ডের প্রথম পৃষ্ঠাটি আপনাকে উইজার্ডের কার্যপ্রবাহ কাস্টমাইজ করার জন্য রিভার্স প্রক্সি, SOAP সার্ভিস, নো টার্গেট, অথবা প্রক্সি বান্ডেল নির্বাচন করতে বলছে।

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

ক্লাসিক এজ UI ব্যবহার করে ক্রিয়েট প্রক্সি উইজার্ড অ্যাক্সেস করতে:

  1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম।
  2. উপরের নেভিগেশন বারে APIs > API Proxys নির্বাচন করুন।
  3. ক্লিক করুন + এপিআই প্রক্সি

ক্রিয়েট প্রক্সি উইজার্ডটি একটি এপিআই প্রক্সি তৈরি করতে এবং এতে ন্যূনতম বৈশিষ্ট্য যোগ করার ধাপগুলো প্রদর্শন করে ও আপনাকে সেগুলোর মাধ্যমে পথ দেখায়।

ক্রিয়েট প্রক্সি উইজার্ডের প্রথম পৃষ্ঠাটি আপনাকে উইজার্ডের কার্যপ্রবাহ কাস্টমাইজ করার জন্য রিভার্স প্রক্সি, SOAP সার্ভিস, নো টার্গেট, অথবা প্রক্সি বান্ডেল নির্বাচন করতে বলছে।

উইজার্ডের প্রথম পৃষ্ঠাটি আপনাকে নিম্নলিখিত উৎসগুলো থেকে একটি এপিআই প্রক্সি তৈরি করার সুযোগ দেয়:

প্রকার বর্ণনা
বিপরীত প্রক্সি (সবচেয়ে সাধারণ)

একটি এপিআই প্রক্সি যা আগত অনুরোধগুলিকে বিদ্যমান HTTP ব্যাকএন্ড পরিষেবাগুলিতে রুট করে। এটি একটি JSON বা XML এপিআই হতে পারে। এই বিভাগের পরবর্তী অংশে "একটি HTTP পরিষেবার জন্য রিভার্স প্রক্সি তৈরি করা" দেখুন।

একটি বৈধ OpenAPI স্পেসিফিকেশন থেকে প্রক্সি তৈরি করতে ‘Use OpenAPI Spec’-এ ক্লিক করুন। এই বিকল্পটি সম্পর্কে আরও তথ্যের জন্য, এই বিভাগের পরবর্তী অংশে ‘Using OpenAPI Specifications to generate proxys’ দেখুন।

সাবান পরিষেবা একটি WSDL ফাইল থেকে তৈরি করা এপিআই প্রক্সি। একটি SOAP-ভিত্তিক ওয়েব সার্ভিসকে এপিআই প্রক্সি হিসেবে প্রকাশ করা দেখুন।
কোন লক্ষ্য নেই

একটি এপিআই প্রক্সি যার কোনো এপিআই ব্যাকএন্ড নেই ("নো টার্গেট")। এটি পূর্বে বর্ণিত একটি HTTP সার্ভিসের জন্য রিভার্স প্রক্সি তৈরির মতোই, তবে পার্থক্য হলো এপিআই প্রক্সির বিবরণ নির্ধারণ করার সময় আপনাকে কোনো বিদ্যমান এপিআই নির্দিষ্ট করতে হবে না।

একটি বৈধ OpenAPI স্পেসিফিকেশন থেকে প্রক্সি তৈরি করতে ‘Use OpenAPI Spec’-এ ক্লিক করুন। এই বিকল্পটি সম্পর্কে আরও তথ্যের জন্য, এই বিভাগের পরবর্তী অংশে ‘Using OpenAPI Specifications to generate proxys’ দেখুন।

হোস্ট করা লক্ষ্য

একটি এপিআই প্রক্সি যা হোস্টেড টার্গেটস এনভায়রনমেন্টে ডেপ্লয় করা একটি Node.js অ্যাপ্লিকেশনে রাউট করে। হোস্টেড টার্গেটস ওভারভিউ দেখুন।

প্রক্সি বান্ডেল আপলোড করুন একটি বিদ্যমান এপিআই প্রক্সি বান্ডেল (উদাহরণস্বরূপ গিটহাবে উপলব্ধ নমুনা এপিআই প্রক্সিগুলির মধ্যে একটি)। এপিআই প্রক্সি বান্ডেল থেকে এপিআই প্রক্সি ইম্পোর্ট করা দেখুন।

নিম্নলিখিত বিভাগগুলিতে প্রতিটি উৎস ব্যবহার করে কীভাবে একটি এপিআই প্রক্সি তৈরি করতে হয় তা বর্ণনা করা হয়েছে।

একটি HTTP পরিষেবার জন্য একটি রিভার্স প্রক্সি তৈরি করা

Edge দুটি তথ্যের উপর ভিত্তি করে রিভার্স প্রক্সি তৈরি করে:

  • ব্যাকএন্ড পরিষেবার URL
  • URI পাথ যা API-কে অনন্যভাবে শনাক্ত করে এবং যা API প্রক্সির মাধ্যমে কনজিউমার অ্যাপের কাছে উন্মুক্ত করা হবে।

ব্যাকএন্ড সার্ভিস ইউআরএল সাধারণত আপনার প্রতিষ্ঠানের মালিকানাধীন একটি সার্ভিস-সক্ষম অ্যাপ্লিকেশনকে নির্দেশ করে। এটি কোনো সর্বজনীনভাবে উপলব্ধ এপিআই-কেও নির্দেশ করতে পারে। এপিআই বা সার্ভিসটি আপনার নিয়ন্ত্রণে থাকতে পারে (উদাহরণস্বরূপ, একটি অভ্যন্তরীণ এইচআর অ্যাপ্লিকেশন বা ক্লাউডে থাকা একটি রেইলস অ্যাপ্লিকেশন) অথবা এটি কোনো তৃতীয় পক্ষের এপিআই বা সার্ভিসও হতে পারে (উদাহরণস্বরূপ, টুইটার বা ইনস্টাগ্রাম)।

প্রান্ত

  1. এই বিভাগের পূর্ববর্তী অংশে UI ব্যবহার করে একটি API প্রক্সি তৈরি করার বর্ণনানুযায়ী, ক্রিয়েট প্রক্সি উইজার্ডটি অ্যাক্সেস করুন।
  2. ক্রিয়েট প্রক্সি উইজার্ডে, রিভার্স প্রক্সি (সবচেয়ে প্রচলিত) বিকল্পে ক্লিক করুন। বিদ্যমান ও বৈধ কোনো ওপেনএপিআই স্পেসিফিকেশন থেকে প্রক্সি তৈরি করতে, ইউজ ওপেনএপিআই স্পেক বিকল্পে ক্লিক করুন। এই বিকল্পটি সম্পর্কে বিস্তারিত জানতে, নিচে প্রক্সি তৈরির জন্য ওপেনএপিআই স্পেসিফিকেশন ব্যবহার দেখুন।
  3. উইজার্ডের বিবরণ পৃষ্ঠায় নিম্নলিখিত তথ্যগুলো প্রবেশ করান।
    মাঠ বর্ণনা
    নাম আপনার 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 কল করার সুযোগ দেয়, যার ফলে নতুন টিমগুলোকে সাপোর্ট করার জন্য আপনাকে নতুন এপিআই প্রক্সি তৈরি করতে হয় না। উল্লেখ্য যে /**/ সমর্থিত নয়।

    বর্ণনা (ঐচ্ছিক) এপিআই-এর বিবরণ।
    লক্ষ্য (বিদ্যমান এপিআই) এই এপিআই প্রক্সি যে ব্যাকএন্ড পরিষেবাটি আহ্বান করে, তার ইউআরএল।
  4. উইজার্ডের কমন পলিসি পেজে নিম্নলিখিত বিষয়গুলো কনফিগার করুন:
    • নিরাপত্তা: অনুমোদন-এর অধীনে নিরাপত্তা অনুমোদনের প্রয়োজনীয়তা। এই বিভাগের পরবর্তী অংশে নিরাপত্তা যোগ করা দেখুন।
    • সিকিউরিটি: ব্রাউজার-এর অধীনে ক্রস-অরিজিন রিসোর্স শেয়ারিং (CORS)-এর জন্য সাপোর্ট। এই বিভাগের পরবর্তী অংশে CORS-এর জন্য সাপোর্ট যোগ করা দেখুন।
    • আপনার ব্যাকএন্ড সার্ভিসকে উচ্চ ট্র্যাফিক থেকে সুরক্ষিত রাখতে কোটা ব্যবহার করুন। কোটা দেখুন (পাস-থ্রু অথরাইজেশন নির্বাচন করা থাকলে এটি উপলব্ধ নয়।)
    • মনিটাইজেশন -সক্ষম সংস্থাগুলির জন্য মনিটাইজেশন সীমা প্রয়োগ। এপিআই প্রক্সিগুলিতে মনিটাইজেশন সীমা প্রয়োগ দেখুন।
  5. উইজার্ডের ভার্চুয়াল হোস্ট পেজে, সেই ভার্চুয়াল হোস্টগুলো নির্বাচন করুন যেগুলোর সাথে এপিআই প্রক্সি ডেপ্লয় করার সময় বাইন্ড হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
  6. সামারি পেজে, প্রয়োজন হলে ডেপ্লয়মেন্ট এনভায়রনমেন্ট(গুলো) নির্বাচন করুন এবং ক্রিয়েট অ্যান্ড ডেপ্লয়-এ ক্লিক করুন।

    আপনার নতুন এপিআই প্রক্সিটি তৈরি করে নির্বাচিত পরিবেশে স্থাপন করা হয়েছে।

  7. এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে ‘এডিট প্রক্সি’-তে ক্লিক করুন।

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

  1. এই বিভাগের পূর্ববর্তী অংশে UI ব্যবহার করে একটি API প্রক্সি তৈরি করার বর্ণনানুযায়ী, ক্রিয়েট প্রক্সি উইজার্ডটি অ্যাক্সেস করুন।
  2. 'Build a Proxy' উইজার্ডে, 'Reverse proxy (most common)' নির্বাচন করুন। একটি বিদ্যমান, বৈধ OpenAPI স্পেক থেকে প্রক্সি তৈরি করতে, 'Use OpenAPI'-তে ক্লিক করুন। এই বিকল্পটি সম্পর্কে বিস্তারিত জানতে, নিচে ' Using OpenAPI Specifications to generate proxys' দেখুন।
  3. পরবর্তী ধাপে যান।
  4. উইজার্ডের বিবরণ পৃষ্ঠায় নিম্নলিখিত তথ্যগুলো প্রবেশ করান।
    মাঠ বর্ণনা
    প্রক্সি নাম আপনার এপিআই-এর জন্য প্রদর্শিত নামটি।
    প্রক্সি বেস পাথ

    প্রক্সি বেস পাথ হলো আপনার এপিআই প্রক্সির 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 কল করার সুযোগ দেয়, যার ফলে নতুন টিমগুলোকে সাপোর্ট করার জন্য আপনাকে নতুন এপিআই প্রক্সি তৈরি করতে হয় না। উল্লেখ্য যে, /**/ সমর্থিত নয়।

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

    বিদ্যমান এপিআই যে ইউআরএলটি এপিআই প্ল্যাটফর্ম, সেইসব অ্যাপের পক্ষ থেকে ব্যবহার করে থাকে যারা এপিআই প্রক্সি ইউআরএল-এর মাধ্যমে আপনার এপিআই-কে কল করে।
    বর্ণনা এপিআই-এর বিবরণ।
  5. উইজার্ডের নিরাপত্তা পৃষ্ঠায় নিম্নলিখিত বিষয়গুলো কনফিগার করুন:
  6. উইজার্ডের ভার্চুয়াল হোস্ট পেজে, সেই ভার্চুয়াল হোস্টগুলো নির্বাচন করুন যেগুলোর সাথে এপিআই প্রক্সি ডেপ্লয় করার সময় বাইন্ড হবে। আরও তথ্যের জন্য, ভার্চুয়াল হোস্ট সম্পর্কে দেখুন।
  7. ডেপ্লয়মেন্ট এনভায়রনমেন্ট(গুলি) নির্বাচন করুন এবং বিল্ড অ্যান্ড ডেপ্লয়-এ ক্লিক করুন।
    আপনার নতুন এপিআই প্রক্সিটি নির্বাচিত পরিবেশে সফলভাবে তৈরি ও স্থাপন করা হয়েছে, তা নিশ্চিত করে একটি প্রাপ্তিস্বীকার বার্তা পাঠানো হয়।
  8. এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে এডিটরে থাকা <প্রক্সির নাম> প্রক্সিটি দেখুন -এ ক্লিক করুন।

একটি এপিআই প্রক্সি বান্ডেল থেকে একটি এপিআই প্রক্সি ইম্পোর্ট করা

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

এপিআই প্রক্সি বান্ডেল থেকে কীভাবে এপিআই প্রক্সি তৈরি ও ইম্পোর্ট করতে হয়, তা জানতে এই ভিডিওটি দেখুন।

প্রান্ত

একটি এপিআই প্রক্সি বান্ডেল থেকে এপিআই প্রক্সি ইম্পোর্ট করতে:

  1. এই বিভাগের পূর্ববর্তী অংশে UI ব্যবহার করে একটি API প্রক্সি তৈরি করার বর্ণনানুযায়ী, ক্রিয়েট প্রক্সি উইজার্ডটি অ্যাক্সেস করুন।
  2. প্রক্সি বান্ডেল আপলোড করতে ক্লিক করুন।
  3. প্রক্সি উইজার্ডের ' আপলোড প্রক্সি বান্ডেল ' পৃষ্ঠায় নিম্নলিখিত তথ্যগুলো প্রবেশ করান।

    মাঠ বর্ণনা
    জিপ বান্ডেল এপিআই প্রক্সি কনফিগারেশন সম্বলিত জিপ ফাইল। ফাইলটিতে যেতে ড্র্যাগ অ্যান্ড ড্রপ করুন অথবা ক্লিক করুন।
    নাম আপনার এপিআই-এর জন্য প্রদর্শিত নাম। ডিফল্টরূপে এটি এক্সটেনশন ছাড়া জিপ ফাইলের নামটি ব্যবহার করে।
  4. পরবর্তী ধাপে যান।
  5. সামারি পেজে, প্রয়োজন হলে ডেপ্লয়মেন্ট এনভায়রনমেন্ট(গুলো) নির্বাচন করুন এবং ক্রিয়েট অ্যান্ড ডেপ্লয়-এ ক্লিক করুন।
    আপনার নতুন এপিআই প্রক্সি সফলভাবে তৈরি হয়েছে তা নিশ্চিত করে একটি স্বীকৃতি বার্তা প্রদর্শিত হয়।
  6. এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে ‘এডিট প্রক্সি’-তে ক্লিক করুন।

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

  1. এই বিভাগের পূর্ববর্তী অংশে UI ব্যবহার করে একটি API প্রক্সি তৈরি করার বর্ণনানুযায়ী, ক্রিয়েট প্রক্সি উইজার্ডটি অ্যাক্সেস করুন।
  2. বিল্ড এ প্রক্সি উইজার্ডে, প্রক্সি বান্ডেল নির্বাচন করুন।
  3. পরবর্তী ধাপে যান।
  4. প্রক্সি উইজার্ডের Details পৃষ্ঠায় নিম্নলিখিত তথ্যগুলো প্রবেশ করান।

    মাঠ বর্ণনা
    জিপ বান্ডেল Choose File-এ ক্লিক করুন এবং API প্রক্সি কনফিগারেশন সম্বলিত ZIP ফাইলটিতে যান।
    প্রক্সি নাম আপনার এপিআই-এর জন্য প্রদর্শিত নামটি।
  5. বিল্ডের তথ্য পর্যালোচনা করুন এবং বিল্ড-এ ক্লিক করুন।
    সফল হলে, একটি বার্তা প্রদর্শিত হয় এবং Edge স্বয়ংক্রিয়ভাবে আপনার প্রতিষ্ঠানের নির্বাচিত পরিবেশে ইম্পোর্ট করা API প্রক্সিটি স্থাপন করে। API প্রক্সি দ্বারা উন্মুক্ত করা API-টি তখন ব্যবহারের জন্য উপলব্ধ থাকে।
  6. এপিআই প্রক্সির বিস্তারিত পৃষ্ঠাটি দেখতে এডিটরে থাকা <প্রক্সির নাম> প্রক্সিটি দেখুন -এ ক্লিক করুন।
  7. প্রক্সিটি ডেপ্লয় করতে, ডেপ্লয়মেন্ট ড্রপ-ডাউনে ক্লিক করুন, যে এনভায়রনমেন্টে ডেপ্লয় করতে চান তা নির্বাচন করুন এবং প্রম্পটের উত্তর দিন।

একটি SOAP-ভিত্তিক ওয়েব সার্ভিসকে API প্রক্সি হিসেবে প্রকাশ করা

Create Proxy উইজার্ডে, SOAP Service-এ ক্লিক করুন এবং একটি SOAP সার্ভিসের জন্য পাস-থ্রু বা REST-ভিত্তিক প্রক্সি তৈরি করতে উইজার্ডটি অনুসরণ করুন। বিস্তারিত জানতে, Exposing a SOAP service as an API proxy দেখুন।

নিরাপত্তা যোগ করা

ক্রিয়েট প্রক্সি উইজার্ডের কমন পলিসিস (এজ) বা সিকিউরিটি (ক্লাসিক এজ) পেজে, আপনি যে ধরনের নিরাপত্তা অনুমোদন যোগ করতে চান তা নির্বাচন করুন। নিম্নলিখিত সারণিতে উপলব্ধ বিকল্পগুলির একটি সংক্ষিপ্ত বিবরণ দেওয়া হলো:

নিরাপত্তা অনুমোদন বর্ণনা
এপিআই কী আপনার সংজ্ঞায়িত করা এপিআই প্রক্সিতে সহজ এপিআই কী যাচাইকরণ যুক্ত করে। এর প্রতিক্রিয়ায়, এপিআই প্ল্যাটফর্ম আপনার এপিআই প্রক্সিতে একটি VerifyAPIKey পলিসি এবং একটি AssignMessage পলিসি যোগ করে। VerifyAPIKey পলিসিটি অনুরোধকারী অ্যাপগুলো দ্বারা উপস্থাপিত এপিআই কী-গুলো যাচাই করে। AssignMessage পলিসিটি, এপিআই কলে কোয়েরি প্যারামিটার হিসেবে সরবরাহ করা এপিআই কী-টিকে, ব্যাকএন্ড সার্ভারে পাঠানো অনুরোধ থেকে বাদ দিয়ে দেয়।
OAuth 2.0 আপনার এপিআই প্রক্সিতে OAuth 2.0 ভিত্তিক অথেনটিকেশন যোগ করে। Apigee Edge স্বয়ংক্রিয়ভাবে আপনার এপিআই প্রক্সিতে দুটি পলিসি যোগ করে: একটি পলিসি অ্যাক্সেস টোকেন যাচাই করার জন্য এবং অন্যটি আপনার ব্যাকএন্ড সার্ভিসে পাঠানোর আগে মেসেজ থেকে অ্যাক্সেস টোকেনটি সরিয়ে ফেলার জন্য। কীভাবে অ্যাক্সেস টোকেন পেতে হয় তা জানতে, OAuth দেখুন।
অনুমতি ছাড়াই প্রবেশ করুন। কোনো অনুমোদনের প্রয়োজন নেই। Apigee Edge-এ অনুরোধগুলো কোনো নিরাপত্তা যাচাই ছাড়াই ব্যাকএন্ডে পাঠানো হয়।

CORS-এর জন্য সমর্থন যোগ করা

CORS (ক্রস-অরিজিন রিসোর্স শেয়ারিং) হলো একটি স্ট্যান্ডার্ড পদ্ধতি যা একটি ওয়েব ব্রাউজারকে অন্য ডোমেইনে সরাসরি অনুরোধ পাঠাতে সক্ষম করে। CORS স্ট্যান্ডার্ডটি একগুচ্ছ HTTP হেডার সংজ্ঞায়িত করে, যা ওয়েব ব্রাউজার এবং সার্ভারগুলো ক্রস-ডোমেইন যোগাযোগ বাস্তবায়নের জন্য ব্যবহার করে।

ক্রিয়েট প্রক্সি উইজার্ডের কমন পলিসিস (এজ) বা সিকিউরিটি (ক্লাসিক এজ) পেজে অ্যাড CORS হেডারস নির্বাচন করে আপনি আপনার API-তে CORS সাপোর্ট যোগ করতে পারেন।

প্রক্সিতে CORS প্রিফ্লাইট সাপোর্ট যোগ করা সহ CORS সাপোর্ট সম্পর্কে আরও বিস্তারিত তথ্যের জন্য, “Adding CORS support to an API proxy” দেখুন।

প্রক্সি তৈরি করতে ওপেনএপিআই স্পেসিফিকেশন ব্যবহার করা

এই অংশে ‘Use OpenAPI’ অপশনটি নিয়ে আলোচনা করা হয়েছে, যা একটি OpenAPI স্পেসিফিকেশন থেকে নিম্নলিখিত ধরণের এপিআই প্রক্সি তৈরি করার জন্য উপলব্ধ: রিভার্স, নোড.জেএস, অথবা নো টার্গেট।

ওপেনএপিআই স্পেসিফিকেশন বলতে কী বোঝায়?

ওপেন এপিআই ইনিশিয়েটিভ লোগো ওপেন এপিআই ইনিশিয়েটিভ (OAI)-এর মূল লক্ষ্য হলো সোয়াগার স্পেসিফিকেশনের উপর ভিত্তি করে একটি ভেন্ডর-নিরপেক্ষ এপিআই ডেসক্রিপশন ফরম্যাট তৈরি, উন্নত এবং প্রচার করা। ওপেন এপিআই ইনিশিয়েটিভ সম্পর্কে আরও তথ্যের জন্য, https://openapis.org দেখুন।

একটি ওপেনএপিআই স্পেসিফিকেশন একটি RESTful API বর্ণনা করার জন্য একটি স্ট্যান্ডার্ড ফরম্যাট ব্যবহার করে। JSON বা YAML ফরম্যাটে লেখা একটি ওপেনএপিআই স্পেসিফিকেশন মেশিন দ্বারা পাঠযোগ্য, তবে এটি মানুষের জন্যও পড়া এবং বোঝা সহজ। এই স্পেসিফিকেশনটি একটি এপিআই-এর বিভিন্ন উপাদান, যেমন এর বেস পাথ, পাথ ও ভার্ব, হেডার, কোয়েরি প্যারামিটার, অপারেশন, কন্টেন্ট টাইপ, রেসপন্স ডেসক্রিপশন এবং আরও অনেক কিছু বর্ণনা করে। এছাড়াও, এপিআই ডকুমেন্টেশন তৈরি করার জন্য একটি ওপেনএপিআই স্পেসিফিকেশন সাধারণত ব্যবহৃত হয়।

এখানে একটি ওপেনএপিআই স্পেসিফিকেশনের অংশবিশেষ দেওয়া হলো, যা Apigee-এর মক টার্গেট সার্ভিস, http://mocktarget.apigee.net-এর বর্ণনা দেয়। আরও তথ্যের জন্য, দেখুন https://github.com/apigee/api-platform-samples/tree/master/default-proxies/helloworld/openapi

openapi: 3.0.0
info:
  description: OpenAPI Specification for the Apigee mock target service endpoint.
  version: 1.0.0
  title: Mock Target API
paths:
  /:
    get:
      summary: View personalized greeting
      operationId: View a personalized greeting
      description: View a personalized greeting for the specified or guest user.
      parameters:
        - name: user
          in: query
          description: Your user name.
          required: false
          schema:
            type: string
      responses:
        "200":
          description: Success
  /help:
    get:
      summary: Get help
      operationId: Get help
      description: View help information about available resources in HTML format.
      responses:
        "200":
          description: Success
...

ক্রিয়েট প্রক্সি উইজার্ডের মাধ্যমে, আপনি একটি ওপেনএপিআই স্পেসিফিকেশন ইম্পোর্ট করতে পারেন এবং এটি ব্যবহার করে একটি এপিআই প্রক্সি তৈরি করতে পারেন। প্রক্সিটি তৈরি হয়ে গেলে, আপনি এজ ইউআই ব্যবহার করে পলিসি যোগ করা, কাস্টম কোড প্রয়োগ করা ইত্যাদির মাধ্যমে এটিকে আরও উন্নত করতে পারেন — ঠিক যেকোনো এজ প্রক্সির মতোই।

একটি ওপেনএপিআই স্পেসিফিকেশন থেকে একটি এপিআই প্রক্সি তৈরি করা

একটি ওপেনএপিআই স্পেসিফিকেশন থেকে আপনার এপিআই প্রক্সি তৈরি করুন। মাত্র কয়েকটি ক্লিকেই, আপনি স্বয়ংক্রিয়ভাবে তৈরি পাথ, প্যারামিটার, কন্ডিশনাল ফ্লো এবং টার্গেট এন্ডপয়েন্টসহ একটি এপিআই প্রক্সি পেয়ে যাবেন। এরপর, আপনি OAuth নিরাপত্তা, রেট লিমিটিং এবং ক্যাশিং-এর মতো ফিচারগুলো যোগ করতে পারবেন।

ক্রিয়েট প্রক্সি উইজার্ডে, ইউজ ওপেনএপিআই স্পেক-এ ক্লিক করুন এবং একটি ওপেনএপিআই স্পেসিফিকেশন থেকে একটি রিভার্স বা নো টার্গেট প্রক্সি তৈরি করতে উইজার্ডটি অনুসরণ করুন। বিস্তারিত জানার জন্য, ক্রিয়েট অ্যান এপিআই প্রক্সি ফ্রম অ্যান ওপেনএপিআই স্পেসিফিকেশন দেখুন।

একটি OpenAPI স্পেসিফিকেশন থেকে কীভাবে এপিআই প্রক্সি তৈরি করতে হয়, তা জানতে এই ভিডিওটি দেখুন।

একটি ওপেনএপিআই স্পেসিফিকেশন ব্যবহার করে এপিআই প্রক্সিতে ফ্লো আপডেট করা

একটি OpenAPI স্পেসিফিকেশন থেকে একটি API প্রক্সি তৈরি করার পরে, যদি আপনি অতিরিক্ত রিসোর্স পাথ যোগ করার জন্য স্পেসিফিকেশনটি পরিবর্তন করেন, তাহলে আপনি সেই স্পেসিফিকেশনটি ব্যবহার করে API প্রক্সিতে সংশ্লিষ্ট কন্ডিশনাল ফ্লো যোগ করতে পারবেন।

একটি ওপেনএপিআই স্পেসিফিকেশন ব্যবহার করে এপিআই প্রক্সিতে ফ্লো আপডেট করতে:

  1. OpenAPI স্পেসিফিকেশনে নতুন রিসোর্স পাথগুলো যোগ করুন। বিদ্যমান OpenAPI স্পেসিফিকেশন সম্পাদনা দেখুন।
  2. UI-তে API Proxy-টি খুলুন এবং Develop ট্যাবে ক্লিক করুন।
  3. নেভিগেটরে, আপনি যে প্রক্সি এন্ডপয়েন্টটি আপডেট করতে চান তার পাশে থাকা + চিহ্নে ক্লিক করুন।
    নতুন কন্ডিশনাল ফ্লো ডায়ালগ বক্সটি খোলে।
  4. যদি আগে থেকে নির্বাচিত না থাকে, তাহলে OpenAPI থেকে ক্লিক করুন।
    যদি OpenAPI স্পেসিফিকেশনে এমন কোনো রিসোর্স থাকে যার জন্য এপিআই প্রক্সিতে কোনো সংশ্লিষ্ট শর্তাধীন ফ্লো নেই, তাহলে সেগুলো ডায়ালগে তালিকাভুক্ত করা হয়, যেমনটি নিম্নলিখিত চিত্রে দেখানো হয়েছে। যেসব রিসোর্স বর্তমান এপিআই প্রক্সিতে ফ্লো হিসেবে উপস্থাপিত নয়। এই উদাহরণে রয়েছে /loveapis, /ip, /json, এবং /xml।
  5. যেসব রিসোর্সের জন্য আপনি শর্তসাপেক্ষ ফ্লো যোগ করতে চান, সেগুলোর প্রত্যেকটি নির্বাচন করুন।
  6. যোগ করুন-এ ক্লিক করুন।

শর্তসাপেক্ষ ফ্লোগুলো আপনার এপিআই প্রক্সিতে যোগ করা হয়।

এপিআই প্রক্সির একটি নতুন সংস্করণ তৈরি করা

নিচে বর্ণিত পদ্ধতি অনুসারে একটি এপিআই প্রক্সির নতুন সংস্করণ তৈরি করুন।

প্রান্ত

Edge UI ব্যবহার করে একটি API প্রক্সির নতুন সংস্করণ তৈরি করতে:

  1. apigee.com/edge- এ সাইন ইন করুন।
  2. বাম দিকের নেভিগেশন বার থেকে Develop > API Proxys নির্বাচন করুন।
  3. তালিকা থেকে যে এপিআই প্রক্সিটি কপি করতে চান, সেটিতে ক্লিক করুন।
  4. প্রজেক্ট নির্বাচন করুন > নতুন রিভিশন হিসেবে সংরক্ষণ করুন

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

ক্লাসিক এজ UI ব্যবহার করে একটি API প্রক্সির নতুন সংস্করণ তৈরি করতে:

  1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম।
  2. উপরের নেভিগেশন বারে APIs > API Proxys নির্বাচন করুন।
  3. তালিকা থেকে যে এপিআই প্রক্সিটি কপি করতে চান, সেটিতে ক্লিক করুন।
  4. প্রজেক্ট নির্বাচন করুন > নতুন রিভিশন হিসেবে সংরক্ষণ করুন

একটি এপিআই প্রক্সি কপি করা

নিচে বর্ণিত পদ্ধতি অনুসারে একটি বিদ্যমান এপিআই প্রক্সিকে একটি নতুন এপিআই প্রক্সিতে কপি করুন।

প্রান্ত

Edge UI ব্যবহার করে একটি API প্রক্সি কপি করতে:

  1. apigee.com/edge- এ সাইন ইন করুন।
  2. বাম দিকের নেভিগেশন বার থেকে Develop > API Proxys নির্বাচন করুন।
  3. তালিকা থেকে যে এপিআই প্রক্সিটি কপি করতে চান, সেটিতে ক্লিক করুন।
  4. প্রজেক্ট নির্বাচন করুন > নতুন এপিআই প্রক্সি হিসাবে সংরক্ষণ করুন
  5. 'Save as New Proxy' ডায়ালগ বক্সে নতুন API প্রক্সির নামটি লিখুন।
  6. যোগ করুন-এ ক্লিক করুন।

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

ক্লাসিক এজ UI ব্যবহার করে একটি API প্রক্সি কপি করতে:

  1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হলো ম্যানেজমেন্ট সার্ভার নোডের আইপি অ্যাড্রেস বা ডিএনএস নেম।
  2. উপরের নেভিগেশন বারে APIs > API Proxys নির্বাচন করুন।
  3. তালিকা থেকে যে এপিআই প্রক্সিটি কপি করতে চান, সেটিতে ক্লিক করুন।
  4. প্রজেক্ট নির্বাচন করুন > নতুন এপিআই প্রক্সি হিসাবে সংরক্ষণ করুন
  5. 'Save as New Proxy' ডায়ালগ বক্সে নতুন API প্রক্সির নামটি লিখুন।
  6. যোগ করুন-এ ক্লিক করুন।

একটি এপিআই প্রক্সি ব্যাক আপ করা

আপনি একটি বিদ্যমান এপিআই প্রক্সিকে একগুচ্ছ এক্সএমএল ফাইল হিসেবে একটি এপিআই প্রক্সি বান্ডেলে ব্যাক আপ করতে পারেন। একবার বান্ডেলে এক্সপোর্ট করা হয়ে গেলে, আপনি এপিআই প্রক্সিটিকে একটি নতুন প্রক্সিতে ইম্পোর্ট করতে পারেন, যেমনটি এই বিভাগের পূর্ববর্তী অংশে ‘এপিআই প্রক্সি বান্ডেল থেকে এপিআই প্রক্সি ইম্পোর্ট করা’ অংশে বর্ণনা করা হয়েছে। আরও তথ্যের জন্য, ‘এপিআই প্রক্সি ডাউনলোড করুন’ দেখুন।

এপিআই ব্যবহার করে একটি এপিআই প্রক্সি তৈরি করা

এপিআই ব্যবহার করে একটি এপিআই প্রক্সি তৈরি করতে, এপিআই প্রক্সি এপিআই (API proxyes API) দেখুন।