İçeriğe geç
Webhook'lar

Webhook Güvenliği

Her webhook isteği, gövdenin client_secret anahtarınızla üretilmiş HMAC-SHA256 imzasını X-Ideashop-Hmac-Sha256 başlığında taşır:

Code
base64( hmac_sha256( <raw request body>, <client_secret> ) )

Ham gövde kullanın

İmzayı hesaplarken JSON'u parse edip yeniden serileştirmeyin; baytı baytına ham istek gövdesi üzerinden hesaplayın.

PHP

En sade doğrulama adımı (ham gövde + HMAC üretimi):

PHPCode
$data = file_get_contents('php://input'); base64_encode(hash_hmac('sha256', $data, $secret, true));

Tam doğrulama örneği:

PHPCode
<?php $rawBody = file_get_contents('php://input'); $expected = base64_encode(hash_hmac('sha256', $rawBody, $clientSecret, true)); $received = $_SERVER['HTTP_X_IDEASHOP_HMAC_SHA256'] ?? ''; if (!hash_equals($expected, $received)) { http_response_code(401); exit('invalid signature'); }

Node.js

JavascriptCode
const crypto = require("crypto"); const expected = crypto .createHmac("sha256", clientSecret) .update(rawBody) // Buffer olarak ham gövde .digest("base64"); const valid = received.length === expected.length && crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

hash_equals / timingSafeEqual gibi sabit-zamanlı karşılaştırma kullanın; === ile karşılaştırmayın.

Son güncelleme: