আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
Apigee Edge আপনাকে 'পলিসি' ব্যবহার করে কোনো কোড না লিখেই API-এর আচরণ 'প্রোগ্রাম' করার সুযোগ দেয়। একটি পলিসি হলো একটি মডিউলের মতো, যা একটি নির্দিষ্ট ও সীমিত ব্যবস্থাপনা ফাংশন প্রয়োগ করে। পলিসিগুলো এমনভাবে ডিজাইন করা হয়েছে যাতে আপনি একটি API-তে সহজে এবং নির্ভরযোগ্যভাবে সাধারণ ধরনের ব্যবস্থাপনা সক্ষমতা যোগ করতে পারেন। পলিসিগুলো নিরাপত্তা, রেট-লিমিটিং, ট্রান্সফরমেশন এবং মিডিয়েশনের মতো ফিচার প্রদান করে, যার ফলে আপনাকে নিজে থেকে এই কার্যকারিতাগুলোর জন্য কোড লিখতে ও রক্ষণাবেক্ষণ করতে হয় না।
আপনি Apigee Edge দ্বারা প্রদত্ত পলিসি প্রকারের মধ্যেই সীমাবদ্ধ নন। আপনি কাস্টম স্ক্রিপ্ট এবং কোডও (যেমন জাভাস্ক্রিপ্ট এবং Node.js অ্যাপ্লিকেশন) লিখতে পারেন, যা API প্রক্সি কার্যকারিতা প্রসারিত করে এবং Apigee Policies দ্বারা সমর্থিত মৌলিক ব্যবস্থাপনা ক্ষমতার উপরে আপনাকে নতুন কিছু উদ্ভাবন করতে সক্ষম করে।
পলিসি সংযুক্তি ও প্রয়োগ সম্পর্কে প্রাথমিক ধারণা পেতে এই ভিডিওটি দেখুন।
নীতির প্রকারভেদ
প্রযুক্তিগতভাবে, একটি পলিসি হলো একটি XML-ফরম্যাট করা কনফিগারেশন ফাইল। প্রতিটি পলিসি টাইপের কাঠামো (উদাহরণস্বরূপ, প্রয়োজনীয় এবং ঐচ্ছিক কনফিগারেশন উপাদানসমূহ) একটি XML স্কিমা দ্বারা সংজ্ঞায়িত করা হয়। আপনি যদি XML টুলস ব্যবহারে পারদর্শী হন, তবে গিটহাবে থাকা API প্ল্যাটফর্ম স্যাম্পলগুলোর পলিসি স্কিমাগুলোর সাথে পরিচিত হয়ে নেওয়া লাভজনক হবে।
এজ পলিসির প্রকারভেদগুলোকে নিম্নলিখিত কার্যকরী বিভাগগুলিতে ভাগ করা হয়েছে:
ট্র্যাফিক ব্যবস্থাপনা
ট্র্যাফিক ম্যানেজমেন্ট ক্যাটাগরির পলিসিগুলো আপনাকে একটি এপিআই প্রক্সির মাধ্যমে অনুরোধ এবং প্রতিক্রিয়া বার্তার প্রবাহ নিয়ন্ত্রণ করতে সক্ষম করে। এই পলিসিগুলো অপারেশনাল এবং বিজনেস-লেভেল উভয় নিয়ন্ত্রণই সমর্থন করে। এগুলো আপনাকে র ডেটা থ্রুপুটের উপর নিয়ন্ত্রণ দেয় এবং অ্যাপ-ভিত্তিক ট্র্যাফিকও নিয়ন্ত্রণ করতে পারে। ট্র্যাফিক ম্যানেজমেন্ট পলিসির প্রকারভেদগুলো আপনাকে কোটা প্রয়োগ করতে সক্ষম করে এবং ডিনায়াল অফ সার্ভিস অ্যাটাক প্রতিরোধ করতেও সহায়তা করে।
নিরাপত্তা
নিরাপত্তা বিভাগের নীতিমালাগুলো প্রমাণীকরণ, অনুমোদন এবং বিষয়বস্তু-ভিত্তিক নিরাপত্তাকে সমর্থন করে।
মধ্যস্থতা
মিডিয়েশন ক্যাটাগরির পলিসিগুলো আপনাকে এপিআই প্রক্সির মধ্য দিয়ে প্রবাহিত হওয়ার সময় মেসেজগুলোকে সক্রিয়ভাবে নিয়ন্ত্রণ করার সুযোগ দেয়। এগুলো আপনাকে মেসেজের ফরম্যাট পরিবর্তন করতে, যেমন XML থেকে JSON-এ (এবং এর বিপরীতক্রমে), অথবা একটি XML ফরম্যাটকে অন্য XML ফরম্যাটে রূপান্তর করতে সক্ষম করে। এছাড়াও, এগুলো আপনাকে মেসেজ পার্স করতে, নতুন মেসেজ তৈরি করতে এবং বহির্গামী মেসেজের মান পরিবর্তন করতে সাহায্য করে। মিডিয়েশন পলিসিগুলো এপিআই সার্ভিস দ্বারা উন্মুক্ত করা মৌলিক পরিষেবাগুলোর সাথেও যোগাযোগ স্থাপন করে, যার ফলে আপনি রানটাইমে অ্যাপ, ডেভেলপার, সিকিউরিটি টোকেন এবং এপিআই প্রোডাক্ট সম্পর্কিত ডেটা পুনরুদ্ধার করতে পারেন।
সম্প্রসারণ
এক্সটেনশন ক্যাটাগরির পলিসিগুলো আপনাকে এপিআই সার্ভিসগুলোর সম্প্রসারণযোগ্যতা কাজে লাগিয়ে আপনার পছন্দের প্রোগ্রামিং ভাষায় কাস্টম আচরণ বাস্তবায়ন করতে সক্ষম করে।
প্রতিটি পলিসি টাইপ পলিসি রেফারেন্স ওভারভিউ- তে বিস্তারিতভাবে নথিভুক্ত করা আছে। এই টপিকটিতে সাধারণ ইন্টারঅ্যাকশন দেখানো হয়েছে, যেখানে পলিসি তৈরি করা এবং একটি এপিআই প্রক্সি কনফিগারেশনে সেগুলোকে ফ্লো-এর সাথে সংযুক্ত করার পদ্ধতি তুলে ধরা হয়েছে।
নীতি পরিবর্তন বাস্তবায়ন করা
পলিসি পরিবর্তন কার্যকর করার জন্য, আপনাকে অবশ্যই একটি এনভায়রনমেন্টে এপিআই প্রক্সি রিভিশনটি ডিপ্লয় করতে হবে। কোনো পলিসি সংযুক্ত করার পর বা বিদ্যমান পলিসিতে পরিবর্তন আনার পর, পরিবর্তনগুলো ডিপ্লয় করতে ম্যানেজমেন্ট UI অথবা ম্যানেজমেন্ট API ব্যবহার করুন।
নীতি প্রয়োগ যাচাই করা
একটি পলিসি সঠিকভাবে প্রয়োগ করা হয়েছে কিনা তা যাচাই করতে, একটি HTTP ক্লায়েন্টের মাধ্যমে API-টি কল করতে হবে। এই কোটা কনফিগারেশনটি যাচাই করার জন্য, কোটা পলিসিতে আপনার সেট করা কোটার সীমা অতিক্রম করে API-তে একাধিক অনুরোধ জমা দিন। (নিচের অনুরোধটিতে, ProxyEndpoint-এ বেস পাথ সেটিং হিসাবে কনফিগার করা URI পাথটি হলো /weather )।
http://{org_name}-test.apigee.net/weather/forecastrss?w=12797282এক মিনিটের মধ্যে একাধিক অনুরোধ জমা দেওয়ার পর, আপনি নিম্নলিখিত ত্রুটি বার্তাটি দেখতে পাবেন:
{
"fault":{
"faultstring":"policies.ratelimit.QuotaViolation",
"detail":{
"errorcode":"policies.ratelimit.QuotaViolation"
}
}
}এটি নির্দেশ করে যে এপিআই সার্ভিসগুলো দ্বারা কোটা নীতি প্রয়োগ করা হচ্ছে।
নীতি-ভিত্তিক ত্রুটি পরিচালনা
উপরের এরর মেসেজটির ফরম্যাটটি লক্ষ্য করুন। এতে একটি faultstring প্রপার্টি এবং একটি errorcode প্রপার্টি রয়েছে। অনেক ক্ষেত্রে, এই এররগুলো হ্যান্ডেল করার জন্য আপনাকে কিছু ব্যবস্থা গ্রহণ করতে হবে। উদাহরণস্বরূপ, আপনি এমন কোনো ডেভেলপারকে একটি কাস্টমাইজড মেসেজ পাঠাতে চাইতে পারেন, যার অ্যাপ কোটা অতিক্রম করেছে।
ত্রুটি পরিচালনা সম্পর্কে আরও জানতে, ত্রুটি পরিচালনা দেখুন।
সর্বোত্তম অনুশীলন: সাধারণ নীতি সেট
মৌলিক ব্যবস্থাপনার প্রয়োজনীয়তা মেটাতে, এপিআই প্রক্সিগুলো সাধারণত নিম্নলিখিত নীতিগুলো প্রয়োগ করে থাকে:
বেসিক এপিআই কী যাচাইকরণ
প্রক্সিএন্ডপয়েন্ট অনুরোধ প্রবাহ:- স্পাইকঅ্যারেস্ট
- XMLThreatProtection অথবা JSONThreatProtection
- এপিআই কী যাচাইকরণ
- কোটা
- প্রতিক্রিয়া ক্যাশে
- প্রতিক্রিয়া ক্যাশে
মৌলিক রূপান্তর: JSON থেকে XML
অনুরোধ প্রবাহ:- স্পাইকঅ্যারেস্ট
- JSONThreatProtection
- এপিআই কী যাচাইকরণ
- কোটা
- JSONToXML
- XMLToJSON
- প্রতিক্রিয়া ক্যাশে