Skip to main content
TRUSTORYX.
এন্টারপ্রাইজ আর্কিটেকচার গাইড

এন্টারপ্রাইজ এপিআই ও ওয়েবহুক ইন্টিগ্রেশন প্ল্যানিং গাইড

ফল্ট-টলারেন্ট এবং ডিস্ট্রিবিউটেড এপিআই ইন্টিগ্রেশন তৈরির জন্য একটি বিস্তারিত আর্কিটেকচার গাইড। ক্রিপ্টোগ্রাফিক HMAC, রেডিস আইডেমপোটেন্সি এবং ডেড-লেটার কিউ।

টাইমিং-নিরাপদ ক্রিপ্টোগ্রাফি ডিস্ট্রিবিউটেড আইডেমপোটেন্সি n8n ও Node.js প্যাটার্ন

১. HMAC SHA-256 স্বাক্ষর

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

২. ডিস্ট্রিবিউটেড আইডেমপোটেন্সি

নেটওয়ার্ক সংযোগ ড্রপ হলে পুনরায় চেষ্টা করে। ২৪ ঘণ্টার জন্য Redis SETNX লক ডুপ্লিকেট পেমেন্ট ও ডাটাবেজ ক্ষতি প্রতিরোধ করে।

৩. অ্যাসিঙ্ক্রোনাস ডিকপলিং

সর্বদা HTTP 202 Accepted দিয়ে সাথে সাথে স্বীকার করুন। গেটওয়ে টাইমআউট এড়াতে ব্যাকগ্রাউন্ড কিউতে প্রসেসিং পাঠান।

// Next.js 16 App Router: Idempotent Webhook Consumer with Timing-Safe HMAC
import { NextRequest, NextResponse } from 'next/server';
import crypto from 'crypto';

const WEBHOOK_SECRET = process.env.STRIPE_OR_PARTNER_SECRET!;

export async function POST(req: NextRequest) {
  try {
    const rawBody = await req.text();
    const signature = req.headers.get('x-signature') || '';
    const idempotencyKey = req.headers.get('idempotency-key');

    if (!idempotencyKey) {
      return NextResponse.json({ error: 'Missing Idempotency-Key header' }, { status: 400 });
    }

    // 1. Timing-Safe HMAC Verification
    const expectedSig = crypto
      .createHmac('sha256', WEBHOOK_SECRET)
      .update(rawBody)
      .digest('hex');

    const isValid = crypto.timingSafeEqual(
      Buffer.from(signature, 'hex'),
      Buffer.from(expectedSig, 'hex')
    );

    if (!isValid) {
      return NextResponse.json({ error: 'Invalid HMAC Signature' }, { status: 401 });
    }

    // 2. Distributed Redis Idempotency Check (Atomic SETNX with 24h TTL)
    // const isNew = await redis.set(`idempotency:${idempotencyKey}`, 'processing', 'EX', 86400, 'NX');
    // if (!isNew) return NextResponse.json({ status: 'already_processed' }, { status: 200 });

    // 3. Immediately acknowledge HTTP 202 and push to background worker queue
    // await jobQueue.add('process_event', { payload: JSON.parse(rawBody) });

    return NextResponse.json({ received: true, status: 'queued' }, { status: 202 });
  } catch (error) {
    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
  }
}
এন্টারপ্রাইজ ইন্টিগ্রেশন ইঞ্জিনিয়ারিং প্রয়োজন?

আপনার সিআরএম, ইআরপি এবং এআই সিস্টেম নিরাপদে সংযুক্ত করুন

Trustoryx নির্ভরযোগ্য এপিআই পাইপলাইন ও সেল্ফ-হোস্টেড n8n ওয়ার্কফ্লো ডিজাইন করে।