ওয়েবহুকের মাধ্যমে সিএমএ বিজ্ঞপ্তিগুলি পাঠানো

সারসংক্ষেপ

Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন (CMA) আপনার অ্যাকাউন্টের বিস্তৃত নিরাপত্তা এবং নেটওয়ার্ক ইভেন্টগুলির জন্য বিজ্ঞপ্তি তৈরি করে। আপনি এই বিজ্ঞপ্তিগুলি স্বয়ংক্রিয়ভাবে ServiceNow, Jira, Slack বা Zendesk এর মতো তৃতীয়-পক্ষীয় প্ল্যাটফর্মে বিতরণের জন্য ওয়েবহুক ইন্টিগ্রেশন ব্যবহার করতে পারেন। এটি বাইরের সিস্টেমগুলিকে আসল সময়ে কেটো ইভেন্ট ডেটা গ্রহণ করতে এবং ঘটনার ট্র্যাকিং এবং প্রতিক্রিয়ার জন্য স্বয়ংক্রিয় কর্মপ্রবাহ শুরু করতে দেয়।

কেটো দুটি ধরনের ওয়েবহুক ইন্টিগ্রেশনের সমর্থন করে:

  • স্ট্যান্ডার্ড ওয়েবহুকগুলি বাইরের প্ল্যাটফর্মে আইটেম তৈরি বা আপডেট করতে HTTP অনুরোধ ব্যবহার করে। 

  • কোরিলেটেড ওয়েবহুকগুলি XOps পরিষেবার সাথে ইন্টিগ্রেট হয়। তারা XOps নিরাপত্তা এবং নেটওয়ার্ক গল্পগুলির জীবনচক্র উপস্থাপনকারী আইটেমগুলি তৈরি এবং আপডেট করতে কররিলেশন আইডি ব্যবহার করে। একটি XOps লাইসেন্স প্রয়োজন।

ওয়েবহুক ইন্টিগ্রেশন সম্পূর্ণরূপে কনফিগারযোগ্য। আপনি HTTP পদ্ধতি (POST বা PUT), লক্ষ্য URL, প্রমাণীকরণ পদ্ধতি এবং অনুরোধ কর্ম সংজ্ঞায়িত করেন। টেমপ্লেট এবং ক্ষেত্রের ভেরিয়েবল তৃতীয় পক্ষের প্ল্যাটফর্মের প্রয়োজনীয়তার জন্য পে লোড কাঠামোকে উপযোগী করতে দেয়।

কেটো ওয়েবহুক ইন্টিগ্রেশন বোঝা

ওয়েবহুক ইন্টিগ্রেশন প্রকার

তৃতীয়-পক্ষীয় প্ল্যাটফর্মের সাথে আপনার অ্যাকাউন্ট ইন্টিগ্রেট করতে এবং অটোমেশন ফ্লো তৈরি করতে কেটো এই ধরনের ওয়েবহুকগুলির সমর্থন করে:

  • স্ট্যান্ডার্ড ওয়েবহুকগুলি অ্যাকাউন্ট বা সিস্টেম অ্যালার্ট, এবং নীতি-চালিত বিজ্ঞপ্তিগুলির উপর ভিত্তি করে বিজ্ঞপ্তি সহ বিস্তৃত পরিসরে সিএমএ বিজ্ঞপ্তিগুলির সমর্থন করে। এগুলি আপনাকে বাইরের প্ল্যাটফর্মে এই ডেটা সরবরাহ করতে দেয় এবং ওয়েবহুক নতুন রেকর্ড তৈরি করবে বা বিদ্যমান রেকর্ডগুলিকে আপডেট করবে কিনা কনফিগার করতে দেয়।

  • কোরিলেটেড ওয়েবহুকগুলি XOps পরিষেবার জন্য ডিজাইন করা হয়েছে। তারা ওয়েবহুক কার্যকারিতা বিস্তৃত করে নিরাপত্তা এবং নেটওয়ার্ক গল্পগুলিতে, যাতে প্রতি গল্প CMA-তে একটি রেকর্ডে মানচিত্রিত হয় বাইরের সিস্টেমে এবং গল্পটির অগ্রগতি হিসাবে আপডেট করা হয়। একটি XOps লাইসেন্স প্রয়োজন।

ওয়েবহুক ফ্লো - তৈরি বা আপডেট

ওয়েবহুক ফ্লোগুলি সংজ্ঞায়িত করে কিভাবে CMA একটি তৃতীয়-পক্ষ প্ল্যাটফর্মের সাথে যোগাযোগ করে, হয় নতুন রেকর্ড তৈরি করে বা বিদ্যমান পরিবর্তন করে:

  • POST (তৈরি করুন) - যখনই ওয়েবহুক সক্রিয় হয় তখন তৃতীয় পক্ষীয় প্ল্যাটফর্মে একটি নতুন আইটেম তৈরি করে। উদাহরণ: যখনই ইন্টারনেট ফায়ারওয়াল নিয়ম একটি ট্রাফিক প্রবাহে বাধা দেয় তখন একটি নতুন সার্ভিস নাও টিকেট খুলুন।

  • PUT (আপডেট) – তৃতীয় পক্ষীয় প্ল্যাটফর্মে একটি বিদ্যমান আইটেম আপডেট করে। অনুরোধটি URL বা বডিতে একটি বৈধ আইটেম আইডি অন্তর্ভুক্ত করে।

