مولد ومتحقق توقيع HMAC

احسب وتحقق من توقيعات RFC 2104 HMAC-SHA256 وSHA-384 وSHA-512 وSHA-1 وMD5 بصيغ Hex أو Base64 أو Base64URL محلياً في متصفحك عبر Web Crypto.

بدون رفع ملفاتبدون تسجيلنتائج فورية
HMAC-SHA256 · SHA512 · MD5Hex · Base64 · Base64URLمعالجة محلية 100% • بدون رفع
حساب HMAC
المحرك المحلي جاهز دون اتصالمساحة عمل خاصة 100% داخل المتصفح • بدون رفع للسحابة
خصوصية 100% • بدون رفع ملفات للخادم

لماذا تستخدم أداة مولد ومتحقق توقيع HMAC المجانية من Utiliome؟

تم بناؤها لضمان الخصوصية التامة والتنفيذ الفوري دون تعقيد. لا اشتراكات ولا قيود أو تسجيل حساب.

بنية متوافقة مع RFC 2104 و FIPS 198-1

تطبّق حشو مفاتيح XOR الداخلي (0x36) والخارجي (0x5c) القياسي بحجم الكتلة عبر خوارزميات HMAC-SHA256 وHMAC-SHA384 وHMAC-SHA512 وHMAC-SHA1 وHMAC-MD5، مع التحقق منها مقابل متجهات اختبار IETF RFC 2202 وRFC 4231.

فك ترميز المفتاح السري بصيغ UTF-8 وHex وBase64

تحلل أسرار التوقيع كنص UTF-8 أو بايتات ست عشرية خام أو مخازن بايت Base64 وفق RFC 4648، بحيث يتم فك ترميز مفاتيح API الثنائية إلى بايتات المفتاح الدقيقة قبل اشتقاق HMAC.

وضع التحقق من التوقيع في زمن ثابت

يتحقق من ترويسات MAC الواردة من Webhook أو واجهات API مقابل التوقيعات المحسوبة باستخدام crypto.subtle.verify في Web Crypto ومقارنة XOR الثنائية ثابتة الطول دون تسريب توقيت البادئة.

مخرجات Webhook بصيغ Hex وBase64 وBase64URL

ينتج خلاصات بصيغة Hex بأحرف صغيرة أو كبيرة (لـ GitHub وStripe وSlack)، وBase64 القياسي ذي الحشو (لـ Shopify وAWS)، وBase64URL بدون حشو (لمقاطع JWS/JWT) بالكامل دون اتصال في ذاكرة المتصفح المحلية.

Utiliome مقابل البدائل السحابية التقليدية

قارن محركنا المحلي القائم على WebAssembly مقابل الأدوات السحابية القديمة.

الميزة Utiliome (متصفح محلي) محولات السحابة القديمة
بنية متوافقة مع RFC 2104 و FIPS 198-1 تطبّق حشو مفاتيح XOR الداخلي (0x36) والخارجي (0x5c) القياسي بحجم الكتلة عبر خوارزميات HMAC-SHA256 وHMAC-SHA384 وHMAC-SHA512 وHMAC-SHA1 وHMAC-MD5، مع التحقق منها مقابل متجهات اختبار IETF RFC 2202 وRFC 4231. خيارات محدودة بدون تخصيص متقدم
فك ترميز المفتاح السري بصيغ UTF-8 وHex وBase64 تحلل أسرار التوقيع كنص UTF-8 أو بايتات ست عشرية خام أو مخازن بايت Base64 وفق RFC 4648، بحيث يتم فك ترميز مفاتيح API الثنائية إلى بايتات المفتاح الدقيقة قبل اشتقاق HMAC. يتطلب أدوات خارجية أو معالجة يدوية
الخصوصية ومعالجة البيانات معالجة محلية 100% داخل المتصفح (بدون رفع للخادم) يرفع البيانات إلى خوادم سحابية خارجية
التكلفة ومتطلبات الحساب مجاني 100% للأبد بدون تسجيل أو علامات مائية يتطلب تسجيل حساب أو اشتراكاً مدفوعاً
كيف يعمل

كيفية استخدام مولد ومتحقق توقيع HMAC في 3 خطوات بسيطة

