ওয়েবহুক ব্যাখ্যা: সাইনড পেলোড এবং রিট্রাই স্ট্র্যাটেজি

Backend2026-11-12TryQuickToolBox

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

ওয়েবহুক কী এবং কেন তাদের নিরাপত্তা প্রয়োজন?

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

সাইনড পেলোড: সত্যতা এবং অখণ্ডতা নিশ্চিত করা

একটি সাইনড পেলোড প্রাপককে যাচাই করতে দেয় যে ওয়েবহুকটি একটি বিশ্বস্ত উৎস থেকে এসেছে এবং ডেটার সাথে ছेড়াছড়ি করা হয়নি। এটি সাধারণত একটি শেয়ার্ড সিক্রেট সহ HMAC (হ্যাশ-ভিত্তিক মেসেজ অথেন্টিকেশন কোড) ব্যবহার করে অর্জন করা হয়।

HMAC সাইনিং কীভাবে কাজ করে

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

এখানে HMAC-SHA256 ব্যবহার করে পাইথনে একটি উদাহরণ:

import hmac
import hashlib
import time

secret = b'your_shared_secret'
payload = b'{"event":"order.created","id":123}'
timestamp = str(int(time.time())).encode()
message = timestamp + b'.' + payload
signature = hmac.new(secret, message, hashlib.sha256).hexdigest()

# Send headers: X-Signature: signature, X-Timestamp: timestamp

প্রাপকের দিকে, স্বাক্ষর যাচাই করুন এবং নিশ্চিত করুন যে অনুরোধটি সাম্প্রতিক (যেমন, 5 মিনিটের মধ্যে) তার টাইমস্ট্যাম্প পরীক্ষা করে। এটি রিপ্লে আক্রমণ প্রতিরোধ করে।

সাইনড পেলোডের জন্য সেরা অনুশীলন

রিট্রাই মেকানিজম: নির্ভরযোগ্য ডেলিভারি নিশ্চিত করা

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

একটি রিট্রাই পলিসি ডিজাইন করা

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

উদাহরণ রিট্রাই সময়সূচী:

প্রচেষ্টাবিলম্ব
1তাৎক্ষণিক
21 মিনিট
35 মিনিট
430 মিনিট
52 ঘন্টা

রিট্রাই শেষ হওয়ার পরে, ম্যানুয়াল পরিদর্শনের জন্য ইভেন্টটি একটি ডেড-লেটার কিউতে সরান।

আইডেম্পোটেন্সি: ডুপ্লিকেট ডেলিভারি পরিচালনা করা

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

ওয়েবহুক প্রয়োগ: ধাপে ধাপে গাইড

  1. ইভেন্ট এবং পেলোড কাঠামো সংজ্ঞায়িত করুন: আপনার সিস্টেম যে ইভেন্টগুলি নির্গত করে এবং প্রতিটির জন্য JSON স্কিমা নথিভুক্ত করুন।
  2. একটি সিক্রেট তৈরি করুন: প্রতিটি ওয়েবহুক এন্ডপয়েন্টের জন্য একটি অনন্য সিক্রেট তৈরি করুন এবং নিরাপদে শেয়ার করুন।
  3. প্রতিটি অনুরোধ সাইন করুন: পেলোড এবং টাইমস্ট্যাম্পের উপর HMAC গণনা করুন, হেডারগুলিতে অন্তর্ভুক্ত করুন।
  4. ব্যাকঅফ সহ রিট্রাই প্রয়োগ করুন: রিট্রাই সময়সূচী করার জন্য একটি কিউ সিস্টেম ব্যবহার করুন।
  5. স্বাক্ষর যাচাই করার একটি উপায় প্রদান করুন: প্রাপকদের জন্য যাচাইকরণ প্রক্রিয়া নথিভুক্ত করুন।
  6. মনিটর এবং লগ করুন: ডিবাগিংয়ের জন্য ডেলিভারি প্রচেষ্টা এবং ব্যর্থতাগুলি ট্র্যাক করুন।

সাধারণ ভুল এবং কীভাবে এড়ানো যায়

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

একটি সাইনড ওয়েবহুক পেলোড কী?

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

ব্যর্থ ওয়েবহুক কতবার রিট্রাই করা উচিত?

সাধারণত এক্সপোনেনশিয়াল ব্যাকঅফ সহ 3 থেকে 5 বার রিট্রাই। সঠিক সংখ্যা আপনার SLA এবং ইভেন্টের গুরুত্বের উপর নির্ভর করে।

ওয়েবহুক স্বাক্ষরের জন্য HMAC এর পরিবর্তে JWT ব্যবহার করতে পারি?

হ্যাঁ, JWT ব্যবহার করা যেতে পারে, তবে HMAC ওয়েবহুক সাইনিংয়ের জন্য সহজ এবং আরও সাধারণ। JWT ওভারহেড যোগ করে এবং প্রমাণীকরণ টোকেনের জন্য আরও উপযুক্ত।

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