‫تضمین اصالت و یکپارچگی داده‌ها با HMAC در اکوسیستم مدرن NET.

چکیده: در معماری‌های توزیع‌شده و ارتباطات تحت وب، اعتبارسنجی منبع پیام و تضمین دست‌نخورده ماندن محتوا دو چالش امنیتی بنیادین هستند. برخلاف تصور رایج، توابع هش رمزنگاری متعارف مانند SHA-256 به‌تنهایی قادر به اثبات اصالت فرستنده نیستند؛ زیرا الگوریتم‌هایی عمومی و فاقد کلید به شمار می‌روند. HMAC (کد اصالت‌سنجی پیام مبتنی بر هش) با ترکیب ریاضی محتوای پیام با یک کلید متقارن مشترک، هم‌زمان یکپارچگی (Integrity) و اصالت (Authenticity) داده‌ها را تضمین می‌کند. این مقاله به بررسی ساختار HMAC، خطرات حملات زمان‌بندی (Timing Attacks)، نحوه پیاده‌سازی بهینه و مدرن آن در پلتفرم .NET و رویکردهای تکمیلی جهت مقابله با حملات بازپخش (Replay Attacks) می‌پردازد.

order_id=123&status=paid

• پیام در طول مسیر توسط مهاجم یا پروکسی‌های واسط شنود و تحریف نشده است؟
• پیام واقعاً از سوی درگاه پرداخت صادر شده، نه یک عامل نفوذی؟

• H: تابع هش پایه‌ای (مانند SHA-256).
• K: کلید متقارن مشترک (تکمیل‌شده تا طول بلوک هش).
• m: پیام ورودی.
• ipad و opad: ثابت‌های از پیش‌تعریف‌شده برای پدینگ داخلی و خارجی.

• فرستنده: پیام خام را همراه با کلید محرمانه به الگوریتم HMAC می‌دهد و یک امضای دیجیتال تولید می‌کند.
• ارسال: پیام اصلی به‌صورت خام (یا در بدنه درخواست) به همراه امضا (غالباً در سربرگ HTTP) ارسال می‌شود.
• گیرنده: پیام دریافت‌شده را با همان کلید محرمانه‌ای که نزد خود دارد هش می‌کند.
• تطبیق: در صورت برابری امضای محاسبه‌شده با امضای دریافتی، اعتبار پیام تأیید می‌شود.

using System.Security.Cryptography;
using System.Text;

public static class HmacService
{
    /// <summary>
    /// تولید امضای هگزادسیمال با استفاده از HMAC-SHA256
    /// </summary>
    public static string GenerateSignature(string message, string secretKey)
    {
        ArgumentException.ThrowIfNullOrEmpty(message);
        ArgumentException.ThrowIfNullOrEmpty(secretKey);

        byte[] keyBytes = Encoding.UTF8.GetBytes(secretKey);
        byte[] messageBytes = Encoding.UTF8.GetBytes(message);

        // استفاده از API یک‌مرحله‌ای و سبک دات‌نت مدرن
        byte[] hashBytes = HMACSHA256.HashData(keyBytes, messageBytes);

        return Convert.ToHexString(hashBytes).ToLowerInvariant();
    }
}

using System.Security.Cryptography;
using System.Text;

public static class HmacValidator
{
    /// <summary>
    /// اعتبارسنجی امن امضا در برابر حملات کانال جانبی مبتنی بر زمان
    /// </summary>
    public static bool ValidateSignature(string receivedMessage, string receivedSignatureHex, string secretKey)
    {
        if (string.IsNullOrWhiteSpace(receivedMessage) || 
            string.IsNullOrWhiteSpace(receivedSignatureHex) || 
            string.IsNullOrWhiteSpace(secretKey))
        {
            return false;
        }

        byte[] keyBytes = Encoding.UTF8.GetBytes(secretKey);
        byte[] messageBytes = Encoding.UTF8.GetBytes(receivedMessage);
        
        // محاسبه مجدد امضا با استفاده از کلید معتبر سرور
        byte[] computedHashBytes = HMACSHA256.HashData(keyBytes, messageBytes);

        // تبدیل هگز امضای دریافتی به بایت جهت مقایسه در زمان ثابت
        byte[] receivedHashBytes;
        try
        {
            receivedHashBytes = Convert.FromHexString(receivedSignatureHex);
        }
        catch (FormatException)
        {
            return false;
        }

        // مقایسه در زمان ثابت (Constant-Time Comparison)
        return CryptographicOperations.FixedTimeEquals(computedHashBytes, receivedHashBytes);
    }
}

• راهکار ۱ (برچسب زمانی - Timestamp): فرستنده باید زمان جاری ارسال را به محتوای امضا اضافه کند. سرور درخواست‌هایی را که اختلاف زمانی بیش از حد مجاز (مثلاً ۵ دقیقه) دارند، رد می‌کند.
• راهکار ۲ (کد یک‌بارمصرف - Nonce): ارسال یک شناسه تصادفی و ثبت آن در ردیس (Redis) برای بازه زمانی مشخص، مانع پردازش مجدد درخواست یکسان می‌شود.

• کلید محرمانه هرگز نباید به‌صورت هاردکد (Hardcoded) داخل کد منبع یا ریپازیتوری‌های گیت نگهداری شود.
• در پروژه‌های دات‌نت از سرویس‌های مدیریت کلید نظیر Azure Key Vault، AWS Secrets Manager یا قابلیت User Secrets در محیط توسعه محلی استفاده کنید.