‫چک‌لیست امنیت آپلود فایل در ASP.NET Core

// Program.cs
var builder = WebApplication.CreateBuilder(args);

// ۱. تنظیم محدودیت‌های Kestrel در سطح سرور
builder.WebHost.ConfigureKestrel(options =>
{
    options.Limits.MaxRequestBodySize = 524_288_000; // ۵۰۰ مگابایت حداکثر حجم Body
    options.Limits.RequestHeadersTimeout = TimeSpan.FromMinutes(10);
});

// ۲. تنظیم FormOptions جهت جلوگیری از مصرف بی‌رویه RAM
builder.Services.Configure<FormOptions>(options =>
{
    options.ValueLengthLimit = 1024 * 1024;         // ۱ مگابایت حداکثر برای هر Value در فرم
    options.MultipartBodyLengthLimit = 524_288_000; // ۵۰۰ مگابایت حداکثر حجم فایل
    options.MultipartHeadersLengthLimit = 32_768;   // ۳۲ کیلوبایت حداکثر هدر
    options.MemoryBufferThreshold = 64 * 1024;      // فایل‌های بالای ۶۴ کیلوبایت مستقیماً روی دیسک Buffer شوند
});

// ۳. اعمال محدودیت تعداد درخواست (Rate Limiting) بر اساس شناسه کاربر/IP
builder.Services.AddRateLimiter(options =>
{
    options.AddPolicy("UploadPolicy", context =>
    {
        var userId = context.User.FindFirstValue(ClaimTypes.NameIdentifier) ?? context.Connection.RemoteIpAddress?.ToString() ?? "anonymous";
        return RateLimitPartition.GetFixedWindowLimiter(userId, _ => new FixedWindowRateLimiterOptions
        {
            PermitLimit = 10,                 // مجاز: ۱۰ آپلود
            Window = TimeSpan.FromMinutes(1), // در هر دقیقه
            QueueProcessingOrder = QueueProcessingOrder.OldestFirst,
            QueueLimit = 2                    // حداکثر ۲ درخواست در صف
        });
    });
});

• نکته کلیدی MemoryBufferThreshold: تنظیم این مقدار روی 64KB باعث می‌شود فایل‌های بزرگ به‌جای بارگذاری کامل در RAM، روی دیسک موقت بافر شوند و از Crash کردن AppPool جلوگیری شود.

public class UploadedFile
{
    public Guid Id { get; set; }
    public string OriginalFileName { get; set; } = string.Empty;
    public string StoredFileName { get; set; } = string.Empty; // UUID
    public string ContentType { get; set; } = string.Empty;
    public string Extension { get; set; } = string.Empty;
    public long FileSize { get; set; }
    public string StoragePath { get; set; } = string.Empty; 
    public string StorageProvider { get; set; } = string.Empty; // e.g., "AzureBlob", "S3", "MinIO"
    
    public FileStatus Status { get; set; } = FileStatus.Pending;
    public string? ScanResult { get; set; }
    public DateTime? ScannedAt { get; set; }
    public string Checksum { get; set; } = string.Empty; // SHA-256 جهت بررسی یکپارچگی
    
    public string UploadedBy { get; set; } = string.Empty;
    public DateTime UploadedAt { get; set; } = DateTime.UtcNow;
    public DateTime? ExpiresAt { get; set; } // نگهداری بر اساس سیاست retention
}

public enum FileStatus
{
    Pending,     // آپلود شده، در انتظار اسکن
    Scanning,    // در حال اسکن توسط آنتی‌ویروس
    Clean,       // اسکن موفق، آماده پردازش
    Infected,    // بدافزار شناسایی شد (قرنطینه)
    Processing,  // در حال پردازش (تولید Thumbnail یا Transcode)
    Ready,       // پردازش کامل و آماده دانلود
    Expired      // منقضی شده
}

public interface IFileValidator
{
    ValidationResult Validate(IFormFile file);
}

public sealed class FileValidator : IFileValidator
{
    private readonly ILogger<FileValidator> _logger;

    private static readonly Dictionary<string, byte[]> FileSignatures = new(StringComparer.OrdinalIgnoreCase)
    {
        [".jpg"]  = new byte[] { 0xFF, 0xD8, 0xFF },
        [".jpeg"] = new byte[] { 0xFF, 0xD8, 0xFF },
        [".png"]  = new byte[] { 0x89, 0x50, 0x4E, 0x47 },
        [".gif"]  = new byte[] { 0x47, 0x49, 0x46, 0x38 },
        [".pdf"]  = new byte[] { 0x25, 0x50, 0x44, 0x46 },
        [".docx"] = new byte[] { 0x50, 0x4B, 0x03, 0x04 },
        [".xlsx"] = new byte[] { 0x50, 0x4B, 0x03, 0x04 },
        [".mp4"]  = new byte[] { 0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70 }
    };

    private static readonly HashSet<string> AllowedExtensions = new(StringComparer.OrdinalIgnoreCase)
    {
        ".jpg", ".jpeg", ".png", ".gif", ".pdf", ".docx", ".xlsx", ".mp4"
    };