لا داعي لتثبيت أي برامج. يعمل كل شيء مباشرة داخل متصفح الإنترنت الخاص بك.

1

توفير حمولة الرسالة الدقيقة

الصق نص طلب HTTP الخام غير المنسق أو سلسلة التوقيع القانونية (Canonical String) — مع الحفاظ على المسافات البيضاء وترتيب المفاتيح بدقة — أو أسقط ملف حمولة ملتقط.

2

ضبط ترميز المفتاح السري وخوارزمية التجزئة

أدخل المفتاح السري المشترك، واختر تمثيل البايت الخاص به (نص عادي UTF-8 أو Hex أو Base64)، وحدد HMAC-SHA256 أو HMAC-SHA384 أو HMAC-SHA512 أو HMAC-SHA1 أو HMAC-MD5.

3

نسخ رمز MAC أو التحقق من التوقيع الوارد

انسخ خلاصة Hex أو Base64 أو Base64URL الناتجة، أو الصق توقيعاً متوقعاً (مع إزالة بادئات النقل مثل sha256= أو v0=) لإجراء تحقق بزمن ثابت.

حساب والتحقق من توقيعات HMAC للـ Webhook وواجهات API: دليل عملي

إجابة سريعة: إن توقيع الرسالة what do ya want for nothing? بالمفتاح السري ذي الـ 4 بايتات Jefe (حالة الاختبار 2 في IETF RFC 4231) باستخدام HMAC-SHA256 ينتج 5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843 بصيغة Hex وW9zBRr9gdU5qBCQmCJV1x1oAPwidJzmDnexYuWTsOEM= بصيغة Base64 عبر أوضاع المفاتيح UTF-8 وHex (4a656665) وBase64 (SmVmZQ==).

يثبت رمز مصادقة الرسائل القائم على التجزئة ذات المفتاح (HMAC) كلاً من سلامة البيانات (عدم تعديل الحمولة أثناء النقل) و الأصالة (امتلاك المرسل للمفتاح السري المشترك). تتطلب إعادة إنتاج توقيع مزود الخدمة مطابقة ثلاثة معايير دقيقة: دالة التجزئة الأساسية، وفك ترميز البايتات الخام للمفتاح السري، والتسلسل الدقيق لبايتات الحمولة الموقعة.

مثال 1: حالة الاختبار 2 من معايير IETF RFC 2104 / RFC 2202 / RFC 4231

سواء أدخلت المفتاح السري المكون من 4 بايتات كنص UTF-8 Jefe، أو بصيغة ست عشرية خام 4a656665، أو بصيغة Base64 SmVmZQ==، فإنه يُفكك إلى نفس مخزن البايتات المؤقت [0x4a, 0x65, 0x66, 0x65]. إن توقيع رسالة UTF-8 المكونة من 28 بايت 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 والحمولات القانونية للـ Webhook

يُخرج ترميز Base64 القياسي (RFC 4648 القسم 4) الرمزين + و/ وحشو = في النهاية، بينما يستبدل ترميز Base64URL الآمن لعناوين URL (RFC 4648 القسم 5، المستخدم في توقيعات JWS/JWT وعناوين URL الموقعة) الرمز - مكان +، والرمز _ مكان /، ويزيل حشو =. يوضح توقيع الجملة The quick brown fox jumps over the lazy dog بمفتاح UTF-8 key تحت خوارزمية HMAC-SHA256 فرق الترميز بشكل مباشر:

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

عند التحقق من ترويسات Webhook الفعلية، قم ببناء الحمولة الدقيقة لما قبل التوقيع كما يحددها كل مزود خدمة قبل إزالة بادئات الترويسة:

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>

بنية RFC 2104 وقواعد تطبيع المفاتيح ومقاومة هجمات التوقيت

إجابة سريعة: يعرّف المعيار RFC 2104 دالة HMAC بالصيغة H((K_0 XOR opad) || H((K_0 XOR ipad) || m))، حيث يتم تطبيع المفاتيح السرية وفق حجم كتلة الضغط الداخلي لدالة التجزئة B (64 بايت لخوارزميات MD5/SHA-1/SHA-256؛ و128 بايت لـ SHA-384/SHA-512) بدلاً من طول مخرجات الخلاصة L.

