একটি নীতি কি?

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

Apigee Edge আপনাকে 'পলিসি' ব্যবহার করে কোনো কোড না লিখে API আচরণ 'প্রোগ্রাম' করতে সক্ষম করে। একটি নীতি একটি মডিউলের মতো যা একটি নির্দিষ্ট, সীমিত ব্যবস্থাপনা ফাংশন প্রয়োগ করে। নীতিগুলি এমনভাবে ডিজাইন করা হয়েছে যাতে আপনি সহজে এবং নির্ভরযোগ্যভাবে একটি API-তে সাধারণ ধরনের পরিচালনার ক্ষমতা যোগ করতে পারেন। নীতিগুলি সুরক্ষা, হার-সীমাবদ্ধকরণ, রূপান্তর এবং মধ্যস্থতা ক্ষমতার মতো বৈশিষ্ট্যগুলি প্রদান করে, যা আপনাকে কোড করতে এবং এই কার্যকারিতাটি নিজে থেকে বজায় রাখা থেকে বাঁচায়।

আপনি Apigee Edge দ্বারা প্রদত্ত নীতি প্রকারের সেটের মধ্যে সীমাবদ্ধ নন। এছাড়াও আপনি কাস্টম স্ক্রিপ্ট এবং কোড (যেমন JavaScript এবং Node.js অ্যাপ্লিকেশন) লিখতে পারেন, যা API প্রক্সি কার্যকারিতা প্রসারিত করে এবং Apigee নীতি দ্বারা সমর্থিত মৌলিক ব্যবস্থাপনা ক্ষমতাগুলির শীর্ষে আপনাকে উদ্ভাবন করতে সক্ষম করে।

নীতি সংযুক্তি এবং প্রয়োগের ভূমিকার জন্য এই ভিডিওটি দেখুন।

নীতির ধরন

প্রযুক্তিগতভাবে, একটি নীতি হল একটি XML- ফরম্যাট করা কনফিগারেশন ফাইল। প্রতিটি নীতির ধরনের কাঠামো (উদাহরণস্বরূপ, প্রয়োজনীয় এবং ঐচ্ছিক কনফিগারেশন উপাদান) একটি XML স্কিমা দ্বারা সংজ্ঞায়িত করা হয়। আপনি যদি XML সরঞ্জামগুলির সাথে দক্ষ হন, Github-এ API প্ল্যাটফর্ম নমুনাগুলিতে নীতি স্কিমাগুলির সাথে নিজেকে পরিচিত করা সার্থক৷

এজ পলিসি প্রকারগুলিকে নিম্নলিখিত কার্যকরী বিভাগে গোষ্ঠীভুক্ত করা হয়েছে:

ট্রাফিক ব্যবস্থাপনা

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

নিরাপত্তা

নিরাপত্তা বিভাগের নীতিগুলি প্রমাণীকরণ, অনুমোদন, সেইসাথে বিষয়বস্তু-ভিত্তিক নিরাপত্তা সমর্থন করে।

মধ্যস্থতা

মধ্যস্থতা বিভাগের নীতিগুলি API প্রক্সিগুলির মাধ্যমে প্রবাহিত হওয়ার সাথে সাথে বার্তাগুলিকে সক্রিয়ভাবে পরিচালনা করতে সক্ষম করে৷ তারা আপনাকে XML থেকে JSON (এবং এর বিপরীতে) বার্তা ফর্ম্যাটগুলিকে রূপান্তর করতে বা একটি XML ফর্ম্যাটকে অন্য XML ফর্ম্যাটে রূপান্তর করতে সক্ষম করে৷ তারা আপনাকে বার্তা পার্স করতে, নতুন বার্তা তৈরি করতে এবং বহির্গামী বার্তাগুলিতে মান পরিবর্তন করতে সক্ষম করে। মধ্যস্থতা নীতিগুলি API পরিষেবাগুলির দ্বারা প্রকাশিত মৌলিক পরিষেবাগুলির সাথেও ইন্টারঅ্যাক্ট করে, যা আপনাকে রানটাইমে অ্যাপস, বিকাশকারী, নিরাপত্তা টোকেন এবং API পণ্যগুলি সম্পর্কে ডেটা পুনরুদ্ধার করতে সক্ষম করে৷

এক্সটেনশন

এক্সটেনশন বিভাগের নীতিগুলি আপনাকে আপনার পছন্দের প্রোগ্রামিং ভাষায় কাস্টম আচরণ প্রয়োগ করতে API পরিষেবাগুলির সম্প্রসারণযোগ্যতায় ট্যাপ করতে সক্ষম করে।