প্রমাণীকরণ পদ্ধতি

ওয়েবহুক ইন্টিগ্রেশন তৈরি করার সময়, বেছে নেওয়ার জন্য বিভিন্ন প্রমাণীকরণ পদ্ধতি থাকে:

  • বেসিক - ব্যবহারকারী নাম এবং পাসওয়ার্ড

  • Bearer - Bearer টোকেন

  • কাস্টম - যে পরিষেবাগুলি অনন্য প্রমাণীকরণ প্রয়োজন তাদের জন্য কাস্টম হেডারস। প্রয়োজন মতো কী-মূল্য জোড়া যোগ করুন।

নোট: যদি তৃতীয় পক্ষের সেবাতে অ্যাক্সেস নির্দিষ্ট IP ঠিকানাগুলোর মধ্যে সীমিত হয়, তাহলে অনুগ্রহ করে Cato IP ঠিকানার তালিকা যা আপনাকে অনুমতি দিতে হবে তার জন্য এই প্রবন্ধটি দেখুন (এই প্রবন্ধটি দেখতে হলে আপনাকে সাইন ইন থাকতে হবে)।

বিজ্ঞপ্তির সামগ্রী কাস্টমাইজ করা

টেমপ্লেটের content ফিল্ডে তৈরি করা পাঠযোগ্য সতর্কতার সারসংক্ষেপ অন্তর্ভুক্ত আছে, যা ইমেইল সতর্কতার বিষয়বস্তু অনুরূপ। আপনি বিষয়বস্তু জন্য এই ফর্ম্যাটগুলির মধ্য থেকে বেছে নিতে পারেন: contentText, contentMarkdown, বা contentHTML।

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

ওয়েবহুক ক্ষেত্রসমূহের জন্য ডিফল্ট মান

আপনি বিজ্ঞপ্তি ডেটায় কোনো মান না থাকলে কাস্টম ডিফল্ট মান নির্ধারণ করতে পারেন, যা ডাইনামিক ওয়েবহুক ক্ষেত্রসমূহের জন্য নমনীয়তা যোগ করে। এটি ওয়েবহুক ইউআরএল, হেডার অথবা বডির ডিফল্ট NA মান ওভাররাইড করতে দেয়। ফলব্যাক মান নির্ধারণ করতে ${field:defaultValue} ফর্ম্যাট ব্যবহার করুন। উদাহরণস্বরূপ, আপনি ${level:medium} সেট করতে পারেন যদি level ক্ষেত্র পূর্ণ না হয়। একটি সংযুক্ত প্রবাহে, আপনি ওয়েবহুক ইউআরএল-এ ফলব্যাক টিকেট আইডি ব্যবহার করতে পারেন, যেমন https://EXAMPLE-INSTANCE.service-now.com/api/now/table/incident/${correlationId:12345}, যেন অসংযুক্ত বিজ্ঞপ্তিগুলি একটি ডিফল্ট সার্ভিসনাউ টিকেটে ক্যাপচার হয়।

স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশন

স্ট্যান্ডার্ড ওয়েবহুকগুলি বিভিন্ন ব্যবহারের ক্ষেত্রে তৃতীয় পক্ষীয় প্ল্যাটফর্মগুলিতে সিএমএ বিজ্ঞপ্তি পাঠাতে দেয়। প্রথমে, প্ল্যাটফর্মের সাথে ইন্টিগ্রেট করতে ওয়েবহুক সংজ্ঞায়িত করুন। তারপরে কোন সিএমএ বিজ্ঞপ্তি এবং নীতি নিয়ম, যেমন ফায়ারওয়াল পদক্ষেপগুলি, ওয়েবহুক ব্যবহার করে বিজ্ঞপ্তি তৈরির জন্য নির্বাচন করুন।

একটি ওয়েবহুক ইন্টিগ্রেশন সংজ্ঞায়িত করুন

একটি ওয়েবহুক ইন্টিগ্রেশন তৈরি করুন যা আপনার তৃতীয় পক্ষীয় টুলে আইটেমগুলির মাধ্যমে বিজ্ঞপ্তি পাঠায় (টিকেট, Slack বার্তা ইত্যাদি)। আপনি একটি POST অনুরোধের সঙ্গে নতুন আইটেম তৈরি করতে বা একটি PUT অনুরোধের সঙ্গে বিদ্যমান আইটেমগুলিকে আপডেট করতে ওয়েবহুক কনফিগার করতে পারেন। ইন্টিগ্রেশনটিতে URL, অনুরোধ বডি, প্রমাণীকরণ পদ্ধতি এবং ঐচ্ছিক কাস্টম শিরোনাম এবং বার্তা বডির সেটিংস অন্তর্ভুক্ত।

