Anahtarlı Hash Mesaj Kimlik Doğrulama Kodu (HMAC), hem veri bütünlüğünü (yükün aktarım sırasında değiştirilmediğini) hem de kimlik doğruluğunu (göndericinin paylaşılan gizli anahtara sahip olduğunu) kanıtlar. Bir sağlayıcının imzasını birebir yeniden üretmek, üç temel parametrenin tam eşleşmesini gerektirir: temel alınan hash algoritması, gizli anahtarın ham bayt çözümlemesi ve imzalanan yükün tam bayt dizisi.
Örnek 1: IETF RFC 2104 / RFC 2202 / RFC 4231 Test Senaryosu 2
4 baytlık gizli anahtarı ister UTF-8 metin olarak Jefe, ister ham onaltılık olarak 4a656665, ister Base64 olarak SmVmZQ== şeklinde girin; tamamı aynı [0x4a, 0x65, 0x66, 0x65] anahtar tamponuna çözümlenir. 28 baytlık what do ya want for nothing? UTF-8 mesajını imzalamak şu sonuçları verir:
{
"keyUtf8": "Jefe",
"keyHex": "4a656665",
"keyBase64": "SmVmZQ==",
"message": "what do ya want for nothing?",
"signatures": {
"hmac_md5_hex": "750c783e6ab0b503eaa86e310a5db738",
"hmac_sha1_hex": "effcdf6ae5eb2fa2d27416d5f184df9c259a7c79",
"hmac_sha256_hex": "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843",
"hmac_sha256_base64": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM=",
"hmac_sha256_base64url": "W9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM",
"hmac_sha384_hex": "af45d2e376484031617f78d2b58a6b1b9c7ef464f5a01b47e42ec3736322445e8e2240ca5e69e2c78b3239ecfab21649",
"hmac_sha512_hex": "164b7a7bfcf819e2e395fbe73b56e0a387bd64222e831fd610270cd7ea2505549758bf75c05a994a6d034f65f8f0e6fdcaeab1a34d4a6b4b636e070a38bce737"
}
}
Örnek 2: Base64 ve Base64URL Farkı ile Webhook Kanonik Yükleri
Standart Base64 (RFC 4648 Bölüm 4) +, / karakterlerini ve sondaki = dolgusunu üretirken; URL güvenli Base64URL (RFC 4648 Bölüm 5, JWS/JWT imzalarında ve imzalı URL'lerde kullanılır) + yerine -, / yerine _ koyar ve = dolgusunu kaldırır. The quick brown fox jumps over the lazy dog mesajını HMAC-SHA256 altında key UTF-8 anahtarıyla imzalamak, kodlama farkını doğrudan gösterir:
Key (UTF-8): key
Message (UTF-8): The quick brown fox jumps over the lazy dog
HMAC-SHA256 Hex: f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
HMAC-SHA256 Base64: 97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg=
HMAC-SHA256 Base64URL: 97yD9DBThCSxMpjmqm-xQ-9NWaFJRhdZl0edvC0aPNg
Gerçek dünya webhook başlıklarını doğrularken, başlık öneklerini ayıklamadan önce her sağlayıcının tanımladığı tam imzalama öncesi yükü oluşturun:
GitHub (X-Hub-Signature-256: sha256=<hex>):
Signed input = <raw_http_body>
Stripe (Stripe-Signature: t=1730419200,v1=<hex>):
Signed input = 1730419200.<raw_http_body>
Slack (X-Slack-Signature: v0=<hex>):
Signed input = v0:1730419200:<raw_http_body>
Shopify (X-Shopify-Hmac-Sha256: <base64>):
Signed input = <raw_http_body>