প্রতিটি নীতির ধরন পলিসি রেফারেন্স ওভারভিউতে বিস্তারিতভাবে নথিভুক্ত করা হয়েছে। এই বিষয়টি সাধারণ মিথস্ক্রিয়া প্রদর্শন করে, আপনাকে দেখায় কিভাবে নীতিগুলি তৈরি করতে হয় এবং কীভাবে এগুলিকে একটি API প্রক্সি কনফিগারেশনে ফ্লোতে সংযুক্ত করতে হয়৷

নীতি পরিবর্তন স্থাপন

নীতি পরিবর্তনগুলি কার্যকর করার জন্য, আপনাকে অবশ্যই একটি পরিবেশে API প্রক্সি সংশোধন স্থাপন করতে হবে৷ আপনি একটি নীতি সংযুক্ত করার পরে বা বিদ্যমান নীতিতে পরিবর্তন করার পরে, পরিবর্তনগুলি স্থাপন করতে ব্যবস্থাপনা UI বা ব্যবস্থাপনা API ব্যবহার করুন৷

নীতি প্রয়োগকারী যাচাই করা হচ্ছে

একটি নীতি সঠিকভাবে প্রয়োগ করা হয়েছে তা যাচাই করার জন্য, একটি HTTP ক্লায়েন্ট দ্বারা APIকে আহ্বান করতে হবে। এই কোটা কনফিগারেশন যাচাই করতে, কোটা নীতিতে আপনার সেট করা কোটা সীমা অতিক্রম করে API-এ একাধিক অনুরোধ জমা দিন। (প্রক্সিএন্ডপয়েন্টে বেস পাথ সেটিং হিসাবে কনফিগার করা URI পাথ, নীচের অনুরোধে হল /weather )।

http://{org_name}-test.apigee.net/weather/forecastrss?w=12797282

আপনি এক মিনিটের মধ্যে 1টির বেশি অনুরোধ জমা দেওয়ার পরে, আপনি নিম্নলিখিত ত্রুটি বার্তাটি দেখতে পাবেন:

{  
   "fault":{  
      "faultstring":"policies.ratelimit.QuotaViolation",
      "detail":{  
         "errorcode":"policies.ratelimit.QuotaViolation"
      }
   }
}

এটি নির্দেশ করে যে কোটা নীতি API পরিষেবাগুলি দ্বারা প্রয়োগ করা হচ্ছে৷

নীতি-ভিত্তিক ত্রুটি হ্যান্ডলিং

উপরের ত্রুটি বার্তাটির বিন্যাসটি নোট করুন। এটিতে একটি faultstring বৈশিষ্ট্য এবং একটি errorcode বৈশিষ্ট্য রয়েছে। অনেক ক্ষেত্রে, এই ত্রুটিগুলি পরিচালনা করার জন্য আপনাকে কিছু আচরণ বাস্তবায়ন করতে হবে। উদাহরণস্বরূপ, আপনি একজন ডেভেলপারকে একটি কাস্টমাইজড বার্তা দিতে চাইতে পারেন যার অ্যাপটি কোটা অতিক্রম করেছে৷

ফল্ট হ্যান্ডলিং সম্পর্কে আরও জানতে, হ্যান্ডলিং ফল্টস দেখুন।

সর্বোত্তম অনুশীলন: সাধারণ নীতি সেট

মৌলিক ব্যবস্থাপনা প্রয়োজনীয়তা পূরণ করতে, API প্রক্সিগুলি সাধারণত নিম্নলিখিত নীতিগুলি প্রয়োগ করে:

বেসিক API কী যাচাইকরণ

প্রক্সিএন্ডপয়েন্ট অনুরোধ প্রবাহ:
  1. স্পাইক অ্যারেস্ট
  2. XMLThreatProtection বা JSONThreatProtection
  3. API কী যাচাইকরণ
  4. কোটা
  5. রেসপন্স ক্যাশে
প্রক্সিএন্ডপয়েন্ট প্রতিক্রিয়া প্রবাহ:
  1. রেসপন্স ক্যাশে

মৌলিক রূপান্তর: JSON থেকে XML

অনুরোধ প্রবাহ:
  1. স্পাইক অ্যারেস্ট
  2. JSONThreatProtection
  3. API কী যাচাইকরণ
  4. কোটা
  5. JSONToXML
প্রতিক্রিয়া প্রবাহ:
  1. XMLToJSON
  2. রেসপন্স ক্যাশে