ওয়েবহুকস ব্যাখ্যা: স্বাক্ষরিত পেলোড এবং নির্ভরযোগ্য পুনঃপ্রচেষ্টা

Backend2026-11-17TryQuickToolBox

আপনি সবেমাত্র একটি তৃতীয় পক্ষের পরিষেবা সংহত করেছেন যা আপনার এন্ডপয়েন্টে ওয়েবহুক পাঠায়। পরীক্ষায় সবকিছু কাজ করে, কিন্তু উৎপাদনে আপনি মিস করা ইভেন্ট, ডুপ্লিকেট ডেলিভারি এবং এমনকি জাল অনুরোধ লক্ষ্য করেন। ওয়েবহুকস ধারণাগতভাবে সহজ কিন্তু সঠিকভাবে করা কঠিন। এই নিবন্ধে ব্যাখ্যা করা হয়েছে কীভাবে স্বাক্ষরিত পেলোড দিয়ে ওয়েবহুকস সুরক্ষিত করবেন এবং নির্ভরযোগ্য পুনঃপ্রচেষ্টা যুক্তি প্রয়োগ করবেন যাতে আপনার ইন্টিগ্রেশনগুলি শক্তিশালী এবং বিশ্বাসযোগ্য হয়।

ওয়েবহুকস কী এবং কেন তারা গুরুত্বপূর্ণ

ওয়েবহুকস হল ইভেন্ট দ্বারা ট্রিগার করা ব্যবহারকারী-সংজ্ঞায়িত HTTP কলব্যাক। পরিবর্তনের জন্য একটি API পোলিং করার পরিবর্তে, আপনি একটি URL নিবন্ধন করেন এবং কিছু ঘটলে পরিষেবাটি ইভেন্ট ডেটা সহ একটি POST অনুরোধ পাঠায়। এই পুশ মডেল লেটেন্সি এবং সার্ভার লোড কমায়, যা পেমেন্ট বিজ্ঞপ্তি, CI/CD ট্রিগার এবং চ্যাট বার্তাগুলির মতো রিয়েল-টাইম ইন্টিগ্রেশনের জন্য আদর্শ করে তোলে।

যাইহোক, ওয়েবহুকস চ্যালেঞ্জ উপস্থাপন করে: সত্যতা যাচাই করা, ব্যর্থতাগুলি পরিচালনা করা এবং ঠিক-একবার প্রক্রিয়াকরণ নিশ্চিত করা। আসুন এগুলিকে একে একে মোকাবেলা করি।

স্বাক্ষরিত পেলোড দিয়ে ওয়েবহুকস সুরক্ষিত করা

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

HMAC স্বাক্ষর কীভাবে কাজ করে

বেশিরভাগ পরিষেবা SHA-256 সহ HMAC (হ্যাশ-ভিত্তিক বার্তা প্রমাণীকরণ কোড) ব্যবহার করে। প্রেরক সিক্রেট ব্যবহার করে অনুরোধ বডির (এবং কখনও কখনও একটি টাইমস্ট্যাম্প) একটি হ্যাশ গণনা করেন এবং এটি X-Signature-এর মতো একটি হেডারে অন্তর্ভুক্ত করেন। আপনি আপনার দিকে হ্যাশটি পুনরায় গণনা করেন এবং তুলনা করেন।

Node.js-এ একটি সাধারণ যাচাইকরণ প্রবাহ এখানে:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

টাইমিং আক্রমণ প্রতিরোধ করতে সর্বদা টাইমিং-সেফ তুলনা ব্যবহার করুন। এছাড়াও, স্বাক্ষরিত ডেটাতে একটি টাইমস্ট্যাম্প অন্তর্ভুক্ত করুন এবং রিপ্লে আক্রমণ প্রতিরোধ করতে কয়েক মিনিটের চেয়ে পুরানো অনুরোধগুলি প্রত্যাখ্যান করুন।

স্বাক্ষর যাচাইয়ের জন্য সর্বোত্তম অনুশীলন

নির্ভরযোগ্য পুনঃপ্রচেষ্টা প্রয়োগ করা

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

পুনঃপ্রচেষ্টা কৌশল

বেশিরভাগ প্রদানকারী জিটার সহ এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করে। উদাহরণস্বরূপ, 1 মিনিট পরে, তারপর 5 মিনিট পরে, তারপর 30 মিনিট পরে, সর্বোচ্চ সংখ্যক প্রচেষ্টা পর্যন্ত (যেমন, 5)। পেলোডে একটি অনন্য ইভেন্ট আইডি অন্তর্ভুক্ত করুন যাতে প্রাপক ডুপ্লিকেট করতে পারেন।

