আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
Apigee Edge-এ কোনও সংস্থা হল সবচেয়ে উপরের লেভেলের কন্টেনার। এতে আপনার সব API প্রক্সি ও সম্পর্কিত রিসোর্স থাকে। এই বিষয়ের বাকি অংশে সংস্থা সম্পর্কে আরও বিস্তারিত আলোচনা করা হয়েছে, এখানে কয়েকটি ব্যবহারিক পয়েন্ট দেওয়া হল:
- ডিফল্ট হিসেবে, আপনার API প্রক্সি কল করার জন্য ব্যবহৃত URL-এ আপনার সংস্থার নাম থাকে, যেমন
ভার্চুয়াল হোস্ট সম্পর্কে নিবন্ধে বর্ণনা করা হয়েছে।
যেমন:
http(s)://your_org_name-environment.apigee.net/proxy_base_path/...
- Edge ম্যানেজমেন্ট UI-এর URL-এ আপনার সংস্থার নাম থাকে। যেমন, নিম্নলিখিত URL-এ
docsসংস্থার API প্রক্সি দেখানো হয়েছে:
- আপনি হয়ত একটিই প্রতিষ্ঠান তৈরি করেছেন, কিন্তু নির্দিষ্ট অনুমতি সহ ব্যবহারকারী বা অ্যাডমিনিস্ট্রেটর হিসেবে অন্যান্য প্রতিষ্ঠানের সাথেও যুক্ত থাকতে পারেন। Edge ম্যানেজমেন্ট UI-তে, আপনি যদি একাধিক সংস্থার সাথে যুক্ত থাকেন, তাহলে আপনার সংস্থার মধ্যে পরিবর্তন করা নিবন্ধে বর্ণিত পদ্ধতি অনুসরণ করে অন্য সংস্থায় পরিবর্তন করতে পারবেন।
- আপনি যখন ম্যানেজমেন্ট API-এর মাধ্যমে কোনও কল করেন এবং আপনার ভূমিকা হল অর্গানাইজেশন অ্যাডমিনিস্ট্রেটর
তখন বেশিরভাগ কলের ক্ষেত্রে পাথ-এর মধ্যে অর্গানাইজেশন থাকা আবশ্যক। যেমন, নিম্নলিখিত
ম্যানেজমেন্ট API cURL অনুরোধ কোনও সংস্থার মধ্যে থাকা সব API প্রক্সির একটি তালিকা রিটার্ন করে:
curl https://api.enterprise.apigee.com/v1/organizations/your_org_name/apis -u org_admin_email_address
ভিডিও: API ম্যানেজমেন্টের জন্য কীভাবে কোনও সংস্থা মাল্টি-টেনেন্সি আর্কিটেকচার ব্যবহার করে তা জানতে একটি ছোট ভিডিও দেখুন।
সংগঠনের উপাদান
আপনি Edge অ্যাকাউন্ট তৈরি করলে, Edge অটোমেটিক আপনার জন্য একটি সংস্থা তৈরি করে। তৈরি হয়ে গেলে, আপনি নিজের সংস্থায় ব্যবহারকারী যোগ করতে, API প্রক্সি ও API প্রোডাক্ট তৈরি করতে এবং ডেভেলপার ও অ্যাপ রেজিস্টার করতে পারবেন।
নিচের ছবিতে Edge সাংগঠনিক মডেলের প্রধান কম্পোনেন্ট দেখানো হয়েছে। এই মডেলটি Edge-এর মধ্যে আপনার API, API প্রোডাক্ট, অ্যাপ এবং অ্যাপ ডেভেলপাররা কীভাবে একে অপরের সাথে সম্পর্কিত তা নির্ধারণ করে।
এই মডেলে Apigee Edge-এর সব ফিচার দেখানো হয় না। আপনি মনিটাইজেশন ব্যবহার করলে, মডেলটিতে অতিরিক্ত কম্পোনেন্ট থাকবে। আরও তথ্যের জন্য, মনিটাইজেশনের ওভারভিউ দেখুন। মনিটাইজেশনের মাধ্যমে কোম্পানি ও ডেভেলপার ম্যানেজ করা সংক্রান্ত তথ্যের জন্য কোম্পানি ও ডেভেলপার ম্যানেজ করুন লিঙ্কে দেখুন।
সংস্থার নাম
সংস্থার নাম হল:
- মূল্যায়নকারী সংস্থা:
username-eval - পেমেন্ট করা সংস্থা: প্রাথমিক প্রভিশনিংয়ের সময় ব্যবহারকারীর দ্বারা সংজ্ঞায়িত
তৈরি করা হয়ে গেলে, আপনি কোনও সংস্থার নাম পরিবর্তন করতে পারবেন না।
আপনার API প্রক্সি এবং Edge ম্যানেজমেন্ট API-তে অনুরোধ করার সময় URL-এর অংশ হিসেবে সংস্থার নাম ব্যবহার করা হয়। যেমন, API প্রক্সি অ্যাক্সেস করার জন্য ব্যবহৃত একটি সাধারণ URL-এর ফর্ম হল:
http://org-name-env.apigee.net/v1/weather/forecastrss
কোথায়:
- org-name হল আপনার প্রতিষ্ঠানের নাম।
- env হল API প্রক্সির ডিপ্লয়মেন্ট এনভায়রনমেন্ট, যা হয় টেস্ট বা প্রোডাকশন।
যেমন:
http://myorg-test.apigee.net/v1/weather/forecastrss
সংগঠনের উপাদান
নিচের সারণীতে সাংগঠনিক মডেলের কম্পোনেন্ট সম্পর্কে আরও বিস্তারিত বিবরণ দেওয়া হল:
| কম্পোনেন্ট | বিবরণ |
|---|---|
|
সংগঠন |
প্রতিটি Apigee অ্যাকাউন্ট, Apigee Edge-এ এক বা একাধিক সংস্থার সাথে ম্যাপ করে। সংস্থা API প্রক্সি, API প্রোডাক্ট, API প্যাকেজ, অ্যাপ ও ডেভেলপার সহ সব কম্পোনেন্টের একটি করে রেপ্রেজেন্টেশন থাকে। অ্যাকাউন্ট হোল্ডাররা একটি সংস্থার মধ্যে সীমাবদ্ধ নন। কিছু অ্যাকাউন্ট হোল্ডার একাধিক সংস্থা সংজ্ঞায়িত করতে বা সেগুলির সদস্য হতে পারেন যা বিভিন্ন অ্যাপ ডেভেলপার কমিউনিটিকে সহায়তা করে। |
| পরিবেশ | কোনও সংস্থার API প্রক্সির জন্য রানটাইম এক্সিকিউশন কনটেক্সট। এনভায়র্নমেন্ট সম্পর্কে আরও জানতে, নিচে দেওয়া বিভাগ দেখুন। |
|
ব্যবহারকারী |
কোনও প্রতিষ্ঠানের মধ্যে, যেখানে অ্যাকাউন্ট তৈরি করা ব্যক্তি অটোমেটিক একজন অ্যাডমিনিস্ট্রেটর, সেখানে আপনি আরও ব্যবহারকারী তৈরি করতে পারবেন। ব্যবহারকারীরা সংস্থার API টিম তৈরি করেন, যার মধ্যে অ্যাডমিনিস্ট্রেটর, API প্রক্সি ও API প্রোডাক্ট ক্রিয়েটর, অ্যানালিটিক্স ও অন্যান্য পরিসংখ্যান মনিটর করা ব্যবহারকারী এবং অন্যান্য ব্যক্তি অন্তর্ভুক্ত থাকতে পারেন। বিভিন্ন ব্যবহারকারীর বিভিন্ন ভূমিকা ও অ্যাক্সেস প্রিভিলেজ থাকতে পারে। যেমন, কিছু ব্যবহারকারীকে সংস্থা অ্যাডমিনিস্ট্রেটর ও অপারেশন অ্যাডমিনিস্ট্রেটর হিসেবে সংজ্ঞায়িত করুন যাদের কাছে সংস্থা ও এর কম্পোনেন্ট পরিবর্তন করার বিশেষ সুবিধা আছে। API প্রক্সি ও API প্রোডাক্ট তৈরি করার অনুমতি আছে, কিন্তু অন্য ব্যবহারকারীদের পরিবর্তন করার বিশেষ অধিকার নেই, এমন ব্যবহারকারীদের সংজ্ঞা দিন। ব্যবহারকারী একাধিক প্রতিষ্ঠানের মেম্বার হতে পারেন। যেমন, আপনার কোম্পানি বিভিন্ন ডেভেলপার কমিউনিটিকে সহায়তা করতে Apigee Edge-এ একাধিক সংস্থা নির্ধারণ করতে পারে। তবে, ইন্টার্নালি একই ব্যক্তিরা সব API প্রক্সি ও API প্রোডাক্ট তৈরি করেন এবং সেই জন্য তারা আপনার সব সংস্থার মেম্বার। ব্যবহারকারী হওয়ার জন্য আপনাকে Apigee অ্যাকাউন্ট—অর্থাৎ, Apigee সংস্থা—তৈরি করতে হবে না। অ্যাডমিনিস্ট্রেটর আপনাকে আগে থেকে থাকা সংস্থায় যোগ করতে পারেন। সব ব্যবহারকারী এখানে Apigee Edge-এ লগ-ইন করেন: https://enterprise.apigee.com. |
|
API প্রক্সি |
কোনও সংস্থার ব্যবহারকারীরা এক বা একাধিক API প্রক্সি তৈরি করেন। API প্রক্সি একটি সর্বজনীনভাবে উপলভ্য HTTP এন্ডপয়েন্টের সাথে ব্যাকএন্ড পরিষেবার ম্যাপিং নির্ধারণ করে। এছাড়াও, API প্রক্সি নিরাপত্তা (যেমন OAuth) অন্তর্ভুক্ত করার জন্য কনফিগার করা যেতে পারে, মেসেজ ট্রান্সফর্মেশন (যেমন XML থেকে JSON) পারফর্ম করতে, ব্যাকএন্ড পরিষেবায় ট্রাফিক সীমিত করতে এবং অনুরোধ, উত্তর ও পরিষেবা কলআউটে অন্যান্য মূল্যবান অপারেশন পারফর্ম করতে পারে। API প্রক্সি সংক্রান্ত অ্যানালিটিক্সের জন্য Edge ডেটা সংগ্রহ করে। |
|
API প্রোডাক্ট |
কোনও সংস্থার ব্যবহারকারীরা এক বা একাধিক API প্রোডাক্ট তৈরি করেন, যেখানে API প্রোডাক্ট হল API প্রক্সি ও পরিষেবা প্ল্যানের একটি বান্ডেল। সেই পরিষেবা প্ল্যান API প্রক্সি অ্যাক্সেস করার সীমা সেট করতে, নিরাপত্তা প্রদান করতে, মনিটরিং ও অ্যানালিটিক্স করার অনুমতি দিতে এবং অতিরিক্ত ফিচার প্রদান করতে পারে। API প্রোডাক্টের অ্যানালিটিক্সের জন্য Edge ডেটা সংগ্রহ করে। |
|
ডেভেলপার |
কোনও প্রতিষ্ঠানে এক বা একাধিক ডেভেলপার থাকেন যারা আপনার প্রতিষ্ঠানের দ্বারা নির্ধারিত API (API প্রোডাক্টে অ্যাসেম্বল করা) ব্যবহার করে অ্যাপ তৈরি করেন। ডেভেলপাররা API ব্যবহার করেন কিন্তু API তৈরি করতে বা প্রতিষ্ঠানে অন্য কোনও অ্যাকশন পারফর্ম করতে পারেন না। ডেভেলপাররা আপনার কোম্পানির ইন্টার্নাল হতে পারে, তারা পার্টনার হতে পারে অথবা তারা এক্সটার্নাল ডেভেলপার হতে পারে যারা আপনার API অ্যাক্সেস করার জন্য পেমেন্ট করে। ডেভেলপারদের আপনার সংস্থায় রেজিস্টার করতে হবে, তবেই তারা কোনও অ্যাপ রেজিস্টার করতে এবং আপনার API অ্যাক্সেস করার জন্য API কী পেতে পারবেন। API প্রদানকারী হিসেবে, আপনার সংস্থার ডেভেলপারদের কীভাবে যোগ, আপডেট বা সরাতে হবে তা নির্ধারণ করার দায়িত্ব আপনার। আপনি Edge ম্যানেজমেন্ট UI-এর মাধ্যমে সেগুলি ম্যানুয়ালি যোগ করতে পারেন, ওয়েবসাইটের মাধ্যমে সেগুলি রেজিস্টার করার জন্য ডেভেলপার পোর্টাল তৈরি করতে পারেন অথবা Edge ম্যানেজমেন্ট API ব্যবহার করে নিজের রেজিস্ট্রেশন মেকানিজম নির্ধারণ করতে পারেন। ডেভেলপারের Edge-এ অ্যাকাউন্ট থাকার প্রয়োজন নেই এবং বেশিরভাগ ডেভেলপারদের Edge সম্পর্কে কিছু জানার প্রয়োজন হবে না। ডেভেলপারের Edge-এ অ্যাকাউন্ট থাকলে, সেটি সাধারণত অন্য কোনও সংস্থার ব্যবহারকারী হিসেবে অথবা Edge API পরিষেবা ব্যবহার করার জন্য থাকে। |
|
অ্যাপ |
ডেভেলপাররা এক বা একাধিক ক্লায়েন্ট অ্যাপ তৈরি করেন যা আপনার API ব্যবহার করে। ডেভেলপারদের আপনার প্রতিষ্ঠানের সাথে তাদের অ্যাপ রেজিস্টার করতে হবে। Edge-এ অ্যাপ হল ডেভেলপারের আসল অ্যাপের একটি উপস্থাপনা যা ডেভেলপারকে একটি API কী প্রদান করে যা আপনার API-তে প্রতিটি অনুরোধের সাথে পাস করতে হয়। যেহেতু আপনার প্রতিষ্ঠানে সব অ্যাপ রেজিস্টার করা আছে, তাই আপনি Edge ব্যবহার করে অ্যাপ এবং আপনার API-এর ব্যবহার সম্পর্কে অ্যানালিটিক তথ্য মনিটর ও সংগ্রহ করতে পারবেন। |
|
API key/OAuth টোকেন |
আপনার API-এর জন্য আপনি যে অনুমোদন পদ্ধতি নির্ধারণ করেন তার উপর নির্ভর করে, অ্যাপটি আপনার API-তে প্রতিটি অনুরোধের সাথে একটি API কী পাস করে। সেই কীটি সঠিক হলে, অনুরোধটি অনুমতি পায়। Edge বিভিন্ন ধরনের যাচাইকরণ পদ্ধতি ব্যবহার করে, যেমন সাধারণ API কী, টু-লেগড OAuth, থ্রি-লেগড OAuth এবং আরও অনেক কিছু। API প্রদানকারী হিসেবে, আপনাকে অবশ্যই ডেভেলপারদের অ্যাপ রেজিস্টার করার একটি উপায় নির্ধারণ করতে হবে। এটি ডেভেলপারকে তার অ্যাপ রেজিস্টার করার মাধ্যমে প্রদান করা হয়। এর ফলে, আপনার API অ্যাক্সেস করার জন্য প্রয়োজনীয় কী ডেভেলপারকে ফেরত দেওয়া হয়। অ্যাপ রেজিস্ট্রেশনের সময়, ডেভেলপার একটি API প্রোডাক্ট বা একাধিক API প্রোডাক্ট অ্যাক্সেস করার বিকল্প বেছে নিতে পারেন। ডেভেলপারের আসল অ্যাপ, অ্যাপের সাথে যুক্ত সব API প্রোডাক্ট (Edge-এ ডেভেলপারের অ্যাপের রেজিস্টার করা রেপ্রেজেন্টেশন) অ্যাক্সেস করার জন্য একই কী ব্যবহার করে। আপনি যেকোনও সময় কী সরিয়ে দিতে পারেন যাতে ডেভেলপারের অ্যাপ আর আপনার API অ্যাক্সেস করতে না পারে (যদিও ডেভেলপারের অ্যাপের রেজিস্টার করা উপস্থাপনা এখনও আপনার সংস্থায় থাকে)। অথবা, আপনি কোনও কী-তে সময়সীমা নির্ধারণ করতে পারেন যাতে ডেভেলপারকে নির্দিষ্ট সময় পরে কী রিফ্রেশ করতে হয়। |
এনভায়রনমেন্ট সম্পর্কে
এনভায়রনমেন্ট হল কোনও সংস্থার API প্রক্সির জন্য রানটাইম এক্সিকিউশন কনটেক্সট। অ্যাক্সেস করার আগে আপনাকে অবশ্যই কোনও এনভায়রনমেন্টে API প্রক্সি ডেপ্লয় করতে হবে। আপনি একটি বা একাধিক এনভায়রনমেন্টে API প্রক্সি ডেপ্লয় করতে পারবেন।
কোনও প্রতিষ্ঠানে একাধিক এনভায়রনমেন্ট থাকতে পারে। যেমন, আপনি কোনও প্রতিষ্ঠানে dev,
test ও prod এনভায়র্নমেন্ট নির্ধারণ করতে পারেন।
সংস্থা কিছু Apigee কেপেবিলিটির সুযোগ প্রদান করে। যেমন, কী-ভ্যালু-ম্যাপ (KVM) ডেটা অর্গানাইজেশন লেভেলে উপলভ্য করা যেতে পারে, এর অর্থ হল, যেকোনও এনভায়রনমেন্টে ডেপ্লয় করা API প্রক্সি KVM থেকে একই ডেটা পাবে। ক্যাশিংয়ের মতো কিছু ক্ষমতাকে সংস্থা বা সংস্থার মধ্যে নির্দিষ্ট কোনও এনভায়রনমেন্টের মধ্যে সীমাবদ্ধ করা যেতে পারে। সংস্থা ও এনভায়রনমেন্টের সমন্বয়ে Apigee অ্যানালিটিক্স ডেটা ভাগ করা হয়।
নিচে কোনও সংস্থার মধ্যে আপনার ম্যানেজ করা প্রধান এন্টিটি দেখানো হল, এর মধ্যে সেইসব এন্টিটিও আছে যেগুলি সংস্থায় বিশ্বব্যাপী এবং কোনও এনভায়রনমেন্টে নির্দিষ্টভাবে সংজ্ঞায়িত করা হয়েছে:
