Entegrasyon
İmza doğrulama
HMAC-SHA256 doğrulaması — Node.js, TypeScript, PHP, Python, Go, C# ve Java örnekleri.
Formül
imza = HMAC_SHA256(secret, timestamp + "." + hamGövde)secret— abonelik oluştururken aldığınızwhsec_…değeritimestamp—Hikie-Timestampbaşlığı, saniye cinsinden Unix zamanıhamGövde— isteğin gövdesi, hiç dokunulmamış hâliyle
Sonuç küçük harfli hex, Hikie-Signature başlığında gelir.
Buradaki whsec_… yalnızca gelen isteği doğrulamak içindir. Yazılım
modülünün lisans doğrulama ucunu çağırırken kullanılan hsw_… anahtarı
bambaşkadır ve ters yönde çalışır — ikisinin karşılaştırması:
Lisans eventleri.
Aradaki ayraç bir nokta (.). Zaman damgası ile gövde arasına başka hiçbir
şey girmez.
Doğrulama sırası
Zaman damgası ile şimdiki zaman arasındaki fark ±300 saniye içinde mi?
Hesapladığınız imza ile gelen imza sabit zamanlı karşılaştırmada eşit mi?
Hikie-Webhook-Id daha önce işlenmiş mi?Örnekler
import crypto from 'node:crypto';
const TOLERANCE_SECONDS = 300;
/**
* @param {string} secret whsec_… ile başlayan abonelik secret'ı
* @param {string} rawBody isteğin ham gövdesi (string veya Buffer)
* @param {object} headers istek başlıkları (küçük harfli anahtarlar)
* @returns {boolean}
*/
export function verifyHikieSignature(secret, rawBody, headers) {
const timestamp = headers['hikie-timestamp'];
const signature = headers['hikie-signature'];
if (!timestamp || !signature) return false;
// 1) Zaman damgası penceresi
const age = Math.abs(Math.floor(Date.now() / 1000) - Number(timestamp));
if (!Number.isFinite(age) || age > TOLERANCE_SECONDS) return false;
// 2) İmza
const body = Buffer.isBuffer(rawBody) ? rawBody.toString('utf8') : rawBody;
const expected = crypto
.createHmac('sha256', secret)
.update(`${timestamp}.${body}`, 'utf8')
.digest('hex');
const a = Buffer.from(expected, 'utf8');
const b = Buffer.from(signature, 'utf8');
// Uzunluk farkı timingSafeEqual'ı patlatır; önce kontrol ediyoruz.
if (a.length !== b.length) return false;
return crypto.timingSafeEqual(a, b);
}Kendi kendinize test etmek
İmza mantığınızı hikie'yi beklemeden doğrulayabilirsiniz: bilinen bir secret, zaman damgası ve gövde ile imzayı kendiniz üretip endpoint'inize gönderin.
SECRET="whsec_test123"
TS=$(date +%s)
BODY='{"subscriptionId":"66b2c1a70f5e8d4319ab72c6","message":"Hikie webhook bağlantınız çalışıyor.","dateSent":"2026-08-07T09:20:00.000Z"}'
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -i -X POST http://localhost:3000/hikie/webhook \
-H "Content-Type: application/json" \
-H "Hikie-Event: test.ping" \
-H "Hikie-Webhook-Id: wh_test" \
-H "Hikie-Account-Id: acc_1" \
-H "Hikie-Timestamp: $TS" \
-H "Hikie-Occurred-At: 2026-08-07T09:20:00.000Z" \
-H "Hikie-Api-Version: 2026-09-04" \
-H "Hikie-Signature: $SIG" \
-H "Hikie-Delivery-Attempt: 1" \
--data-raw "$BODY"--data-raw kullanmak önemli: -d bazı durumlarda gövdeyi değiştirir ve imza
tutmaz.