एक Keyed-Hash Message Authentication Code (HMAC) डेटा अखंडता (data integrity) (ट्रांज़िट में पेलोड में कोई बदलाव नहीं किया गया था) और प्रामाणिकता (authenticity) (प्रेषक के पास साझा सीक्रेट की है) दोनों को साबित करता है। किसी प्रदाता के सिग्नेचर को पुनः उत्पन्न करने के लिए तीन सटीक मापदंडों का मिलान करना आवश्यक है: अंतर्निहित हैश प्रिमिटिव, सीक्रेट की (secret key) की रॉ बाइट डिकोडिंग, और साइन किए गए पेलोड का सटीक बाइट अनुक्रम।
उदाहरण 1: IETF RFC 2104 / RFC 2202 / RFC 4231 टेस्ट केस 2
चाहे आप 4-बाइट सीक्रेट की को UTF-8 टेक्स्ट Jefe, रॉ हेक्साडेसिमल 4a656665, या Base64 SmVmZQ== के रूप में दर्ज करें, यह समान की-बफ़र [0x4a, 0x65, 0x66, 0x65] में डिकोड होता है। 28-बाइट UTF-8 मैसेज what do ya want for nothing? को साइन करने पर यह परिणाम मिलता है:
{
"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"
}
}
उदाहरण 2: Base64 बनाम Base64URL और वेबहुक कैननिकल पेलोड
मानक Base64 (RFC 4648 सेक्शन 4) +, /, और अंत में = पैडिंग उत्सर्जित करता है, जबकि URL-सुरक्षित Base64URL (RFC 4648 सेक्शन 5, JWS/JWT सिग्नेचर और साइन किए गए URL में प्रयुक्त) + के लिए -, / के लिए _ को प्रतिस्थापित करता है, और = पैडिंग को हटा देता है। HMAC-SHA256 के तहत UTF-8 की key के साथ The quick brown fox jumps over the lazy dog को साइन करना सीधे एनकोडिंग अंतर को दर्शाता है:
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
वास्तविक दुनिया के वेबहुक हेडर्स को सत्यापित करते समय, हेडर प्रीफ़िक्स को हटाने से पहले प्रत्येक प्रदाता द्वारा परिभाषित सटीक प्री-साइनिंग पेलोड का निर्माण करें:
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>