كما هو محدد في IETF RFC 2104 و NIST FIPS 198-1، تغلّف آلية HMAC أي دالة تجزئة تشفيرية تكرارية H داخل غلاف متداخل من مرحلتين يمنع هجمات تمديد الطول (Length-Extension Attacks) الخاصة ببنية Merkle-Damgard:

HMAC(K, m) = H( (K_0 XOR opad) || H( (K_0 XOR ipad) || m ) )

حجم الكتلة (`B`) مقابل طول المخرجات (`L`) وتطبيع المفتاح

من الأخطاء الشائعة في برمجة HMAC المخصصة تطبيع المفتاح السري K بناءً على طول بايتات مخرجات الخلاصة L بدلاً من طول بايتات كتلة الضغط B:

  • MD5 (L = 16)، SHA-1 (L = 20)، SHA-256 (L = 32): حجم الكتلة الداخلي B = 64 بايت (512 بت).
  • SHA-384 (L = 48)، SHA-512 (L = 64): حجم الكتلة الداخلي B = 128 بايت (1024 بت).

قبل تطبيق عملية XOR مع ipad (تكرار 0x36 بعدد B من المرات) وopad (تكرار 0x5c بعدد B من المرات)، يتم تطبيع بايتات المفتاح الخام K إلى كتلة K_0 بحجم B بايت بالضبط:

  1. المفاتيح القصيرة (len(K) < B): إلحاق B - len(K) من البايتات الصفرية (0x00) إلى يمين المفتاح K.
  2. المفاتيح المطابقة لحجم الكتلة (len(K) == B): استخدام المفتاح K دون تعديل (K_0 = K).
  3. المفاتيح الأكبر من حجم الكتلة (len(K) > B): تجزئة المفتاح K مرة واحدة باستخدام H(K) لإنتاج خلاصة بطول L بايت، ثم إلحاق B - L من البايتات الصفرية (0x00) للوصول إلى B بايت.

وفقاً للمعيار RFC 2104 القسم 3، يجب أن تحتوي المفاتيح السرية على الأقل على L بايت من العشوائية التشفيرية (>= 32 بايت CSPRNG لخوارزمية HMAC-SHA256، و>= 64 بايت CSPRNG لخوارزمية HMAC-SHA512). المفاتيح الأقصر من L تقلل الأمان الفعلي ضد القوة الغاشمة إلى ما دون حد التصادم للدالة.

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

  • سلسلة Hex النصية مقابل بايتات Hex الخام: إذا أصدرت واجهة API مفتاحاً سرياً سداسي عشري مكوناً من 64 حرفاً مثل 4a656665...، فتحقق مما إذا كانت حزمة SDK الخاصة بهم تتعامل مع تلك السلسلة كـ 64 بايت بترميز ASCII UTF-8 (0x34 0x61...) أو تفك ترميزها من Hex إلى 32 بايت خام (0x4a 0x65...) قبل استدعاء importKey. يتيح التبديل في محدد ترميز المفتاح بين UTF-8 و Hex و Base64 عزل حالات عدم تطابق فك ترميز المفتاح فوراً أثناء تصحيح أخطاء التكامل.
  • التحقق في زمن ثابت (Constant-Time Verification): لا تتحقق أبداً من رمز MAC غير موثوق به في كود الخادم باستخدام مساواة السلاسل النصية القياسية (computedHex === headerHex). تُرجع مقارنة السلاسل القياسية القيمة false عند أول بايت غير متطابق، مما ينشئ ثغرة توقيت على مستوى النانو ثانية تتيح للمهاجمين عن بُعد تخمين رموز MAC الصالحة بايتاً تلو الآخر (256 * L محاولة بدلاً من 2^(8*L)). يستخدم التحقق في المتصفح الدالة crypto.subtle.verify('HMAC', cryptoKey, signatureBuffer, messageBuffer) (أو تراكم XOR الثنائي ثابت الطول عبر مصفوفات البايت المفككة)، مما يحاكي crypto.timingSafeEqual في Node.js وhmac.compare_digest في Python.

مولد توقيع HMAC مقابل مولد التجزئة التشفيرية مقابل مولد رموز JWT: أي أداة تحتاج؟