গ্রহণকারী দিকে, প্রাপ্তি স্বীকার করতে দ্রুত একটি 2xx স্ট্যাটাস দিয়ে সাড়া দিন, তারপর অ্যাসিঙ্ক্রোনাসভাবে প্রক্রিয়া করুন। যদি প্রক্রিয়াকরণ ব্যর্থ হয়, আপনি প্রেরকের উপর অনির্দিষ্টকালের জন্য পুনঃপ্রচেষ্টা করার উপর নির্ভর করতে পারবেন না—আপনার নিজের ডেড-লেটার কিউ বা সতর্কতা প্রয়োগ করুন।

আইডেম্পোটেন্সি কী

ডুপ্লিকেট ডেলিভারি পরিচালনা করতে, একটি আইডেম্পোটেন্সি কী (প্রায়শই ইভেন্ট আইডি) ব্যবহার করুন এবং একটি যুক্তিসঙ্গত সময়ের জন্য প্রক্রিয়াকৃত আইডিগুলি সংরক্ষণ করুন। প্রক্রিয়াকরণের আগে, আইডিটি দেখা হয়েছে কিনা তা পরীক্ষা করুন; যদি তাই হয়, পুনরায় প্রক্রিয়া না করে সফলতা ফেরত দিন।

// উদাহরণ: Express-এ আইডেম্পোটেন্সি চেক
app.post('/webhook', async (req, res) => {
  const eventId = req.body.id;
  if (await db.seenEvents.has(eventId)) {
    return res.status(200).send('Already processed');
  }
  await db.seenEvents.add(eventId);
  // ইভেন্ট অ্যাসিঙ্ক্রোনাসভাবে প্রক্রিয়া করুন
  res.status(200).send('OK');
});

তুলনা: পোলিং বনাম ওয়েবহুকস

দিকপোলিংওয়েবহুকস
লেটেন্সিউচ্চ (ব্যবধান-ভিত্তিক)কম (প্রায় রিয়েল-টাইম)
সার্ভার লোডউচ্চ (ঘন ঘন অনুরোধ)কম (ইভেন্ট-চালিত)
জটিলতাবাস্তবায়ন করা সহজস্বাক্ষর যাচাইকরণ এবং পুনঃপ্রচেষ্টা প্রয়োজন
নির্ভরযোগ্যতাপোলিং ফ্রিকোয়েন্সির উপর নির্ভর করেপুনঃপ্রচেষ্টা প্রক্রিয়ার উপর নির্ভর করে

ধাপে ধাপে: একটি নিরাপদ ওয়েবহুক রিসিভার তৈরি করা

  1. একটি এন্ডপয়েন্ট সেট আপ করুন যা HTTPS-এর মাধ্যমে POST অনুরোধ গ্রহণ করে।
  2. শেয়ার্ড সিক্রেট ব্যবহার করে স্বাক্ষর যাচাই করুন এবং অবৈধ অনুরোধগুলি 401 দিয়ে প্রত্যাখ্যান করুন।
  3. টাইমস্ট্যাম্প পরীক্ষা করুন রিপ্লে আক্রমণ প্রতিরোধ করতে।
  4. মৌলিক যাচাইয়ের পরে অবিলম্বে 200 OK দিয়ে সাড়া দিন, তারপর অ্যাসিঙ্ক্রোনাসভাবে প্রক্রিয়া করুন।
  5. আইডেম্পোটেন্সি প্রয়োগ করুন ডুপ্লিকেট প্রক্রিয়াকরণ এড়াতে ইভেন্ট আইডি ব্যবহার করে।
  6. ব্যর্থতা এবং পুনঃপ্রচেষ্টাগুলি লগ এবং পর্যবেক্ষণ করুন।

সাধারণ জিজ্ঞাসা

একটি স্বাক্ষরিত ওয়েবহুক পেলোড কী?

একটি স্বাক্ষরিত পেলোডে একটি ক্রিপ্টোগ্রাফিক স্বাক্ষর (সাধারণত HMAC) থাকে যা প্রাপককে একটি শেয়ার্ড সিক্রেট ব্যবহার করে অনুরোধের সত্যতা এবং অখণ্ডতা যাচাই করতে দেয়।

একটি ব্যর্থ ওয়েবহুক কতবার পুনরায় চেষ্টা করা উচিত?

সাধারণ অনুশীলন হল এক্সপোনেনশিয়াল ব্যাকঅফ সহ 3–5 বার পুনঃপ্রচেষ্টা। এর পরে, ম্যানুয়াল পরিদর্শনের জন্য ইভেন্টটি একটি ডেড-লেটার কিউতে সরান।

আমি কি HTTPS ছাড়া ওয়েবহুক ব্যবহার করতে পারি?

না, পেলোড এবং স্বাক্ষরকে ইভসড্রপিং এবং টেম্পারিং থেকে রক্ষা করতে HTTPS অপরিহার্য। সর্বদা TLS ব্যবহার করুন।

আপনার ওয়েবহুক পেলোড পরীক্ষা করতে প্রস্তুত? দ্রুত JSON পেলোডগুলি সুন্দরভাবে মুদ্রণ এবং যাচাই করতে আমাদের JSON ফরম্যাটার ব্যবহার করুন।