মেয়াদ শেষ হওয়ার অ্যালার্ট সেট-আপ করা

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

কোনও এনভায়রনমেন্টে TLS সার্টিফিকেটের মেয়াদ শেষ হতে চললে, সেটি সম্পর্কে বিজ্ঞপ্তি পেতে TLS মেয়াদ শেষ হওয়ার সতর্কতা ব্যবহার করুন।

TLS সার্টিফিকেট সম্পর্কে

TLS (ট্রান্সপোর্ট লেয়ার সিকিউরিটি) হল ওয়েব সার্ভার ও ওয়েব ক্লায়েন্টের মধ্যে এনক্রিপ্ট করা লিঙ্ক স্থাপন করার জন্য স্ট্যান্ডার্ড নিরাপত্তা প্রযুক্তি, যেমন ব্রাউজার বা অ্যাপ। এনক্রিপ্ট করা লিঙ্ক নিশ্চিত করে যে সার্ভার ও ক্লায়েন্টের মধ্যে পাস করা সমস্ত ডেটা ব্যক্তিগত থাকে।

TLS সার্টিফিকেট হল একটি ডিজিটাল ফাইল যা TLS ট্রানজ্যাকশনে কোনও এন্টিটিকে শনাক্ত করে। Edge TLS কনফিগার করার জন্য TLS সার্টিফিকেট ব্যবহার করে:

• API ক্লায়েন্টদের দ্বারা আপনার API প্রক্সি অ্যাক্সেস করা। TLS কনফিগার করতে ভার্চুয়াল হোস্ট ব্যবহার করুন।
• Edge-এর মাধ্যমে আপনার ব্যাকএন্ড পরিষেবা অ্যাক্সেস করা। TLS কনফিগার করতে Edge Message Processor-এ টার্গেট এন্ডপয়েন্ট ও টার্গেট সার্ভার ব্যবহার করুন।

TLS সার্টিফিকেটে মেয়াদ শেষ হওয়ার তারিখ থাকে। TLS সার্টিফিকেট মেয়াদোত্তীর্ণ হয়ে গেলে, আপনি সার্টিফিকেট আপডেট না করা পর্যন্ত TLS কানেকশন কাজ করে না। এর অর্থ হল, আপনি সার্টিফিকেট আপডেট না করা পর্যন্ত আপনার API-তে করা সব অনুরোধ ব্যর্থ হবে।

মেয়াদ শেষ হওয়া সংক্রান্ত সতর্কতা সম্পর্কে

কোনও সার্টিফিকেটের মেয়াদ শেষ হওয়া এবং আপনার API-তে করা অনুরোধ ব্যর্থ হওয়ার জন্য অপেক্ষা না করে, কোনও এনভায়রনমেন্টে কোনও TLS সার্টিফিকেটের মেয়াদ শেষ হতে চললে, একটি মেয়াদ শেষ হওয়া সংক্রান্ত সতর্কতা ব্যবহার করে একটি বিজ্ঞপ্তি তৈরি করুন। সতর্কতা ট্রিগার করার পরে, আপনি সার্টিফিকেট আপডেট করতে পারবেন যাতে আপনার গ্রাহকরা পরিষেবাতে কোনও বাধা দেখতে না পান।

অ্যালার্ট কনফিগার করার সময়, কোনও ব্যক্তিগত সার্টিফিকেট নির্দিষ্ট করবেন না, তবে একটি নির্দিষ্ট এনভায়র্নমেন্ট নির্দিষ্ট করুন। নির্দিষ্ট সময়সীমার মধ্যে মেয়াদ শেষ হওয়ার জন্য কোনও সার্টিফিকেট ডেপ্লয় করা হলে সতর্কতা ট্রিগার হয়।

আপনি মেয়াদ শেষ হওয়ার অ্যালার্ট সেট করতে পারেন:

• কোনও সার্টিফিকেট মেয়াদ শেষ হওয়ার ১ দিন আগে
• কোনও সার্টিফিকেট মেয়াদ শেষ হওয়ার ১৪ দিন আগে
• কোনও সার্টিফিকেট মেয়াদ শেষ হওয়ার ৩০ দিন আগে

মেয়াদ শেষ হওয়ার সতর্কতা ও বিজ্ঞপ্তি যোগ করা

