مولّد HMAC

كيفية حساب HMAC

1. الصق الرسالة. في حالة webhook، يجب أن تكون جسم الطلب الخام نفسه، بايتًا ببايت.
2. أدخل المفتاح السري واختر صيغة المفتاح: نص (UTF-8) أو ست عشري أو Base64.
3. اختر الخوارزمية: HMAC-SHA1 أو HMAC-SHA256 أو HMAC-SHA384 أو HMAC-SHA512.
4. تتحدّث النتيجة أثناء الكتابة، ويمكنك أيضًا النقر على إنشاء HMAC. ستحصل على HMAC (ست عشري) وHMAC (Base64) وترويسة توقيع webhook (بأسلوب GitHub)، ولكل منها زر نسخ.
5. للتحقق من توقيع وصلك، الصقه في حقل قارن مع توقيع متوقَّع (ست عشري أو Base64 أو sha256=…)، وستخبرك الأداة هل هو مطابق أم لا.

تُرمَّز الرسالة بـ UTF-8 كما كتبتها تمامًا، بما في ذلك المسافات وفواصل الأسطر. ويجري الحساب عبر واجهة Web Crypto في متصفحك، فلا تغادر الرسالة ولا المفتاح جهازك أبدًا.

ما هو HMAC؟

HMAC (رمز مصادقة الرسائل المبني على دالة تجزئة، المعيار RFC 2104) يجمع بين مفتاح سري ودالة تجزئة:

HMAC(K, m) = H((K′ ⊕ opad) ‖ H((K′ ⊕ ipad) ‖ m))

حيث K′ هو المفتاح بعد حشوه إلى حجم كتلة دالة التجزئة (ويُجزَّأ أولًا إذا كان أطول منها)، وipad وopad ثابتان محددان. لا يستطيع إنتاج الرمز الصحيح لرسالة ما إلا من يعرف المفتاح، وأي تغيير في الرسالة يغيّر الرمز كليًا. لهذا تُستخدم رموز HMAC لتوقيع طلبات webhook وطلبات واجهات API (مثل AWS Signature Version 4) ورموز JSON Web Token من نوع HS256.

HMAC ليس تشفيرًا: فالرسالة لا تُخفى. وهو كذلك ليس تجزئة لكلمات المرور؛ لتخزين كلمات المرور استخدم دالة بطيئة مثل bcrypt أو Argon2.

يعتمد طول الناتج على الخوارزمية: 20 بايت لـ SHA-1، و32 لـ SHA-256، و48 لـ SHA-384، و64 لـ SHA-512. ما زال HMAC-SHA1 يُعدّ آمنًا بوصفه رمز مصادقة، لكن فضّل SHA-256 في الأنظمة الجديدة. يُنصح بمفتاح عشوائي لا يقل طوله عن طول الناتج (32 بايت لـ HMAC-SHA256)، وتتيح لك صيغتا المفتاح الست عشرية وBase64 إدخال هذه البايتات العشوائية مباشرةً.

التحقق من webhook في GitHub

يوقّع GitHub كل عملية إرسال بسرّ webhook الخاص بك، ويرسل النتيجة في الترويسة X-Hub-Signature-256 على شكل sha256= متبوعًا بقيمة HMAC-SHA256 الست عشرية لجسم الطلب. يستخدم المثال في توثيق GitHub نفسه السر It's a Secret to Everybody والجسم Hello, World!؛ أدخلهما هنا مع HMAC-SHA256 فتظهر الترويسة:

X-Hub-Signature-256: sha256=757107ea0eb2509fc211221cce984b8a37570b6d7586c22c46f4379c8b043e17

يقبل حقل المقارنة سطر الترويسة كاملًا، أو القيمة sha256=…، أو توقيعًا ست عشريًا أو Base64 مجردًا (تستخدم Stripe وShopify وSlack أنظمة مشابهة بترويساتها وسلاسلها الموقّعة الخاصة). أما مع SHA-384 وSHA-512 فتعرض الأداة ترويسة عامة X-Signature، إذ لا يوجد معيار شائع لهما.

المقارنة في زمن ثابت

الخادم الذي يقارن التواقيع بمقارنة نصية عادية يتوقف عند أول حرف مختلف. وبقياس أزمنة الاستجابة، قد يتمكن المهاجم من تخمين توقيع صالح حرفًا بعد حرف. أما المقارنة في هذه الأداة فتفحص كل بايت أيًّا كانت النتيجة، كما ينبغي أن يفعل الخادم باستخدام crypto.timingSafeEqual في Node.js أو hmac.compare_digest في Python أو hash_equals في PHP.