إضافة توقيع رقمي جديد إلى ملف Excel الموقّع
مقدمة
في عالمنا الرقمي اليوم، أصبح ضمان صحة وسلامة المستندات أكثر أهمية من أي وقت مضى. توفر التوقيعات الرقمية طريقة موثوقة للتحقق من عدم تغيير المستند ومن أنه نشأ من مصدر شرعي. إذا كنت تعمل مع ملفات Excel في .NET وتحتاج إلى إضافة توقيع رقمي جديد إلى ملف موقّع بالفعل، فهذا الدليل مناسب لك! سنشرح عملية إضافة توقيع رقمي إلى ملف Excel موقّع موجود باستخدام Aspose.Cells لـ .NET.
المتطلبات الأساسية
قبل أن نتعمق في التنفيذ، تأكد من أن لديك ما يلي:
- Aspose.Cells لـ .NET: قم بتنزيل Aspose.Cells وتثبيته منصفحة الإصدار.
- .NET Framework: تأكد من أن جهازك يحتوي على .NET Framework وأنك على دراية بمفاهيم برمجة .NET الأساسية.
- الشهادة الرقمية: احصل على شهادة رقمية صالحة بتنسيق .pfx. للاختبار، يمكنك إنشاء شهادة موقعة ذاتيًا.
- بيئة التطوير: استخدم IDE مثل Visual Studio لكتابة وتنفيذ كود C# الخاص بك.
- ملف Excel نموذجي: يحتوي على ملف Excel موجود تم توقيعه رقميًا بالفعل، والذي سيكون الهدف لإضافة توقيع جديد.
بعد وضع هذه المتطلبات الأساسية في مكانها، دعنا ننتقل إلى الكود!
استيراد الحزم الضرورية
في الجزء العلوي من ملف C# الخاص بك، قم بتضمين مساحات الأسماء التالية للوصول إلى الفئات والطرق المطلوبة:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
الخطوة 1: قم بتحديد الدلائل الخاصة بك
حدد الدلائل لملفات المصدر ومكان حفظ ملف الإخراج:
// دليل المصدر
string sourceDir = "Your Document Directory"; // استبدل بالدليل الفعلي الخاص بك
// دليل الإخراج
string outputDir = "Your Document Directory"; // استبدل بالدليل الفعلي الخاص بك
الخطوة 2: تحميل المصنف الموقّع الموجود
قم بتحميل مصنف Excel الذي تم توقيعه بالفعل:
// قم بتحميل المصنف الذي تم توقيعه رقميًا بالفعل
Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(sourceDir + "sampleDigitallySignedByCells.xlsx");
الخطوة 3: إنشاء مجموعة توقيعات رقمية
إنشاء مجموعة لإدارة توقيعاتك الرقمية:
//إنشاء مجموعة التوقيعات الرقمية
Aspose.Cells.DigitalSignatures.DigitalSignatureCollection dsCollection = new Aspose.Cells.DigitalSignatures.DigitalSignatureCollection();
الخطوة 4: تحميل الشهادة الخاصة بك
قم بتحميل الشهادة الرقمية الخاصة بك، والتي سيتم استخدامها لإنشاء التوقيع الجديد:
// ملف الشهادة وكلمة المرور الخاصة به
string certFileName = sourceDir + "AsposeDemo.pfx"; // ملف الشهادة الخاص بك
string password = "aspose"; // كلمة مرور الشهادة الخاصة بك
// إنشاء شهادة جديدة
System.Security.Cryptography.X509Certificates.X509Certificate2 certificate = new System.Security.Cryptography.X509Certificates.X509Certificate2(certFileName, password);
الخطوة 5: إنشاء توقيع رقمي جديد
الآن قم بإنشاء توقيع رقمي جديد وأضفه إلى مجموعتك:
// إنشاء توقيع رقمي جديد وإضافته إلى المجموعة
Aspose.Cells.DigitalSignatures.DigitalSignature signature = new Aspose.Cells.DigitalSignatures.DigitalSignature(certificate, "Aspose.Cells added new digital signature in existing digitally signed workbook.", DateTime.Now);
dsCollection.Add(signature);
الخطوة 6: إضافة مجموعة التوقيعات إلى المصنف
إضافة مجموعة التوقيعات الرقمية إلى المصنف:
// إضافة مجموعة التوقيعات الرقمية إلى المصنف
workbook.AddDigitalSignature(dsCollection);
الخطوة 7: احفظ المصنف
احفظ المصنف بالتوقيع الرقمي الجديد المضمن:
// حفظ المصنف
workbook.Save(outputDir + "outputDigitallySignedByCells.xlsx");
workbook.Dispose();
الخطوة 8: تأكيد النجاح
تقديم ردود الفعل عند التنفيذ الناجح:
Console.WriteLine("Successfully added a digital signature to the existing signed Excel file.");
خاتمة
تهانينا! لقد نجحت في إضافة توقيع رقمي جديد إلى ملف Excel موقّع بالفعل باستخدام Aspose.Cells for .NET. تعمل هذه العملية على تعزيز أمان مستنداتك وضمان صحتها وسلامتها.
الأسئلة الشائعة
ما هو التوقيع الرقمي؟
التوقيع الرقمي هو مخطط رياضي يتحقق من صحة وسلامة الرسائل أو المستندات الرقمية، ويضمن عدم تغييرها ويؤكد هوية الموقع.
هل أحتاج إلى شهادة خاصة لإنشاء توقيع رقمي؟
نعم، يلزم الحصول على شهادة رقمية صادرة عن هيئة تصديق موثوقة (CA) لإنشاء توقيع رقمي صالح.
هل يمكنني استخدام شهادة موقعة ذاتيًا للاختبار؟
بالتأكيد! يمكنك استخدام شهادة موقعة ذاتيًا لأغراض التطوير والاختبار، ولكن بالنسبة للإنتاج، يُنصح باستخدام شهادة من جهة اعتماد موثوقة.
ماذا يحدث إذا حاولت إضافة توقيع إلى مستند غير موقع؟
إذا حاولت إضافة توقيع رقمي إلى مستند غير موقّع بالفعل، فستعمل العملية دون مشاكل، ولكن التوقيع الأصلي لن يكون موجودًا.
أين يمكنني العثور على مزيد من المعلومات حول Aspose.Cells؟
للحصول على أدلة تفصيلية ومراجع API، راجعتوثيق Aspose.Cells.