انٹرپرائز آرکیٹیکچر گائیڈ
انٹرپرائز اے پی آئی اور ویب ہک انٹیگریشن پلاننگ گائیڈ
تقسیم شدہ API انٹیگریشنز بنانے والے سافٹ ویئر آرکیٹیکٹس کے لیے تفصیلی انجینئرنگ گائیڈ۔ کریپٹوگرافک HMAC، ریڈس آئیڈیمپوٹینسی اور قطاریں۔
ٹائمنگ محفوظ کرپٹوگرافی تقسیم شدہ آئیڈیمپوٹینسی n8n اور Node.js پیٹرنز
1. HMAC SHA-256 دستخط
غیر تصدیق شدہ ویب ہکس پر کبھی بھروسہ نہ کریں۔ سائیڈ چینل حملوں سے بچنے کے لیے ٹائمنگ سیف موازنے سے پے لوڈ کی تصدیق کریں۔
2. تقسیم شدہ آئیڈیمپوٹینسی
Redis SETNX تالے ڈپلیکیٹ ادائیگیوں اور ڈیٹا بیس کی خرابیوں کو روکتے ہیں۔
3. غیر مطابقت پذیر ڈی کپلنگ
ہمیشہ فوری طور پر HTTP 202 کے ساتھ جواب دیں۔ گیٹ وے ٹائم آؤٹ سے بچنے کے لیے پروسیسنگ کو بیک گراؤنڈ میں منتقل کریں۔
// 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 });
}
}انٹرپرائز انٹیگریشن انجینئرنگ کی ضرورت ہے؟
اپنے CRM، ERP اور AI سسٹمز کو بغیر کسی رکاوٹ کے جوڑیں
Trustoryx مضبوط API پائپ لائنز اور سیلف ہوسٹڈ n8n ورک فلوز بناتا ہے۔