বিবরণ সংজ্ঞায়িত করার পরে, আপনি সংযোগ পরীক্ষা করতে এবং এটি কাজ করে কিনা তা যাচাই করতে পারেন।

একটি ওয়েবহুক ইন্টিগ্রেশন সংজ্ঞায়িত করতে:

  1. নেভিগেশান মেনু থেকে, Account > Subscriptions এ ক্লিক করুন এবং Webhooks ট্যাব নির্বাচন করুন।

  2. নতুন ওয়েবহুক ক্লিক করুন। নতুন ওয়েবহুক ইন্টিগ্রেশন প্যানেল খুলেছে।

  3. ওয়েবহুক বিস্তারিত কনফিগার করুন:

    1. ইন্টিগ্রেশন নাম লিখুন।

    2. স্লাইডারে ক্লিক করুন সক্রিয় করুন (সবুজ) অথবা নিষ্ক্রিয় করুন (ধূসর) ইন্টিগ্রেশন (এটি ডিফল্টভাবে সক্রিয়)।

  4. ইন্টিগ্রেশনের জন্য JSON টেমপ্লেটের সেটিংস কনফিগার করুন:

    • টেমপ্লেট থেকে শুরু করুন এ, ডিফল্ট JSON টেমপ্লেট নির্বাচন করুন যা ইন্টিগ্রেশনের সেটিংস পূরণ করে।

      আপনি কাস্টম বডি এর জন্য ক্ষেত্রগুলি সমন্বয় এবং পরিবর্তন করতে পারেন (নীচে ধাপ 7 দেখুন)।

    বিঃদ্রঃ: যদি আপনি একটি আলাদা টেমপ্লেট নির্বাচন করেন, তাহলে কাস্টম বডি এর ক্ষেত্রগুলি পুনরায় সেট হবে। টেমপ্লেট এবং ক্ষেত্রসমূহ সম্পর্কে আরও তথ্যের জন্য, নিচে টেমপ্লেট এবং ক্ষেত্রসমূহ দেখুন।

  5. সংযোগের বিবরণ কনফিগার করুন:

    1. ওয়েবহুক গ্রহণকারী সার্ভিসটির জন্য ইউআরএল লিখুন।

      আপনি URL-এ ভেরিয়েবল হিসেবে ক্ষেত্র ব্যবহার করতে পারেন। উপলব্ধ ক্ষেত্র দেখতে $ টাইপ করুন।

    2. অনুরোধ পদ্ধতি এ, এই ওয়েবহুকের জন্য প্রবাহ নির্বাচন করুন: POST বা PUT।

    3. যদি প্রয়োজন হয়, সেবার জন্য প্রমাণীকরণ পদ্ধতি এবং সেটিংস কনফিগার করুন।

  6. (অপশনাল) কাস্টম হেডার এ, ইন্টিগ্রেশনের প্রতি অতিরিক্ত HTTP হেডারের জন্য কী এবং মান নির্ধারণ করুন।

  7. কাস্টম বডি এ, ওয়েবহুক বিজ্ঞপ্তির বিষয়বস্তু সংজ্ঞায়িত করুন:

    1. (ঐচ্ছিক) বডি সম্পাদনা করুন এ বিষয়বস্তু কাস্টমাইজ করুন।

      • বডিতে $ ব্যবহার করতে পালায়নকারী চরিত্র হিসেবে / লিখুন

      • অন্যান্য ক্ষেত্রসমূহ এম্বেড করতে $ লিখুন

      প্রতিক্রিয়া কররিলেশন আইডি স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশনের জন্য ব্যবহৃত হয় না।

    2. ডিফল্ট মান নির্ধারণ করতে, ${field:defaultValue} ফর্ম্যাট ব্যবহার করুন, উদাহরণস্বরূপ ${ID:12345}

  8. পরীক্ষা করুন ক্লিক করুন। CMA ক্ষেত্রগুলির জন্য স্বয়ংক্রিয়ভাবে উত্পন্ন বিষয়বস্তু সহ একটি পরীক্ষামূলক HTTP অনুরোধ পাঠায়।

    যদি ইন্টিগ্রেশনটি সেবাতে সংযুক্ত হতে পারে, তবে একটি পরীক্ষা সফলভাবে সম্পন্ন হয়েছে। বার্তা প্রদর্শন করা হয়।

    যদি একটি সংযোগ ত্রুটি হয়, পেজটি সেবার দ্বারা রিপোর্ট করা HTTP ত্রুটি কোড এবং বার্তা প্রদর্শন করে।

  9. সংরক্ষণ করুন ক্লিক করুন। ওয়েবহুক ইন্টিগ্রেশনটি সংরক্ষিত হয় এবং Subscriptions পৃষ্ঠায় Integrations ট্যাবে যোগ করা হয়।

