എന്റർപ്രൈസ് ആർക്കിടെക്ചർ ഗൈഡ്
എന്റർപ്രൈസ് API ഉം വെബ്ഹുക്ക് ഇന്റഗ്രേഷൻ ആസൂത്രണ ഗൈഡ്
വിശ്വസനീയമായ 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 വർക്ക്ഫ്ലോകളും നിർമ്മിക്കുന്നു.