İmza Doğrulama
Webhook güvenliği, HMAC‑SHA256 imza doğrulaması ile sağlanır. Tüm webhook istekleri, X-Adisyo-Signature header'ı ile imzalanır.
İmza Algoritması
İmza Hesaplama
Message = webhookEventType + "|" + eventTimeUtc + "|" + ApiKey
Signature = Base64(HMACSHA256(key: ApiKey, data: Message))webhookEventType ve eventTimeUtc, gelen isteğin body'sindeki alanlardır. HMAC anahtarı olarak da API Key kullanılır.
Test Verisi
Yazdığınız fonksiyonu aşağıdaki değerlerle deneyebilirsiniz. Sonuç beklenen imzayla birebir aynı olmalıdır.
| Değer | |
|---|---|
| API Key | ADSYO-TEST-KEY |
webhookEventType | order.created |
eventTimeUtc | 2025-10-21T11:59:50.1855130Z |
| Beklenen imza | PnzyRcuQLC2wN763P7kyuXdEBjYQogFOM/69/e0Vb1I= |
Bu değerlerle oluşan Message:
order.created|2025-10-21T11:59:50.1855130Z|ADSYO-TEST-KEYHeader formatı
X-Adisyo-Signature: <base64-encoded-signature>Kod Örnekleri
Node.js
import { createHmac, timingSafeEqual } from 'crypto';
function verifySignature(payload, signature, apiKey) {
const webhookData = JSON.parse(payload);
const message = `${webhookData.webhookEventType}|${webhookData.eventTimeUtc}|${apiKey}`;
const expectedSignature = createHmac('sha256', apiKey)
.update(message)
.digest('base64');
return timingSafeEqual(
Buffer.from(signature),
Buffer.from(expectedSignature)
);
}
// Kullanım
app.post('/webhook', (req, res) => {
const signature = req.headers['x-adisyo-signature'];
const apiKey = process.env.ADISYO_API_KEY;
if (!verifySignature(JSON.stringify(req.body), signature, apiKey)) {
return res.status(401).json({ error: 'Invalid signature' });
}
// Webhook işle
res.status(200).json({ success: true });
});