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