# 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:

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

:::warning{title="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):

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

Tam doğrulama örneği:

```php
<?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

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