1. Edge UI-তে বিশ্লেষণ করুন > অ্যালার্ট সংক্রান্ত নিয়ম বিকল্পে ক্লিক করুন।
2. +সতর্কতা বিকল্পে ক্লিক করুন।
3. সতর্কতা সম্পর্কে নিম্নলিখিত সাধারণ তথ্য লিখুন:

   ফিল্ড	বিবরণ
   সতর্কতার নাম	সতর্কতার নাম। ট্রিগারকে বর্ণনা করে এমন নাম ব্যবহার করুন যা আপনার কাছে অর্থপূর্ণ হবে। নাম ১২৮ অক্ষরের বেশি হলে চলবে না।
   বিবরণ	সতর্কতার বিবরণ।
   সতর্কতার ধরন	TLS মেয়াদ শেষ হওয়ার তারিখ বেছে নিন। আরও জানতে সতর্কতার ধরন সম্পর্কে দেখুন।
   পরিবেশ	ড্রপ-ডাউন তালিকা থেকে এনভায়র্নমেন্ট বেছে নিন।
   স্ট্যাটাস	অ্যালার্ট চালু বা বন্ধ করতে টগল করুন।

4. যেসব শর্তের জন্য অ্যালার্ট ট্রিগার হবে সেগুলির থ্রেশহোল্ড ও ডাইমেনশন নির্দিষ্ট করুন।

   কন্ডিশন ফিল্ড	Description
   থ্রেশহোল্ড	এক্সপায়ার হওয়া সার্টিফিকেটের জন্য সময়সীমা কনফিগার করুন। কোনও সার্টিফিকেট এই সময়ের মধ্যে মেয়াদ শেষ হতে চললে আপনি অ্যালার্ট পাওয়ার বিকল্প বেছে নিতে পারেন: ১ দিন ১৪ দিন ৩০ দিন
   আকার	ডাইমেনশনটি যেকোনও TLS সার্টিফিকেট ভ্যালুতে ফিক্স করা আছে যা পরিবেশে থাকা যেকোনও TLS cert-এর সাথে সম্পর্কিত।

5. সতর্কতা বিজ্ঞপ্তি যোগ করতে, + বিজ্ঞপ্তি বিকল্পে ক্লিক করুন।

   বিজ্ঞপ্তির বিবরণ	বিবরণ
   চ্যানেল	আপনি যে বিজ্ঞপ্তি চ্যানেল ব্যবহার করতে চান সেটি বেছে নিন এবং গন্তব্য নির্দিষ্ট করুন: ইমেল, Slack, PagerDuty বা Webhook.
   গন্তব্য	বেছে নেওয়া চ্যানেলের ধরনের উপর ভিত্তি করে গন্তব্য নির্দিষ্ট করুন: ইমেল - ইমেল আইডি, যেমন joe@company.com Slack - Slack চ্যানেলের URL, যেমন https://hooks.slack.com/services/T00000000/B00000000/XXXXX PagerDuty - PagerDuty কোড, যেমন abcd1234efgh56789 ওয়েবহুক - ওয়েবহুক URL, যেমন https://apigee.com/test-webhook মনে রাখবেন: আপনি প্রতিটি বিজ্ঞপ্তির জন্য শুধুমাত্র একটি গন্তব্য নির্দিষ্ট করতে পারবেন। একই ধরনের চ্যানেলের জন্য একাধিক গন্তব্য নির্দিষ্ট করতে, অতিরিক্ত বিজ্ঞপ্তি যোগ করুন।

6. অতিরিক্ত বিজ্ঞপ্তি যোগ করতে, আগের ধাপটি আবার অনুসরণ করুন।
7. আপনি কোনও বিজ্ঞপ্তি যোগ করে থাকলে, নিম্নলিখিত ফিল্ড সেট করুন:

   ফিল্ড	বিবরণ
   Playbook	(ঐচ্ছিক) অ্যালার্ট ফায়ার করলে তা সমাধান করার জন্য প্রস্তাবিত অ্যাকশনের সংক্ষিপ্ত বিবরণ দিতে ফ্রি-ফর্ম টেক্সট ফিল্ড ব্যবহার করুন। এছাড়াও, আপনার ইন্টার্নাল উইকি বা কমিউনিটি পৃষ্ঠায় একটি লিঙ্ক নির্দিষ্ট করতে পারেন যেখানে আপনি পেশাদার পদ্ধতি উল্লেখ করেন। এই ফিল্ডে থাকা তথ্য বিজ্ঞপ্তিতে অন্তর্ভুক্ত করা হবে। এই ফিল্ডের কন্টেন্ট ১৫০০ অক্ষরের বেশি হলে চলবে না।
   থ্রটল করা	কত ঘনঘন বিজ্ঞপ্তি পাঠাতে হবে। ড্রপ-ডাউন তালিকা থেকে একটি মান বেছে নিন।

8. সেভ করুন বিকল্পে ক্লিক করুন।

Events ড্যাশবোর্ডে সতর্কতা দেখা