স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশনগুলির জন্য ট্রিগার নির্ধারণ করুন

স্ট্যান্ডার্ড ওয়েবহুকগুলি CMA থেকে বিজ্ঞপ্তি দ্বারা সক্রিয় হয়। আপনি দুটি ধরণের বিজ্ঞপ্তি কনফিগার করতে পারেন:

  1. CMA বিজ্ঞপ্তিসমূহ: CMA আপনার অ্যাকাউন্ট সম্পর্কে proactive বিজ্ঞপ্তি পাঠাতে পারে, যেমন লক করা ব্যবহারকারী এবং অ্যাডমিন অথবা লাইসেন্স আপডেট। এই বিজ্ঞপ্তিগুলি সরাসরি একটি ওয়েবহুক ইন্টিগ্রেশনের মাধ্যমে পাঠানো যেতে পারে।

    আরও তথ্যের জন্য দেখুন অ্যাকাউন্ট স্তরের সতর্কতা এবং সিস্টেম বিজ্ঞপ্তিসমূহ।

  2. নীতিবর্তী বিজ্ঞপ্তি: আপনি নীতিবাচক প্রতিবেদন মত প্রাদেশিক নিয়মে ট্র্যাক করুন সেটিং কনফিগার করতে পারেন যখনই নিয়মটি মেলে তখন ওয়েবহুকে বিজ্ঞপ্তি পাঠানো হয়।

নীতিগুলিতে নিয়মগুলি সংজ্ঞায়িত করার সময়, আপনি ওয়েবহুক ইন্টিগ্রেশনের মাধ্যমে বিজ্ঞপ্তি পাঠানোর জন্য ক্রিয়াকলাপগুলি এলাকা ব্যবহার করতে পারেন।

rule_webhook.png

কোরিলেটেড ওয়েবহুক ইন্টিগ্রেশন

XOps পরিষেবা সমর্থন করে কোরিলেটেড ওয়েবহুকগুলি যা আপনাকে XOps নিরাপত্তা এবং নেটওয়ার্ক গল্পগুলির জীবনচক্র একটি তৃতীয়-পক্ষীয় প্ল্যাটফর্মের সাথে ইন্টিগ্রেট করতে দেয়। আপনি সংযোজনা কনফিগার করার পর যখন একটি গল্প শুরু হয় তখন তৃতীয়-পক্ষ প্ল্যাটফর্ম স্বয়ংক্রিয়ভাবে একটি নতুন টিকেট, সমস্যা, বা বার্তা তৈরি করে এবং পাঠানোর সাথে সাথে এটি আপডেট করে।

এই ইন্টিগ্রেশনগুলি XOps গল্প থেকে কররিলেশন ক্ষেত্রগুলি ব্যবহার করে প্রতিটি গল্পের CMA-এর একটি টিকিট, সমস্যা, বা বাইরের প্ল্যাটফর্মে বার্তা মানচিত্রিত করার জন্য। এটি নিশ্চিত করে যে আপডেটগুলি ধারাবাহিকভাবে সঠিক আইটেমের উপর প্রয়োগ করা হয়। একটি XOps লাইসেন্স প্রয়োজন।

এই ইন্টিগ্রেশনগুলির প্রয়োজন:

  • স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশন

  • একটি সম্পর্কযুক্ত ওয়েবহুক ইন্টিগ্রেশন

  • দুই প্রকারের ট্রিগার (প্রতি ইন্টিগ্রেশনের জন্য এক)

একটি স্ট্যান্ডার্ড ওয়েবহুক নির্ধারণ করুন

আপনার তৃতীয় পক্ষের টুলে প্রাথমিক আইটেম (টিকেট, Slack বার্তা, ইত্যাদি) তৈরি করতে একটি স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশন তৈরি করুন। এরপরে এই আইটেমগুলি সম্পর্কিত ওয়েবহুক ইন্টিগ্রেশন দ্বারা আপডেট করা হবে।

বিস্তারিত সংজ্ঞায়িত করার পর সংযোগ পরীক্ষা করতে এবং এটি কাজ করে কিনা তা যাচাই করতে পারেন।

