hikiehikieDeveloper Documentation
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ız whsec_… değeri
  • timestamp — Hikie-Timestamp baş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

verify.js
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.

test-imza.sh
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.

Sık yapılan hatalar

Bu sayfada