ਐਂਟਰਪ੍ਰਾਈਜ਼ ਆਰਕੀਟੈਕਚਰ ਗਾਈਡ
ਐਂਟਰਪ੍ਰਾਈਜ਼ ਏਪੀਆਈ ਅਤੇ ਵੈੱਬਹੁੱਕ ਏਕੀਕਰਣ ਯੋਜਨਾਬੰਦੀ ਗਾਈਡ
ਮਜ਼ਬੂਤ API ਏਕੀਕਰਣ ਬਣਾਉਣ ਵਾਲੇ ਸਾਫਟਵੇਅਰ ਆਰਕੀਟੈਕਟਾਂ ਲਈ ਵਿਸਤ੍ਰਿਤ ਇੰਜੀਨੀਅਰਿੰਗ ਗਾਈਡ। ਕ੍ਰਿਪਟੋਗ੍ਰਾਫਿਕ HMAC, ਰੈਡਿਸ ਆਈਡੈਂਪੋਟੈਂਸੀ ਅਤੇ ਕਿਊਜ਼।
ਸੁਰੱਖਿਅਤ ਕ੍ਰਿਪਟੋਗ੍ਰਾਫੀ ਵੰਡੀ ਗਈ ਆਈਡੈਂਪੋਟੈਂਸੀ n8n ਅਤੇ Node.js ਪੈਟਰਨ
1. HMAC SHA-256 ਦਸਤਖਤ
ਗੈਰ-ਪ੍ਰਮਾਣਿਤ ਵੈੱਬਹੁੱਕਾਂ ਤੇ ਕਦੇ ਭਰੋਸਾ ਨਾ ਕਰੋ। ਸਾਈਡ-ਚੈਨਲ ਹਮਲਿਆਂ ਨੂੰ ਰੋਕਣ ਲਈ ਸੁਰੱਖਿਅਤ ਤੁਲਨਾ ਨਾਲ ਪੇਲੋਡ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ।
2. ਡਿਸਟ੍ਰੀਬਿਊਟਿਡ ਆਈਡੈਂਪੋਟੈਂਸੀ
Redis SETNX ਲਾਕ ਡੁਪਲੀਕੇਟ ਭੁਗਤਾਨਾਂ ਅਤੇ ਡੇਟਾਬੇਸ ਗਲਤੀਆਂ ਨੂੰ ਰੋਕਦੇ ਹਨ।
3. ਅਸਿੰਕ੍ਰੋਨਸ ਡੀਕਪਲਿੰਗ
ਹਮੇਸ਼ਾ 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 });
}
}ਐਂਟਰਪ੍ਰਾਈਜ਼ ਏਕੀਕਰਣ ਇੰਜੀਨੀਅਰਿੰਗ ਦੀ ਲੋੜ ਹੈ?
ਆਪਣੇ CRM, ERP ਅਤੇ AI ਸਿਸਟਮਾਂ ਨੂੰ ਬਿਨਾਂ ਕਿਸੇ ਖਾਮੀ ਦੇ ਜੋੜੋ
Trustoryx ਭਰੋਸੇਯੋਗ API ਪਾਈਪਲਾਈਨਾਂ ਅਤੇ ਆਟੋਮੇਸ਼ਨ ਕਨੈਕਟਰ ਤਿਆਰ ਕਰਦਾ ਹੈ।