    private const long MaxFileSize = 500 * 1024 * 1024; // 500MB
    private const long MaxImageSize = 10 * 1024 * 1024; // 10MB

    public FileValidator(ILogger<FileValidator> logger) => _logger = logger;

    public ValidationResult Validate(IFormFile file)
    {
        var errors = new List<string>();

        // ۱. بررسی عدم خالی بودن و حجم کلی
        if (file == null || file.Length == 0)
            return ValidationResult.Failure(new[] { "فایل ارسال شده خالی است." });

        if (file.Length > MaxFileSize)
            errors.Add($"حجم فایل بیش از حد مجاز ({MaxFileSize / 1024 / 1024}MB) است.");

        // ۲. اعتبارسنجی پسوند
        var extension = Path.GetExtension(file.FileName);
        if (string.IsNullOrEmpty(extension) || !AllowedExtensions.Contains(extension))
        {
            _logger.LogWarning("تلاش برای آپلود پسوند غیرمجاز: {Extension}", extension);
            return ValidationResult.Failure(new[] { $"پسوند '{extension}' مجاز نیست." });
        }

        // محدودیت سخت‌گیرانه‌تر برای تصاویر
        if (IsImage(extension) && file.Length > MaxImageSize)
            errors.Add($"حجم تصاویر نباید بیش از {MaxImageSize / 1024 / 1024}MB باشد.");

        // ۳. تطابق MIME Type ادعا شده با پسوند
        var expectedMimeType = GetMimeTypeForExtension(extension);
        if (!string.Equals(file.ContentType, expectedMimeType, StringComparison.OrdinalIgnoreCase))
        {
            _logger.LogWarning("عدم تطابق MIME Type: انتظار می‌رفت {Expected} اما {Actual} دریافت شد.", expectedMimeType, file.ContentType);
            errors.Add("نوع Content-Type با پسوند فایل همخوانی ندارد.");
        }

        // ۴. اعتبارسنجی امضای بایتی (Magic Numbers)
        if (!ValidateMagicNumber(file, extension))
        {
            _logger.LogWarning("اعتبارسنجی امضای بایتی ناپایدار بود: {FileName}", file.FileName);
            errors.Add("محتوای واقعی فایل با پسوند آن همخوانی ندارد (احتمال Spoofing).");
        }

        return errors.Any() ? ValidationResult.Failure(errors) : ValidationResult.Success();
    }

    private static bool ValidateMagicNumber(IFormFile file, string extension)
    {
        if (!FileSignatures.TryGetValue(extension, out var signature))
            return false;

        using var stream = file.OpenReadStream();
        var header = new byte[signature.Length];
        var bytesRead = stream.Read(header, 0, signature.Length);

        return bytesRead == signature.Length && header.SequenceEqual(signature);
    }

    private static bool IsImage(string ext) => ext.Equals(".jpg", StringComparison.OrdinalIgnoreCase) ||
                                                ext.Equals(".jpeg", StringComparison.OrdinalIgnoreCase) ||
                                                ext.Equals(".png", StringComparison.OrdinalIgnoreCase) ||
                                                ext.Equals(".gif", StringComparison.OrdinalIgnoreCase);

    private static string GetMimeTypeForExtension(string ext) => ext.ToLowerInvariant() switch
    {
        ".jpg" or ".jpeg" => "image/jpeg",
        ".png" => "image/png",
        ".gif" => "image/gif",
        ".pdf" => "application/pdf",
        ".docx" => "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
        ".xlsx" => "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        ".mp4" => "video/mp4",
        _ => "application/octet-stream"
    };
}

public record ValidationResult(bool IsValid, IReadOnlyList<string> Errors)
{
    public static ValidationResult Success() => new(true, Array.Empty<string>());
    public static ValidationResult Failure(IEnumerable<string> errors) => new(false, errors.ToList());
}

• هرگز به کلاینت اعتماد نکنید (Never Trust the Client): پسوندها، Content-Type و متاداده‌های کلاینت همگی قابل دستکاری هستند. تنها منبع حقیقت، بایت‌های اولیه فایل (Magic Bytes) و بازرسی سمت سرور است.
• حافظه RAM بی‌نهایت نیست (Memory is Finite): خواندن مستقیم فایل‌های چند صد مگابایتی یا چند گیگابایتی در MemoryStream باعث Overload شدن GC و Crash کردن برنامه می‌شود. حتماً از Stream و Bufferهای محدود روی دیسک استفاده کنید.
• تفکیک مسئولیت نگهداری و ارائه (Storage and Serving Separation): وب‌سرور شما (ASP.NET Core) وظیفه پردازش منطق و اعتبارسنجی را دارد، نه ذخیره‌سازی فایل روی دیسک خودش. فایل‌ها باید پس از اعتبارسنجی مستقیماً به سرویس‌های Obect Storage (مانند MinIO، S3 یا Azure Blob) منتقل شوند.