EntityCrypt.Core 2.0.2

🔐 EntityCrypt

Transparent Encryption for Entity Framework Core

✨ الميزات

• 🔒 تشفير شفاف - لا حاجة لتغيير كود التطبيق
• 🛡️ AES-256-CBC - تشفير كلاسيكي سريع
• 🚀 ML-KEM-768 - حماية ضد الحواسيب الكمّية (FIPS 203)
• 🔗 الحفاظ على العلاقات - PK/FK تبقى سليمة
• ⚡ أداء عالي - ~1.3µs للتشفير الكلاسيكي
• 📊 Benchmarks حقيقية - قياسات موثقة

📦 المشاريع

🚀 البدء السريع

1. تعريف الكيانات

using EntityCrypt.EFCore.Attributes;

[EncryptedTable]
public class Customer
{
    public int Id { get; set; }
    
    [Encrypted]
    public string Name { get; set; }
    
    [Encrypted(Level = EncryptionLevel.Hybrid)]
    public string SSN { get; set; }
    
    [NoEncrypt]
    public DateTime CreatedAt { get; set; }
}

2. إعداد DbContext

services.AddDbContext<AppDbContext>(options =>
    options.UseSqlite("Data Source=app.db")
           .UseEntityCryptClassical("my-secret-key"));

3. الاستخدام العادي

// التشفير/فك التشفير شفاف تماماً!
db.Customers.Add(new Customer { Name = "أحمد", SSN = "123-45-6789" });
await db.SaveChangesAsync();

var customer = await db.Customers.FindAsync(1);
Console.WriteLine(customer.Name);  // "أحمد" (مفكوك تلقائياً)

📊 مستويات التشفير

📈 Benchmarks (حقيقية)

BenchmarkDotNet v0.14.0, .NET 10.0

| Method                    | Mean      | Allocated |
|-------------------------- |----------:|----------:|
| Classical Encrypt         |  1.27 µs  |   1.9 KB  |
| Classical Decrypt         |  3.30 µs  |   7.0 KB  |
| PQC KeyGen (ML-KEM-768)   | 48.54 µs  |   6.4 KB  |
| PQC Encapsulate           | 24.86 µs  |   1.5 KB  |
| PQC Decapsulate           | 36.53 µs  |   376 B   |
| Hybrid Encrypt            | 29.50 µs  |  18.2 KB  |
| Hybrid Decrypt            | 75.87 µs  |  38.6 KB  |

🔗 التكامل مع مشاريع أخرى

WasmMvcRuntime.Data

// 1. إضافة المرجع
<ProjectReference Include="EntityCrypt.EFCore.csproj" />

// 2. تعريف الكيانات
[EncryptedTable]
public class MainTask { ... }

// 3. تسجيل الخدمات
services.AddEncryptedWasmDatabase(new EncryptedDatabaseConfig
{
    DatabasePath = "app.db",
    EncryptionKey = "my-key",
    DefaultLevel = EncryptionLevel.Classical
});

// 4. الاستخدام العادي - بدون أي تغيير!

📚 دليل التكامل الكامل

📁 هيكل المشروع

EntityCrypt/
├── src/
│   ├── EntityCrypt.Core/           # مكتبة التشفير
│   │   ├── Encryption/
│   │   │   ├── AES256EncryptionProvider.cs
│   │   │   ├── HierarchicalEncryptionManager.cs
│   │   │   └── PostQuantum/
│   │   │       └── HybridEncryptionProvider.cs
│   │   └── Models/
│   │
│   └── EntityCrypt.EFCore/         # تكامل EF Core
│       ├── Attributes/
│       │   └── EncryptionAttributes.cs
│       ├── Configuration/
│       │   └── EncryptionOptions.cs
│       ├── Context/
│       │   └── EntityEncryptionService.cs
│       ├── Extensions/
│       │   └── EntityCryptExtensions.cs
│       └── Interceptors/
│           └── EncryptionInterceptors.cs
│
├── samples/
│   ├── VisualStorage/              # أمثلة تفاعلية
│   └── EntityCrypt.Benchmarks/     # قياسات الأداء
│
└── docs/
    ├── INTEGRATION_GUIDE.md        # دليل التكامل
    ├── PERFORMANCE_BENCHMARKS.md   # نتائج الأداء
    └── examples/
        └── WasmMvcRuntime.Integration.cs

🛠️ المتطلبات

• .NET 10.0+
• EF Core 10.0+
• Windows 11 Insiders أو Linux مع OpenSSL 3.5+ (للـ PQC)

📚 التوثيق

• دليل التكامل
• نتائج Benchmarks
• مثال WasmMvcRuntime
• README الـ EFCore

🤝 المساهمة

المساهمات مرحب بها! يرجى:

1. Fork المشروع
2. إنشاء branch للميزة
3. Commit التغييرات
4. فتح Pull Request

📄 الترخيص

MIT License - انظر LICENSE

<div align="center">

🔐 EntityCrypt

Transparent • Secure • Fast

.NET 10 | ML-KEM (FIPS 203) | AES-256

</div>