স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশন নির্ধারণ করতে:

  1. নেভিগেশন মেনু থেকে, অ্যাকাউন্ট > সাবস্ক্রিপশন এ ক্লিক করুন এবং ওয়েবহুক ট্যাব নির্বাচন করুন।

  2. নতুন ওয়েবহুক এ ক্লিক করুন। নতুন ওয়েবহুক ইন্টিগ্রেশন প্যানেলটি খুলবে।

  3. ওয়েবহুক বিস্তারিত কনফিগার করুন:

    1. ইন্টিগ্রেশন নাম প্রবেশ করুন।

    2. স্লাইডারটি ক্লিক করে ইন্টিগ্রেশন সক্রিয় (সবুজ) বা নিষ্ক্রিয় (ধূসর) করুন (এটি ডিফল্টরূপে সক্রিয় থাকে)।

  4. ইন্টিগ্রেশনের জন্য JSON টেমপ্লেটের সেটিংস কনফিগার করুন:

    • টেমপ্লেট থেকে শুরু করুন এ, ইন্টিগ্রেশন সেটিংসগুলি পূরণ করে এমন ডিফল্ট JSON টেমপ্লেট নির্বাচন করুন।

      আপনি কাস্টম বডি এর জন্য ক্ষেত্রগুলি সমন্বয় এবং পরিবর্তন করতে পারেন (নীচে ধাপ ৭ দেখুন)।

    নোট: আপনি যদি অন্য একটি টেম্পলেট নির্বাচন করেন, তবে কাস্টম বডি এর ক্ষেত্রগুলি রিসেট হয়। টেমপ্লেটগুলি সম্পর্কে আরও তথ্যের জন্য, টেমপ্লেট এবং ক্ষেত্র দেখুন।

  5. সংযোগের বিবরণ কনফিগার করুন:

    1. ওয়েবহুক গ্রহণ করছে এমন সার্ভিসের জন্য URL প্রবেশ করুন।

      আপনি URL এ ক্ষেত্রগুলি ভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। উপলব্ধ ক্ষেত্রগুলি দেখতে $ টাইপ করুন।

    2. রিকোয়েস্ট মেথড এ, POST নির্বাচন করুন।

    3. প্রয়োজন হলে, সার্ভিসের জন্য প্রমাণীকরণ পদ্ধতি এবং সেটিংস কনফিগার করুন।

  6. (ঐচ্ছিক) কাস্টম হেডার এ, ইন্টিগ্রেশনের জন্য অতিরিক্ত HTTP হেডারের জন্য কী এবং মান সংজ্ঞায়িত করুন।

  7. কাস্টম বডি এ, ওয়েবহুক বিজ্ঞপ্তির বিষয়বস্তু সংজ্ঞায়িত করুন:

    1. প্রতিক্রিয়া করেলেশন আইডি এ, আপনার তৃতীয় পক্ষের আইটেম সংজ্ঞায়িত করুন যা আপনি URL এ করেলেশনের জন্য ব্যবহার করবেন। উদাহরণস্বরূপ, ServiceNow এ এটি হতে পারে result.sys_id, এবং Zendesk এ এটি হতে পারে ticket.id।

    2. (ঐচ্ছিক) বডি সম্পাদনা করুন এ বিষয়বস্তু কাস্টমাইজ করুন।

      • বডিতে $ ব্যবহার করতে / এস্কেপ চরিত্র লিখুন

      • অন্যান্য ক্ষেত্রগুলি এম্বেড করতে $ লিখুন

    3. ডিফল্ট মান নির্ধারণ করতে, ${field:defaultValue} ফর্ম্যাট ব্যবহার করুন, উদাহরণস্বরূপ ${ID:12345}

  8. পরীক্ষা করুন এ ক্লিক করুন। CMA ক্ষেত্রগুলির জন্য স্বয়ংক্রিয়ভাবে তৈরি কনটেন্ট সহ একটি পরীক্ষা HTTP অনুরোধ প্রেরণ করে।

    যদি ইন্টিগ্রেশন সার্ভিসের সাথে সংযোগ স্থাপন করতে পারে, তাহলে পরীক্ষা সফলভাবে সম্পন্ন হয়েছে। বার্তা প্রদর্শিত হয়।

    যদি কোনো সংযোগ ত্রুটি থাকে, তাহলে পৃষ্ঠা এইচটিটিপি ত্রুটি কোড এবং সার্ভিস দ্বারা রিপোর্টেড বার্তাটি প্রদর্শিত হয়।

  9. সংরক্ষণ করুন ক্লিক করুন। ওয়েবহুক ইন্টিগ্রেশন সংরক্ষিত হয়েছে এবং সাবস্ক্রিপশন পৃষ্ঠায় ইন্টিগ্রেশন ট্যাব এ যোগ করা হয়েছে।

কোরিলেটেড ওয়েবহুক সংজ্ঞায়িত করুন

একটি সম্পর্কিত ওয়েবহুক ইন্টিগ্রেশন তৈরি করুন যা আপনার তৃতীয় পক্ষের টুলের মাধ্যমে আইটেমগুলির মাধ্যমে বিজ্ঞপ্তিগুলি পাঠায় পূর্ববর্তী পদ্ধতিতে তৈরি করা আইটেমগুলি আপডেট করে।

