HMAC जनरेटर

HMAC कैसे काम करता है

HMAC (hash-based message authentication code, यानी हैश-आधारित संदेश प्रमाणीकरण कोड, RFC 2104) एक क्रिप्टोग्राफ़िक हैश को एक सीक्रेट कुंजी के साथ जोड़ता है। किसी संदेश के लिए सही मान केवल वही बना सकता है जो कुंजी जानता हो, इसलिए मेल खाता HMAC एक साथ दो बातें साबित करता है: संदेश बदला नहीं गया, और वह कुंजी रखने वाले किसी व्यक्ति से आया है।

इसकी बनावट H((K ⊕ opad) ‖ H((K ⊕ ipad) ‖ message)) है। अगर कुंजी हैश के ब्लॉक आकार (MD5, SHA-1 और SHA-256 के लिए 64 बाइट, SHA-384 और SHA-512 के लिए 128) से लंबी हो, तो पहले उसका हैश लिया जाता है; फिर उसे शून्यों से उस आकार तक भरा जाता है, और संदेश पर अंदरूनी हैश के लिए उसे ipad (0x36 बाइट) से, तथा अंदरूनी परिणाम पर बाहरी हैश के लिए opad (0x5c बाइट) से XOR किया जाता है। सीधे-सादे SHA-256(key ‖ message) में कोई बाहरी हैश नहीं होता, इसलिए एक टैग देख लेने वाला कोई भी व्यक्ति कुंजी के बिना संदेश में डेटा जोड़कर नया मान्य टैग बना सकता है (लेंथ-एक्सटेंशन हमला)।

आउटपुट की लंबाई मूल हैश जितनी होती है: HMAC-SHA256 के लिए 32 बाइट, यानी 64 हेक्स अक्षर। RFC 2104 कम से कम इतनी लंबी कुंजी की सलाह देता है, और रैंडम Base64 जनरेटर उपयुक्त कुंजियाँ बनाता है।

HMAC सिग्नेचर कहाँ उपयोग होते हैं

• GitHub वेबहुक। X-Hub-Signature-256 हेडर में sha256= के बाद रॉ अनुरोध बॉडी का हेक्स HMAC-SHA256 होता है, जिसकी कुंजी वेबहुक सीक्रेट होती है। आप पूरे हेडर मान को “इससे तुलना करें” में पेस्ट कर सकते हैं; sha256= प्रीफ़िक्स अनदेखा कर दिया जाता है।
• Stripe वेबहुक। Stripe-Signature हेडर में एक टाइमस्टैम्प t और एक सिग्नेचर v1 होता है: टाइमस्टैम्प, एक बिंदु और रॉ बॉडी का हेक्स HMAC-SHA256, जिसकी कुंजी टेक्स्ट के रूप में इस्तेमाल किया गया एंडपॉइंट सीक्रेट (whsec_...) होता है।
• Shopify वेबहुक। X-Shopify-Hmac-Sha256 में रॉ बॉडी का HMAC-SHA256 Base64 में होता है, जिसकी कुंजी ऐप का क्लाइंट सीक्रेट होता है, इसलिए Base64 आउटपुट चुनें या हेडर मान को “इससे तुलना करें” में पेस्ट करें।
• AWS Signature Version 4। साइनिंग कुंजी HMAC-SHA256 की एक शृंखला से निकाली जाती है: पहले तारीख, जिसकी कुंजी AWS4 और सीक्रेट एक्सेस कुंजी को जोड़कर बनती है, फिर रीजन, सेवा और aws4_request, जिनमें से हर एक की कुंजी पिछला परिणाम होता है। एक चरण के आउटपुट को अगले चरण में देने के लिए “कुंजी का फ़ॉर्मैट” “हेक्स” पर सेट करें।
• JSON Web Token। HS256, HS384 और HS512 का मतलब है एनकोड किए गए हेडर, एक बिंदु और एनकोड किए गए पेलोड पर HMAC-SHA256, -384 और -512। टोकन का तीसरा भाग वही HMAC है, URL-सुरक्षित Base64 में, जिसे “इससे तुलना करें” जैसे का तैसा स्वीकार करता है। JWT डिकोडर पूरे टोकन सत्यापित करता है।

HMAC की गणना हमेशा रॉ बॉडी पर ठीक उसी रूप में करें जिसमें वह मिली थी। JSON को पार्स करके दोबारा सीरियलाइज़ करने से स्पेसिंग या फ़ील्ड का क्रम बदल जाता है, और एक अतिरिक्त न्यूलाइन भी बिल्कुल अलग HMAC दे देती है।

कोड में HMAC

# Python
import hmac, hashlib
sig = hmac.new(b'key', b'message', hashlib.sha256).hexdigest()
hmac.compare_digest(sig, received)        # कॉन्स्टेंट-टाइम तुलना

// Node.js
const crypto = require('crypto');
const sig = crypto.createHmac('sha256', 'key').update('message').digest('hex');
// लंबाई अलग होने पर timingSafeEqual त्रुटि देता है, इसलिए पहले लंबाई जाँचें
crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(received));

// PHP: संदेश कुंजी से पहले आता है
$sig = hash_hmac('sha256', 'message', 'key');
hash_equals($sig, $received);

# OpenSSL: टेक्स्ट कुंजी, फिर वही कुंजी हेक्स के रूप में
printf '%s' 'message' | openssl dgst -sha256 -hmac 'key'
printf '%s' 'message' | openssl dgst -sha256 -mac HMAC -macopt hexkey:6b6579

# टेस्ट वेक्टर: कुंजी "key", संदेश "The quick brown fox jumps over the lazy dog"
# HMAC-SHA256 = f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

जब आप अपने कोड में सिग्नेचर सत्यापित करें, तो ऊपर दिए गए उदाहरणों की तरह कॉन्स्टेंट-टाइम तुलना का उपयोग करें। साधारण == पहले अलग अक्षर पर ही रुक जाता है, और समय का यह अंतर हमलावर को बाइट-दर-बाइट एक मान्य सिग्नेचर खोजने का मौक़ा दे सकता है। Stripe जैसी टाइमस्टैम्प वाली योजनाओं में उन अनुरोधों को भी अस्वीकार करें जिनका टाइमस्टैम्प कुछ मिनट से ज़्यादा पुराना हो; इससे रीप्ले हमले रुकते हैं।