Edge কোনও সতর্কতার কন্ডিশন শনাক্ত করলে, Edge UI-তে ইভেন্ট ড্যাশবোর্ডে সেই কন্ডিশন অটোমেটিক লগ করে। ইভেন্ট ড্যাশবোর্ডে দেখানো ইভেন্টের তালিকায় সব অ্যালার্ট অন্তর্ভুক্ত থাকে, এর মধ্যে ফিক্সড ও সার্ট, দুটিই থাকে।

কোনও সতর্কতা দেখতে:

1. Edge UI-তে বিশ্লেষণ করুন > ইভেন্ট বিকল্পে ক্লিক করুন। নতুন ইভেন্ট ড্যাশবোর্ড দেখা যাবে:

2. এইসব বিষয় অনুযায়ী ইভেন্ট ড্যাশবোর্ড ফিল্টার করুন:

   • পরিবেশ
   • অঞ্চল
   • সময়সীমা
3. ইভেন্ট ড্যাশবোর্ডে একটি সারি বেছে নিয়ে সেই কীস্টোরটি দেখুন যেখানে মেয়াদ শেষ হয়ে যাওয়া সার্টিফিকেটটি আছে। এর ফলে আপনি অ্যালার্টটি আরও ভালভাবে তদন্ত করতে পারবেন। 'কীস্টোর' পৃষ্ঠা থেকে, আপনি একটি নতুন সার্টিফিকেট আপলোড করতে এবং মেয়াদ শেষ হয়ে যাওয়া সার্টিফিকেটটি মুছে ফেলতে পারবেন।

মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি সহ অ্যালার্ট API ব্যবহার করা

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

• অ্যালার্ট পান - কোনও ফিক্সড বা অস্বাভাবিক অ্যালার্টের সংজ্ঞা পান।
• সতর্কতার ইতিহাস পান - সতর্কতার ইতিহাস সংক্রান্ত মেট্রিক পান।
• কোনও অ্যালার্ট মুছে দেওয়া - কোনও ফিক্সড বা অস্বাভাবিকতা সংক্রান্ত অ্যালার্টের সংজ্ঞা মুছে দেওয়া।
• অ্যালার্ট ইনস্ট্যান্স পাওয়া - ট্রিগার করা অ্যালার্ট সম্পর্কে তথ্য পাওয়া।
• সতর্কতার সংখ্যা পান - সতর্কতার মোট সংখ্যা পান।

তবে, কিছু API-তে অতিরিক্ত প্রপার্টি আছে যা অস্বাভাবিকতা সংক্রান্ত অ্যালার্টের ক্ষেত্রে ব্যবহার করা হয়, এর মধ্যে রয়েছে:

• সতর্কতা পান - সমাধান করা এবং অস্বাভাবিকতা সংক্রান্ত সতর্কতা সহ সব সতর্কতার তালিকা।
• অ্যালার্ট তৈরি করুন - ফিক্সড বা অসঙ্গতি সংক্রান্ত অ্যালার্ট তৈরি করুন।
• কোনও অ্যালার্ট আপডেট করা - কোনও ফিক্সড বা অস্বাভাবিকতা সংক্রান্ত অ্যালার্টের সংজ্ঞা আপডেট করুন।

মেয়াদ শেষ হওয়ার অ্যালার্ট তৈরি বা আপডেট করা

বর্তমানে আপনি নির্দিষ্ট অ্যালার্টের জন্য যেভাবে করেন, ঠিক সেইভাবে মেয়াদ শেষ হওয়ার অ্যালার্ট তৈরি বা আপডেট করতে একই API ব্যবহার করুন। মেয়াদ শেষ হওয়ার বিজ্ঞপ্তি তৈরি বা আপডেট করার জন্য API কলের বডি, নিম্নলিখিত পরিবর্তন সহ, একটি নির্দিষ্ট বিজ্ঞপ্তির জন্য ব্যবহৃত বডির মতোই:

• অ্যালার্ট যে মেয়াদ শেষ হওয়ার অ্যালার্ট তা নির্দিষ্ট করতে আপনাকে অবশ্যই নিম্নলিখিত নতুন প্রপার্টি যোগ করতে হবে:

  "alertType": "cert"
  "alertSubType": "certfixed"

  এইসব প্রপার্টির ডিফল্ট ভ্যালু হল:

  "alertType": "runtime"
  "alertSubType": "fixed"

• conditions অ্যারেতে:

  • metrics প্রপার্টি শুধুমাত্র expiration-এর ভ্যালু নেয়।
  • সর্বাধিক ৩০ দিন পর্যন্ত, সেকেন্ডে সার্টিফিকেট মেয়াদ শেষ হওয়ার সময়সীমা নির্দিষ্ট করতে gracePeriodSeconds প্রপার্টি ব্যবহার করুন।
  • threshold, durationSeconds ও comparator প্রপার্টি কাজ করে না।