আপনি একটি সংযুক্ত ওয়েবহুক কনফিগার করলে, ইউআরএলটি তৃতীয়-প্রান্তের প্ল্যাটফর্মে সঠিক আইটেম আপডেট করতে সামঞ্জস্য আইডি ব্যবহার করে। যদি সামঞ্জস্য আইডি মান ফাঁকা হয়, আপডেটটি বিদ্যমান আইটেমের সাথে মিলিত হতে পারে না এবং হারিয়ে যায়। এটি প্রতিরোধ করতে, মূল টিকেট, ইস্যু, অথবা বার্তা তৈরি করার সময় স্ট্যান্ডার্ড ওয়েবহুকের কাস্টম বডিতে আইটেম ID যোগ করুন। এটি সংযুক্ত ওয়েবহুককে সামঞ্জস্য ক্ষেত্রের ফলব্যাক মান হিসেবে সেই আইডি ব্যবহার করতে দেয়, যেন গল্প জীবনচক্রের মধ্য দিয়ে মূল আইটেমে আপডেটগুলি প্রয়োগ করা চালিয়ে যায়।

বিস্তারিত নির্ধারণ করার পর, আপনি সংযোগ পরীক্ষা করতে পারেন এবং এটি কাজ করছে কিনা তা যাচাই করতে পারেন।

একটি সম্পর্কিত ওয়েবহুক ইন্টিগ্রেশন নির্ধারণ করতে:

  1. নেভিগেশন মেনু থেকে, অ্যাকাউন্ট > সাবস্ক্রিপশন এ ক্লিক করুন এবং ওয়েবহুক ট্যাব নির্বাচন করুন।

  2. নতুন ওয়েবহুক এ ক্লিক করুন। নতুন ওয়েবহুক ইন্টিগ্রেশন প্যানেলটি খুলবে।

  3. ওয়েবহুক বিস্তারিত কনফিগার করুন:

    1. ইন্টিগ্রেশন নাম প্রবেশ করুন।

    2. স্লাইডারটি ক্লিক করে ইন্টিগ্রেশন সক্রিয় (সবুজ) বা নিষ্ক্রিয় (ধূসর) করুন (এটি ডিফল্টরূপে সক্রিয় থাকে)।

  4. ইন্টিগ্রেশনের জন্য JSON টেমপ্লেটের সেটিংস কনফিগার করুন:

    • টেমপ্লেট থেকে শুরু করুন এ, ইন্টিগ্রেশন সেটিংসগুলি পূরণ করে এমন ডিফল্ট JSON টেমপ্লেট নির্বাচন করুন।

      আপনি কাস্টম বডি এর জন্য ক্ষেত্রগুলি সমন্বয় এবং পরিবর্তন করতে পারেন (নীচে ধাপ ৭ দেখুন)।

    নোট: আপনি যদি অন্য একটি টেমপ্লেট নির্বাচন করেন, তবে কাস্টম বডি এর ক্ষেত্রগুলি রিসেট হয়। টেমপ্লেটগুলি সম্পর্কে আরও তথ্যের জন্য, টেমপ্লেট এবং ক্ষেত্র দেখুন।

  5. সংযোগের বিবরণ কনফিগার করুন:

    1. ওয়েবহুক গ্রহণ করছে এমন সার্ভিসের জন্য URL প্রবেশ করুন। বিদ্যমান আইটেমের সাথে সম্পর্কিত করে করেলেটেড আইটেম আইডি ক্ষেত্র যোগ করুন।

      আপনি URL এ ক্ষেত্রগুলি ভেরিয়েবল হিসেবে ব্যবহার করতে পারেন। উপলব্ধ ক্ষেত্রগুলি দেখতে $ টাইপ করুন।

    2. রিকোয়েস্ট মেথড এ, PUT নির্বাচন করুন।

    3. প্রয়োজন হলে, সার্ভিসের জন্য প্রমাণীকরণ পদ্ধতি এবং সেটিংস কনফিগার করুন।

  6. (ঐচ্ছিক) কাস্টম হেডার এ, ইন্টিগ্রেশনের জন্য অতিরিক্ত HTTP হেডারের জন্য কী এবং মান সংজ্ঞায়িত করুন।

  7. কাস্টম বডি এ, ওয়েবহুক বিজ্ঞপ্তির বিষয়বস্তু সংজ্ঞায়িত করুন:

    1. (ঐচ্ছিক) বডি সম্পাদনা করুন এ বিষয়বস্তু কাস্টমাইজ করুন।

      • বডিতে $ ব্যবহার করতে / এস্কেপ চরিত্র লিখুন

      • অন্যান্য ক্ষেত্রগুলি এম্বেড করতে $ লিখুন

    2. ডিফল্ট মান নির্ধারণ করতে, ${field:defaultValue} ফর্ম্যাট ব্যবহার করুন, উদাহরণস্বরূপ ${ID:12345}

  8. পরীক্ষা করুন এ ক্লিক করুন। CMA ক্ষেত্রগুলির জন্য স্বয়ংক্রিয়ভাবে তৈরি কনটেন্ট সহ একটি পরীক্ষা HTTP অনুরোধ প্রেরণ করে।

    যদি ইন্টিগ্রেশন সার্ভিসের সাথে সংযোগ স্থাপন করতে পারে, তাহলে পরীক্ষা সফলভাবে সম্পন্ন হয়েছে। বার্তা প্রদর্শিত হয়।

    যদি কোনো সংযোগ ত্রুটি থাকে, তাহলে পৃষ্ঠা এইচটিটিপি ত্রুটি কোড এবং সার্ভিস দ্বারা রিপোর্টেড বার্তাটি প্রদর্শিত হয়।

  9. সংরক্ষণ করুন এ ক্লিক করুন। ওয়েবহুক ইন্টিগ্রেশন সংরক্ষিত হয়েছে এবং সাবস্ক্রিপশন পৃষ্ঠায় ইন্টিগ্রেশন ট্যাব এ যোগ করা হয়েছে।