إجابة سريعة: استخدم مولد توقيع HMAC لتوقيع أو التحقق من الحمولات الخام (نصوص طلبات HTTP، السلاسل القانونية، أحداث Webhook) باستخدام مفتاح سري مشترك. استخدم مولد التجزئة التشفيرية لخلاصات النصوص أو الملفات بدون مفتاح، واستخدم مولد رموز JWT لبناء رموز JSON Web Tokens المهيكلة وفق RFC 7519 والموقعة بخوارزميات HS256 أو HS384 أو HS512.

بينما تشترك الخلاصات غير المعتمدة على مفاتيح ورموز HMAC الخام ورموز JSON Web Tokens المتماثلة في دوال SHA-2 الأساسية، فإن كلاً منها يعالج طبقة مختلفة من أمان البروتوكولات:

الميزة مولد ومتحقق توقيع HMAC (هذه الأداة) مولد التجزئة التشفيرية مولد رموز JWT
الأساس التشفيري رمز MAC بمفتاح (RFC 2104 / FIPS 198-1) خلاصة بدون مفتاح (FIPS 180-4 / RFC 1321) غلاف رمز JWS / JWT (RFC 7515 / RFC 7519)
يتطلب مفتاحاً سرياً نعم (سر مشترك بصيغة UTF-8 أو Hex أو Base64) لا نعم (سر متماثل أو زوج مفاتيح RSA/ECDSA)
الضمان الأمني الأصالة + سلامة البيانات سلامة البيانات العامة / غير المقصودة فقط مطالبات مهيكلة وموثقة (iss، sub، exp)
الخوارزميات المدعومة HMAC-SHA256، SHA384، SHA512، SHA1، MD5 MD5، SHA-1، SHA-256، SHA-384، SHA-512 HS256، HS384، HS512 (إضافة لحزم JWS غير المتماثلة)
تنسيق المخرجات Hex، Base64، Base64URL Hex بأحرف صغيرة/كبيرة، Base64 <header>.<payload>.<signature> (Base64URL)

اختيار الأداة المناسبة

  • هل تقوم بتصحيح خلاصات الملفات بدون مفتاح، أو تجزئات W3C SRI، أو مفاتيح ETag / التخزين المؤقت؟ لا يوجد مفتاح سري هنا — استخدم مولد التجزئة التشفيرية.
  • هل تقوم ببناء أو فحص رموز مصادقة Bearer (HS256، HS384، HS512)؟ بموجب المعيار RFC 7515، فإن توقيع JWT من نوع HS256 هو تحديداً مخرج Base64URL غير المحشو للعملية HMAC-SHA256(secret, ASCII(BASE64URL(header) + "." + BASE64URL(payload))). وبينما يمكنك التحقق من المقطع الثالث الخام مباشرة هنا عن طريق لصق <base64url_header>.<base64url_payload> كرسالة واختيار مخرجات Base64URL، استخدم مولد رموز JWT لتحرير ترويسات JSON، والتحقق من الطوابع الزمنية exp/nbf، وتجميع الرموز الكاملة المكونة من ثلاثة أجزاء.
  • توقيع HMAC المتماثل مقابل التوقيعات غير المتماثلة: نظراً لأن HMAC متماثل، فإن كل خدمة تتحقق من التوقيع تمتلك نفس السر المطلوب لتزوير توقيعات جديدة. استخدم HMAC لاتصالات Webhook المباشرة من نقطة إلى نقطة والخدمات الداخلية الموثوقة؛ وعندما يتعين على أطراف خارجية غير موثوقة التحقق من الرموز دون صلاحيات التوقيع، استخدم المفاتيح غير المتماثلة (RS256، ES256، EdDSA) في مولد رموز JWT.
الأسئلة الشائعة

الأسئلة الشائعة والدليل الفني حول مولد ومتحقق توقيع HMAC

كل ما تحتاج معرفته حول استخدام مولد توقيع hmac المجاني عبر الإنترنت من Utiliome.

لماذا يفشل التحقق من HMAC للـ Webhook رغم أن المفتاح السري وحقول JSON تبدو متطابقة تماماً؟