• conditions অ্যারের dimensions এলিমেন্টে:
  • certificate প্রপার্টির ভ্যালু ANY হিসেবে সেট করতে হবে।
  • proxy প্রপার্টির ভ্যালু ALL হিসেবে সেট করতে হবে।
  • statusCode, developerApp, collection, faultCodeCategory, faultCodeSubCategory, faultCodeName প্রপার্টি কাজ করে না।
• মেয়াদ শেষ হওয়ার সতর্কতা সংক্রান্ত ক্ষেত্রে reportEnabled প্রপার্টি কাজ করে না।

নিম্নলিখিত API কলের উদাহরণ একটি মেয়াদ শেষ হওয়ার সতর্কতা তৈরি করে যা কোনও cery-এর prod এনভায়রনমেন্টে আগামী ৩০ দিনের মধ্যে মেয়াদ শেষ হয়ে গেলে ট্রিগার হয়। সতর্কতা ট্রিগার করা হলে, নির্দিষ্ট ইমেল আইডিতে একটি বিজ্ঞপ্তি পাঠানো হয়:

curl 'https://apimonitoring.enterprise.apigee.com/alerts' \
 -X POST \
 -H 'Accept: application/json, text/plain, */*' -H "Content-Type: application/json" \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -d '{
  "organization":"myorg",
  "name":"My Cert Expiry Alert",
  "description":"My Cert Expiry Alert",
  "environment":"prod",
  "enabled":true,
  "alertType": "cert",
  "alertSubType": "certfixed",
  "conditions":[
  {
    "description":"My Cert Expiry Alert",
    "dimensions":{
      "org":"myorg",
      "env":"prod",
      "proxy":"ALL",
      "certificate": "ANY"
    },
    "metric":"expiration",
    "gracePeriodSeconds": 2592000
  }],
  "notifications":[{
    "channel":"email",
    "destination":"ops@acme.com"
  }],
  "playbook":"http://acme.com/pb.html",
  "throttleIntervalSeconds":3600,
  "reportEnabled":false
}'

$ACCESS_TOKEN-কে আপনার OAuth 2.0 অ্যাক্সেস টোকেন হিসেবে সেট করুন, যেমনটি OAuth 2.0 অ্যাক্সেস টোকেন পান নিবন্ধে বর্ণনা করা হয়েছে। এই উদাহরণে ব্যবহৃত cURL বিকল্প সম্পর্কে তথ্য পেতে, cURL ব্যবহার করুন দেখুন।

মেয়াদ শেষ হওয়ার ব্যাপারে সতর্কতা পান

ডিফল্ট হিসেবে, Get Alerts API নির্ধারিত সব অ্যালার্ট সম্পর্কে তথ্য রিটার্ন করে, এর মধ্যে ফিক্সড ও এক্সপায়ার হওয়া অ্যালার্ট অন্তর্ভুক্ত। এই API এখন কোয়েরি প্যারামিটার নেয় যাতে আপনি ফলাফল ফিল্টার করতে পারেন:

• enabled - true-এ শুধুমাত্র চালু থাকা অ্যালার্ট ফেরত দেওয়ার কথা বলা থাকলে। ডিফল্ট ভ্যালু হল false।
• alertType - ফেরত পাঠানোর জন্য সতর্কতার ধরন নির্দিষ্ট করে। অনুমোদিত ভ্যালু হল runtime, ডিফল্ট এবং cert।
• alertSubType - ফেরত পাঠানোর জন্য সতর্কতার সাবটাইপ নির্দিষ্ট করে। ডিফল্ট ভ্যালু হল আনসেট, অর্থাৎ অ্যালার্টের সব সাবটাইপ রিটার্ন করে। মেয়াদ শেষ হওয়ার অ্যালার্ট ফিরিয়ে আনতে certfixed নির্দিষ্ট করুন।

যেমন, myorg নামের সংস্থার জন্য শুধু চালু করা অ্যালার্টের তথ্য পেতে, নিম্নলিখিত API কল ব্যবহার করুন:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&enabled=true'

নিম্নলিখিত কল শুধুমাত্র মেয়াদ শেষ হওয়ার সতর্কতা রিটার্ন করে, চালু এবং বন্ধ উভয়ই:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
'https://apimonitoring.enterprise.apigee.com/alerts?org=myorg&alertType=cert&alertSubType=certfixed'

$ACCESS_TOKEN-কে আপনার OAuth 2.0 অ্যাক্সেস টোকেন হিসেবে সেট করুন, যেমনটি OAuth 2.0 অ্যাক্সেস টোকেন পান নিবন্ধে বর্ণনা করা হয়েছে। এই উদাহরণে ব্যবহৃত cURL বিকল্প সম্পর্কে তথ্য পেতে, cURL ব্যবহার করুন দেখুন।