স্ট্যান্ডার্ড ওয়েবহুক ইন্টিগ্রেশনের জন্য ট্রিগার নির্ধারণ করুন

স্ট্যান্ডার্ড ওয়েবহুকগুলি CMA এর বিজ্ঞপ্তি দ্বারা সক্রিয় হয়। আপনি দুই ধরনের বিজ্ঞপ্তি কনফিগার করতে পারেন:

  1. CMA বিজ্ঞপ্তি: CMA আপনার অ্যাকাউন্ট সম্পর্কে সক্রিয়ভাবে বিজ্ঞপ্তি পাঠাতে পারে, যেমন লকড ইউজার এবং অ্যাডমিনিস্ট্রেটররা, বা লাইসেন্স আপডেট। এই বিজ্ঞপ্তিগুলি সরাসরি ওয়েবহুক ইন্টিগ্রেশনের মাধ্যমে পাঠানো যেতে পারে।

    অধিক তথ্যের জন্য, অ্যাকাউন্ট স্তরের সতর্কতা এবং সিস্টেম বিজ্ঞপ্তি দেখুন।

  2. নীতি নিয়ম বিজ্ঞপ্তি: আপনি যখন নিয়ম মেলানো হয় তখন ওয়েবহুকে বিজ্ঞপ্তি পাঠাতে নীতি নিয়মে ট্র্যাক সেটিং কনফিগার করতে পারেন।

নীতিতে নিয়ম সংজ্ঞায়িত করার সময়, আপনি ওয়েবহুক ইন্টিগ্রেশনের মাধ্যমে বিজ্ঞপ্তি পাঠাতে ক্রিয়াকলাপ এলাকা ব্যবহার করতে পারেন।

rule_webhook.png

ট্রিগার নির্ধারণ করুন সংযুক্ত ইন্টিগ্রেশন জন্য নির্ধারণ সনাক্তকরণ এবং প্রতিক্রিয়া বিজ্ঞপ্তিগুলির ব্যবহার করে

সনাক্তকরণ এবং প্রতিক্রিয়া নীতিগুলির সাথে, আপনি কোরিলেটেড XOps গল্পগুলির জন্য তৃতীয় পক্ষের প্ল্যাটফর্মগুলিতে আইটেম তৈরি এবং আপডেট স্বয়ংক্রিয় করতে পারেন। সুতরাং আপনার বাহ্যিক সিস্টেম সর্বদা বর্তমান কাহিনী স্থিতি প্রতিফলিত করে।

নীতিতে নিয়ম কনফিগার করতে পারেন:

  • গল্প তৈরি হয়েছে: একটি কোরিলেটেড ওয়েবহুক ট্রিগার করুন যা নতুন একটি আইটেম তৈরি করে

  • গল্প আপডেট হয়েছে: একটি কোরিলেটেড ওয়েবহুক ট্রিগার করুন যা গল্পের অগ্রগতির সাথে একই আইটেম আপডেট করে

গল্পগুলি সিঙ্ক্রোনাইজ রাখতে, দুটি নিয়ম কনফিগার করুন: গল্পটি শুরু হলে আইটেমটি তৈরি করতে একটি এবং গল্পটি পরিবর্তিত হলে এটি আপডেট করতে একটি।