يتسبب أمران في أكثر من 90% من حالات عدم تطابق HMAC للـ Webhook. أولاً، تقوم البرمجيات الوسيطة (Middleware) مثل express.json() في Express بتحليل وإعادة تسلسل JSON، مما يغير المسافات البيضاء أو تهريب Unicode أو ترتيب المفاتيح مقارنةً بتدفق بايتات TCP الخام الذي وقّعه المرسل — وقّع دائماً مخزن الطلب الخام غير المحلل، وقم بتضمين بادئات الطابع الزمني للمزود (مثل <timestamp>.<body> في Stripe أو v0:<timestamp>:<body> في Slack). ثانياً، تحقق مما إذا كان يجب فك ترميز سر المزود من Base64 أو Hex إلى بايتات خام بدلاً من قراءته كسلسلة UTF-8.

لماذا تعتبر الصيغة SHA256(secret + message) غير آمنة مقارنةً بـ RFC 2104 HMAC-SHA256؟

تستخدم خوارزميات MD5 وSHA-1 وSHA-256 وSHA-512 بنية Merkle-Damgard، التي تكشف خلاصتها النهائية عن حالة الضغط الداخلية الكاملة. بمعرفة SHA256(secret || message) وطول بايتات secret، يمكن للمهاجم حساب SHA256(secret || message || padding || attacker_suffix) دون معرفة secret إطلاقاً (هجوم تمديد الطول). يقضي معيار RFC 2104 HMAC على هذه الثغرة عن طريق تمرير الخلاصة الداخلية إلى تجزئة خارجية ثانية ذات مفتاح H((K_0 XOR opad) || inner_hash).

ماذا يحدث إذا كان مفتاح HMAC السري أطول من 64 أو 128 بايت؟

وفقاً للمعيار RFC 2104 القسم 2، إذا تجاوز المفتاح السري حجم الكتلة الداخلي لدالة التجزئة B (len(K) > 64 بايت لخوارزميات MD5 وSHA-1 وSHA-256؛ وlen(K) > 128 بايت لـ SHA-384 وSHA-512)، يتم ضغط المفتاح أولاً عن طريق تجزئته مرة واحدة باستخدام H(K) إلى L بايت ثم يُحشى من اليمين ببايتات 0x00 حتى يصل إلى B بايت. تقوم كل من واجهة Web Crypto (crypto.subtle.importKey) ومكتبات الخوادم المتوافقة مع RFC بإجراء خطوة التجزئة المسبقة هذه تلقائياً.

ما هو ترميز المخرجات الذي يجب اختياره لـ GitHub وStripe وSlack وShopify وJWT HS256؟

يرسل كل من GitHub (X-Hub-Signature-256) وStripe (Stripe-Signature v1) وSlack (X-Slack-Signature v0) خلاصات HMAC-SHA256 بصيغة Hex بأحرف صغيرة بعد البادئات الخاصة بها sha256= أو v1= أو v0=. أما Shopify (X-Shopify-Hmac-Sha256) وAWS Signature v1/v2 فتستخدم ترميز Base64 القياسي مع الحشو. وتتطلب رموز JSON Web Tokens (HS256، HS384، HS512) ترميز Base64URL بدون حشو وفقاً للمعيار RFC 7515 — راجع مولد رموز JWT لتجميع الرمز بالكامل.

هل خوارزميتا HMAC-MD5 وHMAC-SHA1 مخترقتان بسبب هجمات التصادم على MD5 وSHA-1؟

ليس بشكل مباشر. تعتمد هجمات التصادم ضد MD5 وSHA-1 غير المزودة بمفتاح على اختيار المهاجم لكتل الرسائل بحرية مقابل متجه تهيئة (IV) عام وثابت، بينما يخفي HMAC متجه التهيئة الداخلي خلف خطوتي السر K_0 XOR ipad وK_0 XOR opad (كما هو موثق في IETF RFC 6151). ومع ذلك، فإن معيار NIST SP 800-131A وكبار مزودي خدمات Webhook (مثل إيقاف GitHub لترويسة X-Hub-Signature المعتمدة على SHA-1) يوصون بإيقاف استخدام HMAC-MD5 وHMAC-SHA1 القديم للأنظمة الجديدة — اختر دائماً HMAC-SHA256 أو HMAC-SHA512 ما لم تكن تحافظ على التوافق مع بروتوكولات قديمة.