এন্টারপ্রাইজ আর্কিটেকচার গাইড
এন্টারপ্রাইজ এপিআই ও ওয়েবহুক ইন্টিগ্রেশন প্ল্যানিং গাইড
ফল্ট-টলারেন্ট এবং ডিস্ট্রিবিউটেড এপিআই ইন্টিগ্রেশন তৈরির জন্য একটি বিস্তারিত আর্কিটেকচার গাইড। ক্রিপ্টোগ্রাফিক 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 ওয়ার্কফ্লো ডিজাইন করে।