একটি ওয়েবহুক বিজ্ঞপ্তির জন্য ট্রিগার সংজ্ঞায়িত করতে:

  1. নেভিগেশন মেনু থেকে, প্রথম পৃষ্ঠা > সনাক্তকরণ ও প্রতিক্রিয়া নীতি এ ক্লিক করুন।

  2. প্রতিক্রিয়া নীতি ট্যাব নির্বাচন করুন।

  3. নতুন ক্লিক করুন। প্রতিক্রিয়া নীতিতে যোগ করুন প্যানেলটি খোলে।

  4. নিয়মটির জন্য একটি নাম লিখুন।

  5. উত্স বিভাগে, প্রকার নির্বাচন করুন (উদাহরণস্বরূপ: হোস্ট, আইপি রেঞ্জ, সাইট) এবং তারপরে এই নিয়মের জন্য গল্প উত্সের জন্য এক বা একাধিক অবজেক্ট নির্বাচন করুন (অথবা আপনি একটি IP ঠিকানা প্রবেশ করতে পারেন)।

    ডিফল্ট উত্স মান যেকোনো।

  6. (ঐচ্ছিক) ক্রাইটেরিয়া সংজ্ঞায়িত করুন যা একটি গল্প কাহিনীটি মেলানোর জন্য তার বৈশিষ্ট্যগুলি নির্দিষ্ট করে।

  7. নিয়মের জন্য ট্রিগার নির্বাচন করুন। 

    • গল্প তৈরি হয়েছে নতুন আইটেম তৈরি করার জন্য

    • গল্প আপডেট হয়েছে বিদ্যমান আইটেম আপডেট করার জন্য

  8. প্রতিক্রিয়া ট্যাবে, বিজ্ঞপ্তি পাঠান নির্বাচন করুন।

  9. বিজ্ঞপ্তি পাঠানোর জন্য এ, ইন্টিগ্রেশন নির্বাচন করুন।

  10. ইন্টিগ্রেশন এ, সেই ওয়েবহুকস ইন্টিগ্রেশনটি নির্বাচন করুন যা বিজ্ঞপ্তি পাঠাচ্ছে।

  11. সংরক্ষণ করুন এ ক্লিক করুন। নিয়মটি নীতিতে যোগ করা হয়।

টেমপ্লেট এবং ক্ষেত্রসমূহ

প্রত্যেক ওয়েবহুককে আপনার তৃতীয়-পক্ষের সিস্টেমের ফরম্যাট এবং আচরণের সাথে সামঞ্জস্য করার জন্য সম্পূর্ণরূপে কাস্টমাইজ করা যেতে পারে। ওয়েবহুকটি JSON ফরম্যাটে প্রদান করা হয় এবং লক্ষ্য প্ল্যাটফর্ম কাঠামোর সাথে ফিট করার জন্য সংশোধন করা যেতে পারে। স্থিত এবং গতিশীল উভয় পে লোডের জন্য কেটো ক্ষেত্র ভেরিয়েবলগুলি ব্যবহার করুন।

একটি টেমপ্লেট নির্বাচন করার পর, আপনি একটি JSON পে লোড হিসাবে বডি সম্পাদনা করতে পারেন এবং একটি কাস্টম টেমপ্লেট হিসাবে এটি সংরক্ষণ করতে পারেন। আপনার কাছে JSON-এ তথ্য ক্ষেত্র এম্বেড করার বিকল্পও রয়েছে, যা পে-লোডে সংশ্লিষ্ট মানটি রাখবে (অথবা NA যদি উপলব্ধ না থাকে)।

যখন আপনি $ টাইপ করেন, উপলব্ধ ক্ষেত্রগুলি প্রদর্শিত হয়। কাটো ফিল্ড সম্পর্কে আরও তথ্যের জন্য, Understanding the JSON Fields for Alert Integrations দেখুন।

আপনি একটি ওয়েবহুক তৈরি করার সময় এই টেমপ্লেটগুলি থেকে নির্বাচন করতে পারেন:

  • সব ক্ষেত্র - প্রতিটি উপলব্ধ ক্ষেত্র অন্তর্ভুক্ত করে

  • বেসিক - সবচেয়ে সাধারণত ব্যবহৃত ক্ষেত্রগুলির একটি টেমপ্লেট

  • জিরা - একটি মৌলিক জিরা টেমপ্লেট

  • ServiceNow নতুন টিকিট তৈরি করুন - ServiceNow-এ একটি নতুন টিকিট তৈরি করে

  • ServiceNow টিকিট আপডেট করুন - ServiceNow-এ একটি বিদ্যমান টিকিট আপডেট করে

  • Slack - একটি Slack চ্যানেলে একটি বার্তা পাঠায়

  • Zendesk নতুন টিকিট তৈরি করুন - Zendesk-এ একটি নতুন টিকিট তৈরি করে

  • Zendesk টিকিট আপডেট করুন - একটি বিদ্যমান Zendesk টিকিট আপডেট করে

  • কাস্টম - একটি টেমপ্লেটের জন্য সেটিংস কাস্টমাইজ করুন

আপনি ওয়েবহুক ইন্টিগ্রেশনের URL সংজ্ঞায়িত করার সময় ক্ষেত্রগুলি ব্যবহার করতে পারেন।

এই নিবন্ধটি কি সহায়ক ছিল?

1 জনের মধ্যে 0 জন এটিকে সহায়ক বলে মনে করেছেন

0 মন্তব্য