আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
যখন পরিবেশে TLS শংসাপত্রের মেয়াদ শেষ হতে চলেছে তখন একটি বিজ্ঞপ্তি উত্থাপন করতে একটি TLS মেয়াদ শেষ হওয়ার সতর্কতা ব্যবহার করুন৷
TLS শংসাপত্র সম্পর্কে
TLS (ট্রান্সপোর্ট লেয়ার সিকিউরিটি) হল একটি ওয়েব সার্ভার এবং একটি ওয়েব ক্লায়েন্ট, যেমন একটি ব্রাউজার বা একটি অ্যাপের মধ্যে একটি এনক্রিপ্ট করা লিঙ্ক স্থাপনের জন্য মানক নিরাপত্তা প্রযুক্তি। একটি এনক্রিপ্ট করা লিঙ্ক নিশ্চিত করে যে সার্ভার এবং ক্লায়েন্টের মধ্যে পাস হওয়া সমস্ত ডেটা ব্যক্তিগত থাকে।
একটি TLS শংসাপত্র হল একটি ডিজিটাল ফাইল যা একটি TLS লেনদেনে একটি সত্তাকে চিহ্নিত করে৷ এজ এর জন্য TLS কনফিগার করতে একটি TLS শংসাপত্র ব্যবহার করে:
- API ক্লায়েন্টদের দ্বারা আপনার API প্রক্সিগুলিতে অ্যাক্সেস। TLS কনফিগার করতে ভার্চুয়াল হোস্ট ব্যবহার করুন।
- এজ দ্বারা আপনার ব্যাকএন্ড পরিষেবাগুলিতে অ্যাক্সেস। TLS কনফিগার করতে এজ মেসেজ প্রসেসরে টার্গেট এন্ডপয়েন্ট এবং টার্গেট সার্ভার ব্যবহার করুন।
একটি TLS শংসাপত্রে মেয়াদ শেষ হওয়ার তারিখ থাকে। একটি TLS শংসাপত্রের মেয়াদ শেষ হলে, আপনি শংসাপত্রটি আপডেট না করা পর্যন্ত TLS সংযোগ ব্যর্থ হয়৷ এর মানে হল যে আপনি শংসাপত্র আপডেট না করা পর্যন্ত আপনার API-এর সমস্ত অনুরোধ ব্যর্থ হবে।
মেয়াদ শেষ হওয়ার সতর্কতা সম্পর্কে
একটি শংসাপত্রের মেয়াদ শেষ হওয়ার জন্য অপেক্ষা করার পরিবর্তে এবং আপনার API-এর অনুরোধগুলি ব্যর্থ হওয়ার জন্য, পরিবেশে যে কোনও TLS শংসাপত্রের মেয়াদ শেষ হতে চলেছে তখন একটি বিজ্ঞপ্তি উত্থাপন করতে একটি মেয়াদ শেষ হওয়ার সতর্কতা ব্যবহার করুন৷ সতর্কতা ট্রিগার হওয়ার পরে, আপনি শংসাপত্রটি আপডেট করতে পারেন যাতে আপনার গ্রাহকরা পরিষেবাতে কোনও বাধা দেখতে না পান।
সতর্কতা কনফিগার করার সময়, একটি পৃথক শংসাপত্র নির্দিষ্ট করবেন না, তবে একটি নির্দিষ্ট পরিবেশ। কোনো শংসাপত্র নির্দিষ্ট সময়সীমার মধ্যে মেয়াদ শেষ হওয়ার জন্য নির্ধারিত হলে সতর্কতা ট্রিগার হয়।
আপনি ঘটতে মেয়াদ শেষ হওয়ার সতর্কতা সেট করতে পারেন:
- 1 দিন আগে যে কোনো শংসাপত্রের মেয়াদ শেষ হতে হবে
- যেকোন শংসাপত্রের মেয়াদ শেষ হওয়ার 14 দিন আগে
- কোনো শংসাপত্রের মেয়াদ শেষ হওয়ার 30 দিন আগে
মেয়াদ শেষ হওয়ার সতর্কতা এবং বিজ্ঞপ্তি যোগ করুন
মেয়াদ শেষ হওয়ার সতর্কতা এবং বিজ্ঞপ্তি যোগ করতে:- এজ UI-তে বিশ্লেষণ > সতর্কতার নিয়ম-এ ক্লিক করুন।
- + সতর্কতা ক্লিক করুন।
- সতর্কতা সম্পর্কে নিম্নলিখিত সাধারণ তথ্য লিখুন:
মাঠ বর্ণনা সতর্কতার নাম সতর্কতার নাম। ট্রিগার বর্ণনা করে এমন একটি নাম ব্যবহার করুন এবং এটি আপনার জন্য অর্থবহ হবে। নাম 128 অক্ষরের বেশি হতে পারে না। বর্ণনা সতর্কতার বর্ণনা। সতর্কতার ধরন TLS মেয়াদ শেষ নির্বাচন করুন। আরো জন্য সতর্কতা প্রকার সম্পর্কে দেখুন. পরিবেশ ড্রপ-ডাউন তালিকা থেকে পরিবেশ নির্বাচন করুন। স্ট্যাটাস সতর্কতা সক্ষম বা নিষ্ক্রিয় করতে টগল করুন। - সতর্কতা ট্রিগার করবে এমন অবস্থার জন্য থ্রেশহোল্ড এবং মাত্রা নির্ধারণ করুন।
কন্ডিশন ফিল্ড বর্ণনা থ্রেশহোল্ড মেয়াদ শেষ হওয়া শংসাপত্রের জন্য সময় পরিসীমা কনফিগার করুন। যখন একটি শংসাপত্রের মেয়াদ শেষ হতে চলেছে তখন আপনি একটি সতর্কতা বাড়ানো বেছে নিতে পারেন:
- 1 দিন
- 14 দিন
- 30 দিন
মাত্রা মাত্রাগুলি পরিবেশের যেকোনও TLS শংসাপত্রের সাথে সম্পর্কিত যে কোনও TLS শংসাপত্রের একটি মানের সাথে স্থির করা হয়েছে৷ - একটি সতর্কতা বিজ্ঞপ্তি যোগ করতে + বিজ্ঞপ্তিতে ক্লিক করুন।
বিজ্ঞপ্তি বিবরণ বর্ণনা চ্যানেল আপনি যে বিজ্ঞপ্তি চ্যানেলটি ব্যবহার করতে চান সেটি নির্বাচন করুন এবং গন্তব্য নির্দিষ্ট করুন: ইমেল, স্ল্যাক, পেজারডিউটি বা ওয়েবহুক। গন্তব্য নির্বাচিত চ্যানেল প্রকারের উপর ভিত্তি করে গন্তব্য নির্দিষ্ট করুন: - ইমেল - ইমেল ঠিকানা, যেমন
joe@company.com
- স্ল্যাক - স্ল্যাক চ্যানেল URL, যেমন
https://hooks.slack.com/services/T00000000/B00000000/XXXXX
- PagerDuty - PagerDuty কোড, যেমন
abcd1234efgh56789
- ওয়েবহুক - ওয়েবহুক ইউআরএল, যেমন
https://apigee.com/test-webhook
দ্রষ্টব্য : আপনি প্রতি বিজ্ঞপ্তিতে শুধুমাত্র একটি গন্তব্য নির্দিষ্ট করতে পারেন। একই চ্যানেলের জন্য একাধিক গন্তব্য নির্দিষ্ট করতে, অতিরিক্ত বিজ্ঞপ্তি যোগ করুন।
- ইমেল - ইমেল ঠিকানা, যেমন
- অতিরিক্ত বিজ্ঞপ্তি যোগ করতে, পূর্ববর্তী ধাপ পুনরাবৃত্তি করুন.
- আপনি একটি বিজ্ঞপ্তি যোগ করলে, নিম্নলিখিত ক্ষেত্রগুলি সেট করুন:
মাঠ বর্ণনা প্লেবুক (ঐচ্ছিক) ফ্রি-ফর্ম টেক্সট ফিল্ড যখন তারা ফায়ার করে তখন সতর্কতাগুলি সমাধানের জন্য প্রস্তাবিত ক্রিয়াগুলির একটি সংক্ষিপ্ত বিবরণ প্রদান করে। আপনি আপনার অভ্যন্তরীণ উইকি বা সম্প্রদায় পৃষ্ঠার একটি লিঙ্কও নির্দিষ্ট করতে পারেন যেখানে আপনি সর্বোত্তম অনুশীলনগুলি উল্লেখ করেন। এই ক্ষেত্রের তথ্য বিজ্ঞপ্তিতে অন্তর্ভুক্ত করা হবে। এই ক্ষেত্রের বিষয়বস্তু 1500 অক্ষরের বেশি হতে পারে না। থ্রটল ফ্রিকোয়েন্সি যা দিয়ে বিজ্ঞপ্তি পাঠাতে হয়। ড্রপ-ডাউন তালিকা থেকে একটি মান নির্বাচন করুন। - Save এ ক্লিক করুন।
ইভেন্ট ড্যাশবোর্ডে সতর্কতা দেখুন
যখন এজ একটি সতর্কতা শর্ত সনাক্ত করে, তখন এটি স্বয়ংক্রিয়ভাবে সেই শর্তটি এজ UI-তে ইভেন্ট ড্যাশবোর্ডে লগ করে। ইভেন্ট ড্যাশবোর্ডে প্রদর্শিত ইভেন্টের তালিকায় স্থির এবং শংসাপত্র উভয়ই সমস্ত সতর্কতা রয়েছে৷
একটি সতর্কতা দেখতে:
এজ UI এ বিশ্লেষণ > ইভেন্টে ক্লিক করুন। নতুন ইভেন্ট ড্যাশবোর্ড প্রদর্শিত হবে:
এর দ্বারা ইভেন্ট ড্যাশবোর্ড ফিল্টার করুন:
- পরিবেশ
- অঞ্চল
- সময়কাল
- সতর্কতাটি আরও তদন্ত করতে মেয়াদ শেষ হওয়ার শংসাপত্র ধারণকারী কীস্টোর দেখানোর জন্য ইভেন্ট ড্যাশবোর্ডে একটি সারি নির্বাচন করুন। কীস্টোর পৃষ্ঠা থেকে, আপনি একটি নতুন শংসাপত্র আপলোড করতে পারেন এবং মেয়াদ শেষ হওয়া শংসাপত্রটি মুছে ফেলতে পারেন৷
মেয়াদ শেষ হওয়ার সতর্কতার সাথে সতর্কতা API ব্যবহার করুন
মেয়াদোত্তীর্ণ সতর্কতাগুলি তৈরি করতে এবং পরিচালনা করতে আপনি যে APIগুলি ব্যবহার করেন তার বেশিরভাগই আপনি স্থির সতর্কতার সাথে যেগুলি ব্যবহার করেন তার মতোই৷ নিম্নলিখিত সতর্কতা APIগুলি স্থির এবং মেয়াদোত্তীর্ণ উভয় সতর্কতার জন্য একইভাবে কাজ করে:
- একটি সতর্কতা পান - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা পান।
- সতর্কতা ইতিহাস পান - সতর্কতা ইতিহাস মেট্রিক্স পান।
- একটি সতর্কতা মুছুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা মুছুন।
- সতর্কতার উদাহরণ পান - একটি ট্রিগার করা সতর্কতা সম্পর্কে তথ্য পান।
- সতর্কতা গণনা পান - সতর্কতার মোট গণনা পান।
যাইহোক, কিছু এপিআই-এর অতিরিক্ত বৈশিষ্ট্য রয়েছে যা অসঙ্গতি সতর্কতা সমর্থন করতে ব্যবহৃত হয়, যার মধ্যে রয়েছে:
- সতর্কতা পান - স্থির এবং অসঙ্গতি সতর্কতা সহ সমস্ত সতর্কতা তালিকাভুক্ত করুন।
- একটি সতর্কতা তৈরি করুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা তৈরি করুন।
- একটি সতর্কতা আপডেট করুন - একটি নির্দিষ্ট বা অসঙ্গতি সতর্কতা সংজ্ঞা আপডেট করুন।
একটি মেয়াদ শেষ হওয়ার সতর্কতা তৈরি বা আপডেট করুন
মেয়াদ শেষ হওয়ার সতর্কতা তৈরি বা আপডেট করতে একই API ব্যবহার করুন যেমন আপনি বর্তমানে একটি নির্দিষ্ট সতর্কতার জন্য করেন। একটি মেয়াদ শেষ হওয়ার সতর্কতা তৈরি বা আপডেট করার জন্য API কলের মূল অংশটি নিম্নলিখিত পরিবর্তন সহ একটি নির্দিষ্ট সতর্কতার জন্য ব্যবহৃত হয়:
সতর্কতাটি একটি মেয়াদ শেষ হওয়ার সতর্কতা তা নির্দিষ্ট করতে আপনাকে অবশ্যই নিম্নলিখিত নতুন বৈশিষ্ট্যগুলি যোগ করতে হবে:
"alertType": "cert" "alertSubType": "certfixed"
এই বৈশিষ্ট্যগুলির ডিফল্ট মান হল:
"alertType": "runtime" "alertSubType": "fixed"
conditions
বিন্যাসে:-
metrics
সম্পত্তি শুধুমাত্রexpiration
মান নেয়। - সেকেন্ডের মধ্যে শংসাপত্রের মেয়াদ শেষ হওয়ার সময়সীমা নির্দিষ্ট করতে
gracePeriodSeconds
প্রপার্টি ব্যবহার করুন, সর্বোচ্চ 30 দিনের মধ্যে। -
threshold
,durationSeconds
এবংcomparator
বৈশিষ্ট্য সমর্থিত নয়।
-
-
conditions
অ্যারেরdimensions
উপাদানে:- আপনাকে অবশ্যই
certificate
সম্পত্তির মান সেট করতে হবেANY
। - আপনাকে অবশ্যই
proxy
সম্পত্তির মানALL
এ সেট করতে হবে। -
statusCode
,developerApp
,collection
,faultCodeCategory
,faultCodeSubCategory
,faultCodeName
বৈশিষ্ট্য সমর্থিত নয়৷
- আপনাকে অবশ্যই
-
reportEnabled
সম্পত্তি মেয়াদ শেষ হওয়ার সতর্কতার জন্য সমর্থিত নয়।
নিম্নলিখিত উদাহরণ API কল একটি মেয়াদ শেষ হওয়ার সতর্কতা তৈরি করে যা পরবর্তী 30 দিনের মধ্যে প্রোড পরিবেশে যেকোন সেরির মেয়াদ শেষ হয়ে গেলে ট্রিগার হয়। সতর্কতা ট্রিগার হলে নির্দিষ্ট ইমেল ঠিকানায় একটি বিজ্ঞপ্তি পাঠানো হয়:
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 }'
আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN
সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি 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'
আপনার OAuth 2.0 অ্যাক্সেস টোকেনে $ACCESS_TOKEN
সেট করুন, যেমনটি বর্ণনা করা হয়েছে একটি OAuth 2.0 অ্যাক্সেস টোকেন পান । এই উদাহরণে ব্যবহৃত cURL বিকল্পগুলি সম্পর্কে তথ্যের জন্য, CURL ব্যবহার করুন দেখুন।